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
commit3f7f6198a358ad9ce74bbd9278421c96de489662 (patch)
tree4c55c1e445afaf0fcd861f9b2ced840e5c7e425a /lispref
parent28debc56335b294137557cc97c2f27a56af9aacd (diff)
downloademacs-3f7f6198a358ad9ce74bbd9278421c96de489662.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.