[Emacs-diffs] Changes to emacs/lispref/tips.texi

[Richard M . Stallman]

Index: emacs/lispref/tips.texi
diff -c emacs/lispref/tips.texi:1.63 emacs/lispref/tips.texi:1.64
*** emacs/lispref/tips.texi:1.63        Mon Mar 28 21:11:28 2005
--- emacs/lispref/tips.texi     Sat May 14 14:02:39 2005
***************
*** 37,42 ****
--- 37,52 ----
  
  @itemize @bullet
  @item
+ Simply loading the package should not change Emacs's editing behavior.
+ Include a command or commands to enable and disable the feature,
+ or to invoke it.
+ 
+ This convention is mandatory for any file that includes custom
+ definitions.  If fixing such a file to follow this convention requires
+ an incompatible change, go ahead and make the incompatible change;
+ don't postpone it.
+ 
+ @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
***************
*** 201,217 ****
  In addition, they should mark the text as a kind of ``link'' so that
  @kbd{mouse-1} will follow it also.  @xref{Links and Mouse-1}.
  
- @item
- 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 @address@hidden 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 address@hidden that the package may be loaded
- arbitrarily by Custom for instance.}  Users will request the feature by
- invoking the command.  It is a good idea to define this command
- as a minor mode.
- 
  @cindex unloading packages
  If loading the file adds functions to hooks, define a function
  @address@hidden, where @var{feature} is the name of
--- 211,216 ----