diff --git a/src/libs/utils/filepath.h b/src/libs/utils/filepath.h
index 02de3b9cca2..9e8c1dcb5c0 100644
--- a/src/libs/utils/filepath.h
+++ b/src/libs/utils/filepath.h
@@ -315,7 +315,9 @@ public:
 
     // FIXME: Avoid. See toSettings, toVariant, toUserOutput, toFSPathString, path, nativePath.
     QString toUrlishString() const;
-    [[deprecated]] QString toString() const { return toUrlishString(); }
+
+    [[deprecated("Check the documentation for toUrlishString() and choose a better replacement.")]]
+    QString toString() const { return toUrlishString(); }
 
     bool equalsCaseSensitive(const FilePath &other) const;