]> git.eshelyaron.com Git - emacs.git/commitdiff
Add a tip about enabling/disabling features.
authorRichard M. Stallman <rms@gnu.org>
Fri, 7 Oct 1994 23:42:52 +0000 (23:42 +0000)
committerRichard M. Stallman <rms@gnu.org>
Fri, 7 Oct 1994 23:42:52 +0000 (23:42 +0000)
lispref/tips.texi

index 482a21afd2331e09cb105cf6a7dd130fc94f921e..1e50f672d1de3cfbd379b5d485fa464229b2b070 100644 (file)
@@ -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.