aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRichard M. Stallman2006-04-18 21:10:14 +0000
committerRichard M. Stallman2006-04-18 21:10:14 +0000
commit8a1aafd01a88cda0df0873d3772487e2b0123769 (patch)
treea4273eadd73589bc0ec880193bc97bef46ff75e8
parent50363cd8abab4ae76c1b15f8c98e23b566f7e277 (diff)
downloademacs-8a1aafd01a88cda0df0873d3772487e2b0123769.tar.gz
emacs-8a1aafd01a88cda0df0873d3772487e2b0123769.zip
(Coding Conventions): Explain when the package's
prefix should appear later on (not at the start of the name).
-rw-r--r--lispref/tips.texi10
1 files changed, 7 insertions, 3 deletions
diff --git a/lispref/tips.texi b/lispref/tips.texi
index 8b033139275..889ac3e6a6d 100644
--- a/lispref/tips.texi
+++ b/lispref/tips.texi
@@ -56,9 +56,13 @@ distinguish your program from other Lisp programs.@footnote{The
56benefits of a Common Lisp-style package system are considered not to 56benefits of a Common Lisp-style package system are considered not to
57outweigh the costs.} Then take care to begin the names of all global 57outweigh the costs.} Then take care to begin the names of all global
58variables, constants, and functions in your program with the chosen 58variables, constants, and functions in your program with the chosen
59prefix. This helps avoid name conflicts. (Occasionally, for a command 59prefix. This helps avoid name conflicts.
60name intended for users to use, it is cleaner if some words come 60
61before the package name prefix.) 61Occasionally, for a command name intended for users to use, it is more
62convenient if some words come before the package's name prefix. And
63constructs that define functions, variables, etc., work better if they
64start with @samp{defun} or @samp{defvar}, so put the name prefix later
65on in the name.
62 66
63This recommendation applies even to names for traditional Lisp 67This recommendation applies even to names for traditional Lisp
64primitives that are not primitives in Emacs Lisp---such as 68primitives that are not primitives in Emacs Lisp---such as