From 9e7cefcc957e1f1201cf90bdef3e8a9fd2bb492b Mon Sep 17 00:00:00 2001
From: Daniel Shahaf <d.s@daniel.shahaf.name>
Date: Fri, 3 Jun 2016 09:59:11 +0000
Subject: unposted: internal: Document modify().

---
 Src/subst.c | 13 +++++++++++++
 1 file changed, 13 insertions(+)

(limited to 'Src/subst.c')

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)
-- 
cgit 1.4.1