[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: |
Fri, 16 Jun 2006 15:23:00 +0000 |
CVSROOT: /cvsroot/emacs
Module name: emacs
Changes by: Richard M. Stallman <rms> 06/06/16 15:22:59
Index: tips.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/lispref/tips.texi,v
retrieving revision 1.82
retrieving revision 1.83
diff -u -b -r1.82 -r1.83
--- tips.texi 10 Jun 2006 16:20:02 -0000 1.82
+++ tips.texi 16 Jun 2006 15:22:59 -0000 1.83
@@ -204,11 +204,14 @@
replacements differs from that of the originals.
@item
-Avoid using macros that define functions and variables with names that
-are constructed. It is best for maintenance when the name of the
-function or variable being defined is given explicitly in the source
-code, as the second element of the list---as it is when you use
address@hidden, @code{defalias}, @code{defvar} and @code{defcustom}.
+Constructs that define a function or variable should be macros,
+not functions, and their names should start with @samp{def}.
+
address@hidden
+Macros that define a functions or variables should take the name to be
+defined as the first argument. That will help various tools find the
+definition automatically. Avoid constructing the names in the macro
+itself, since that would confuse these tools.
@item
Please keep the names of your Emacs Lisp source files to 13 characters