summaryrefslogtreecommitdiff
path: root/lispref
diff options
context:
space:
mode:
authorRichard M. Stallman <rms@gnu.org>1996-12-12 05:36:22 +0000
committerRichard M. Stallman <rms@gnu.org>1996-12-12 05:36:22 +0000
commit0d6c87ab4b58d90e1b783e3f69b70044eb79d741 (patch)
tree0f4c988dcd851fac851ee9a4ab457962d915fc25 /lispref
parent10262de12491000c122cdfb49f9a2e174ca002ad (diff)
downloademacs-0d6c87ab4b58d90e1b783e3f69b70044eb79d741.tar.gz
Explain how disabled commands' doc strings are displayed.
Diffstat (limited to 'lispref')
-rw-r--r--lispref/tips.texi6
1 files changed, 6 insertions, 0 deletions
diff --git a/lispref/tips.texi b/lispref/tips.texi
index bbc8ad7b708..7a10f212153 100644
--- a/lispref/tips.texi
+++ b/lispref/tips.texi
@@ -403,6 +403,12 @@ view the documentation. Remember that the indentation before the
starting double-quote is not part of the string!
@item
+When the user tries to use a disabled command, Emacs displays just the
+first paragraph of its documentation string---everything through the
+first blank line. If you wish, you can choose which information to
+include before the first blank line so as to make this display useful.
+
+@item
A variable's documentation string should start with @samp{*} if the
variable is one that users would often want to set interactively. If
the value is a long list, or a function, or if the variable would be set