changeset 51998:3d0217ad97db

(Function Documentation): Explain how to show calling convention explicitly in the doc string.

--- a/lispref/functions.texi	Tue Jul 22 15:22:12 2003 +0000
+++ b/lispref/functions.texi	Tue Jul 22 15:22:50 2003 +0000
@@ -411,7 +411,7 @@
 but since these spaces come before the starting double-quote, they are not part of
 the string.  Some people make a practice of indenting any additional
 lines of the string so that the text lines up in the program source.
-@emph{This is a mistake.}  The indentation of the following lines is
+@emph{That is a mistake.}  The indentation of the following lines is
 inside the string; what looks nice in the source code will look ugly
 when displayed by the help commands.
 
@@ -423,6 +423,19 @@
 documentation string; if the only body form is a string then it serves both
 as the return value and as the documentation.
 
+  The last line of the documentation string can specify calling
+conventions different from the actual function arguments.  Write
+text like this:
+
+@example
+(fn @var{arglist})
+@end example
+
+@noindent
+following a blank line, with no newline following it inside the
+documentation string.  This feature is particularly useful for
+macro definitions.
+
 @node Function Names
 @section Naming a Function
 @cindex function definition