changeset 9393:0bec3b6bac2f

Add a tip about enabling/disabling features.
author Richard M. Stallman <rms@gnu.org>
date Fri, 07 Oct 1994 23:42:52 +0000
parents 32186e807f02
children 802381617d14
files lispref/tips.texi
diffstat 1 files changed, 10 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/tips.texi	Fri Oct 07 21:44:51 1994 +0000
+++ b/lispref/tips.texi	Fri Oct 07 23:42:52 1994 +0000
@@ -113,8 +113,16 @@
 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.