summary refs log tree commit diff
diff options
context:
space:
mode:
-rw-r--r--ChangeLog4
-rw-r--r--Src/subst.c13
2 files changed, 17 insertions, 0 deletions
diff --git a/ChangeLog b/ChangeLog
index 385ea2d86..f629609cc 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2016-06-03  Daniel Shahaf  <d.s@daniel.shahaf.name>
+
+	* unposted: Src/subst.c: internal: Document modify().
+
 2016-06-03  Peter Stephenson  <p.stephenson@samsung.com>
 
 	* 38586: Src/Modules/parameter.c, Test/D07multibyte.ztst:
diff --git a/Src/subst.c b/Src/subst.c
index f2d0f6553..4e13ce11d 100644
--- a/Src/subst.c
+++ b/Src/subst.c
@@ -4015,6 +4015,19 @@ arithsubst(char *a, char **bptr, char *rest)
     return t;
 }
 
+/* This function implements colon modifiers.
+ *
+ * STR is an in/out parameter.  On entry it is the string (e.g., path)
+ * to modified.  On return it is the modified path.
+ *
+ * PTR is an in/out parameter.  On entry it contains the string of colon
+ * modifiers.  On return it points past the last recognised modifier.
+ *
+ * Example:
+ *     ENTRY:   *str is "."   *ptr is ":AN"
+ *     RETURN:  *str is "/home/foobar" (equal to $PWD)   *ptr points to the "N"
+ */
+
 /**/
 void
 modify(char **str, char **ptr)