Index: openacs-4/packages/acs-api-browser/tcl/acs-api-documentation-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-api-browser/tcl/acs-api-documentation-procs.tcl,v
diff -u -r1.72.2.11 -r1.72.2.12
--- openacs-4/packages/acs-api-browser/tcl/acs-api-documentation-procs.tcl	10 Sep 2019 12:57:29 -0000	1.72.2.11
+++ openacs-4/packages/acs-api-browser/tcl/acs-api-documentation-procs.tcl	10 Sep 2019 13:24:06 -0000	1.72.2.12
@@ -1277,7 +1277,12 @@
         Extracts information about the author and formats it into an
         HTML string.
 
-        @param author_string author information to format
+        @param author_string author information to format. 3 kind of
+               formats are expected: email (a mailto link to the email
+               is generated), whitespace-separated couple "<name> (<email>)" (a
+               mailto link for email and the name are generated) and
+               free-form (the same input string is returned).
+
         @return the formatted result
     } {
         if { [regexp {^[^ \n\r\t]+$} $author_string]