# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 1058887370 0
# Node ID 3d0217ad97dbf1851b66ff61c8628460f1fb0b97
# Parent  7f2fcfb45bf7aad7d7f11e20f982e3ffc40a2cf6
(Function Documentation): Explain how to
show calling convention explicitly in the doc string.

diff -r 7f2fcfb45bf7 -r 3d0217ad97db lispref/functions.texi
--- 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