tests: clarify test_path_startswith return value (#4508)

A pendant for #4481.

1 files changed, 10 insertions, 0 deletions

diff --git a/src/basic/path-util.c b/src/basic/path-util.c
index cdbb2d398..3af95bf24 100644
--- a/src/basic/path-util.c
+++ b/src/basic/path-util.c
@@ -356,6 +356,16 @@ char* path_startswith(const char *path, const char *prefix) {
         assert(path);
         assert(prefix);
 
+        /* Returns a pointer to the start of the first component after the parts matched by
+         * the prefix, iff
+         * - both paths are absolute or both paths are relative,
+         * and
+         * - each component in prefix in turn matches a component in path at the same position.
+         * An empty string will be returned when the prefix and path are equivalent.
+         *
+         * Returns NULL otherwise.
+         */
+
         if ((path[0] == '/') != (prefix[0] == '/'))
                 return NULL;