[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lispref/tips.texi,v
From: |
Richard M. Stallman |
Subject: |
[Emacs-diffs] Changes to emacs/lispref/tips.texi,v |
Date: |
Tue, 18 Jul 2006 00:07:59 +0000 |
CVSROOT: /cvsroot/emacs
Module name: emacs
Changes by: Richard M. Stallman <rms> 06/07/18 00:07:59
Index: tips.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/lispref/tips.texi,v
retrieving revision 1.88
retrieving revision 1.89
diff -u -b -r1.88 -r1.89
--- tips.texi 12 Jul 2006 16:07:17 -0000 1.88
+++ tips.texi 18 Jul 2006 00:07:59 -0000 1.89
@@ -702,15 +702,15 @@
@item
The documentation string for a variable that is a yes-or-no flag should
-start with words such as ``Non-nil address@hidden'', to make it clear that
+start with words such as ``Non-nil means,'' to make it clear that
all address@hidden values are equivalent and indicate explicitly what
@code{nil} and address@hidden mean.
@item
The documentation string for a function that is a yes-or-no predicate
-should start with words such as ``Return t if @dots{}'', to indicate
-explicitly what constitutes ``truth''. The word ``return'' avoids
-starting the sentence with lower-case ``t'', which is somewhat
+should start with words such as ``Return t if,'' to indicate
+explicitly what constitutes ``truth.'' The word ``return'' avoids
+starting the sentence with lower-case ``t,'' which could be somewhat
distracting.
@item
@@ -736,7 +736,7 @@
@item
Never change the case of a Lisp symbol when you mention it in a doc
-string. If the symbol's name is @code{foo}, write ``foo'', not
+string. If the symbol's name is @code{foo}, write ``foo,'' not
``Foo'' (which is a different symbol).
This might appear to contradict the policy of writing function
- [Emacs-diffs] Changes to emacs/lispref/tips.texi,v, Karl Berry, 2006/07/05
- [Emacs-diffs] Changes to emacs/lispref/tips.texi,v, Richard M. Stallman, 2006/07/05
- [Emacs-diffs] Changes to emacs/lispref/tips.texi,v, Nick Roberts, 2006/07/10
- [Emacs-diffs] Changes to emacs/lispref/tips.texi,v, Nick Roberts, 2006/07/10
- [Emacs-diffs] Changes to emacs/lispref/tips.texi,v, Richard M. Stallman, 2006/07/12
- [Emacs-diffs] Changes to emacs/lispref/tips.texi,v,
Richard M. Stallman <=