# HG changeset patch # User Richard M. Stallman # Date 788195517 0 # Node ID 2e5dcd5f309088181f2c30c6791c773c33f80ac1 # Parent 8a933302229cbd96d13b5be55c2323216f3be808 Recommend doc strings for all functions and variables. diff -r 8a933302229c -r 2e5dcd5f3090 lispref/tips.texi --- a/lispref/tips.texi Fri Dec 23 15:06:14 1994 +0000 +++ b/lispref/tips.texi Fri Dec 23 15:11:57 1994 +0000 @@ -304,8 +304,10 @@ should have a documentation string. @item -An internal subroutine of a Lisp program need not have a documentation -string, and you can save space by using a comment instead. +An internal variable or subroutine of a Lisp program might as well have +a documentation string. In earlier Emacs versions, you could save space +by using a comment instead of a documentation string, but that is no +longer the case. @item The first line of the documentation string should consist of one or two