diff --git a/src/utility/path.hpp b/src/utility/path.hpp
index 5f377f7a..8fc376d5 100644
--- a/src/utility/path.hpp
+++ b/src/utility/path.hpp
@@ -140,6 +140,8 @@ public:
 	const bool isParentOf(const path& p) const;
 
 	/** Rename a parent component in the path.
+	  * Example: path("a/b/c/d").renameParent("a/b", "x/y/z")
+	  * will return path("x/y/z/c/d").
 	  *
 	  * @param oldPath old parent path
 	  * @param newPath new parent path