[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lispref/tips.texi
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] Changes to emacs/lispref/tips.texi |
Date: |
Fri, 26 May 2006 19:32:02 +0000 |
Index: emacs/lispref/tips.texi
diff -u emacs/lispref/tips.texi:1.78 emacs/lispref/tips.texi:1.79
--- emacs/lispref/tips.texi:1.78 Tue Apr 18 21:10:14 2006
+++ emacs/lispref/tips.texi Fri May 26 19:32:02 2006
@@ -35,6 +35,7 @@
@node Coding Conventions
@section Emacs Lisp Coding Conventions
address@hidden coding conventions in Emacs Lisp
Here are conventions that you should follow when writing Emacs Lisp
code intended for widespread use:
@@ -52,9 +53,9 @@
@item
Since all global variables share the same name space, and all
functions share another name space, you should choose a short word to
-distinguish your program from other Lisp address@hidden
+distinguish your program from other Lisp address@hidden
benefits of a Common Lisp-style package system are considered not to
-outweigh the costs.} Then take care to begin the names of all global
+outweigh the costs.}. Then take care to begin the names of all global
variables, constants, and functions in your program with the chosen
prefix. This helps avoid name conflicts.
@@ -175,7 +176,17 @@
@item
Redefining (or advising) an Emacs primitive is discouraged. It may do
the right thing for a particular program, but there is no telling what
-other programs might break as a result.
+other programs might break as a result. In any case, it is a
+maintenance burden because the two packages become highly dependent on
+each other.
+
address@hidden
+Likewise, avoid using @code{eval-after-load} (@pxref{Hooks for
+Loading}) in libraries and packages. This feature is meant for
+personal customizations; using it in a Lisp package increases the
+coupling between it and the package mentioned in
address@hidden, and thus makes it harder to maintain the two
+packages independently.
@item
If a file does replace any of the functions or library programs of
- [Emacs-diffs] Changes to emacs/lispref/tips.texi,
Eli Zaretskii <=