summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--src/basic/path-util.c12
1 files changed, 11 insertions, 1 deletions
diff --git a/src/basic/path-util.c b/src/basic/path-util.c
index 29a899b421..d8167da4f8 100644
--- a/src/basic/path-util.c
+++ b/src/basic/path-util.c
@@ -202,7 +202,17 @@ int path_make_relative_parent(const char *from_child, const char *to, char **ret
assert(ret);
/* Similar to path_make_relative(), but provides the relative path from the parent directory of
- * 'from_child'. This may be useful when creating relative symlink. */
+ * 'from_child'. This may be useful when creating relative symlink.
+ *
+ * E.g.
+ * - from = "/path/to/aaa", to = "/path/to/bbb"
+ * path_make_relative(from, to) = "../bbb"
+ * path_make_relative_parent(from, to) = "bbb"
+ *
+ * - from = "/path/to/aaa/bbb", to = "/path/to/ccc/ddd"
+ * path_make_relative(from, to) = "../../ccc/ddd"
+ * path_make_relative_parent(from, to) = "../ccc/ddd"
+ */
r = path_extract_directory(from_child, &from);
if (r < 0)