Merge branch 'mh/split-under-lock'

diff --git a/cache.h b/cache.h
index 2bf97cc55f1170d25549b76144993acea1a807b5..d559cf1234f61321a369eae6f79aa589e56de3c9 100644 (file)
--- a/cache.h
+++ b/cache.h
@@ -1003,6 +1003,11 @@ int adjust_shared_perm(const char *path);
  * directory while we were working.  To be robust against this kind of
  * race, callers might want to try invoking the function again when it
  * returns SCLD_VANISHED.
+ *
+ * safe_create_leading_directories() temporarily changes path while it
+ * is working but restores it before returning.
+ * safe_create_leading_directories_const() doesn't modify path, even
+ * temporarily.
  */
 enum scld_error {
        SCLD_OK = 0,