summaryrefslogtreecommitdiff
path: root/lispref
diff options
context:
space:
mode:
authorRichard M. Stallman <rms@gnu.org>1994-10-07 23:42:52 +0000
committerRichard M. Stallman <rms@gnu.org>1994-10-07 23:42:52 +0000
commit8414f615f477721c29ab8bb32555a5c3a9ca61cb (patch)
tree1711778e1228ad3398b3af30fd7268d9354edd90 /lispref
parent1c4ca5a330e16e4a1cc43dcd5d1d8061923fdb32 (diff)
downloademacs-8414f615f477721c29ab8bb32555a5c3a9ca61cb.tar.gz
Add a tip about enabling/disabling features.
Diffstat (limited to 'lispref')
-rw-r--r--lispref/tips.texi12
1 files changed, 10 insertions, 2 deletions
diff --git a/lispref/tips.texi b/lispref/tips.texi
index 482a21afd23..1e50f672d1d 100644
--- a/lispref/tips.texi
+++ b/lispref/tips.texi
@@ -113,8 +113,16 @@ alter the text in that buffer by hand. Modes such as Dired, Info,
Compilation, and Occur redefine it in this way.
@item
-It is a bad idea to define aliases for the Emacs primitives.
-Use the standard names instead.
+When a package provides a modification of ordinary Emacs behavior, it is
+good to include a command to enable and disable the feature, Provide a
+command named @code{@var{whatever}-mode} which turns the feature on or
+off, and make it autoload (@pxref{Autoload}). Design the package so
+that simply loading it has no visible effect---that should not enable
+the feature. Users will request the feature by invoking the command.
+
+@item
+It is a bad idea to define aliases for the Emacs primitives. Use the
+standard names instead.
@item
Redefining an Emacs primitive is an even worse idea.