[Emacs-diffs] /srv/bzr/emacs/trunk r106141: Adapt to new minor mode function behavior in manual examples.

[Chong Yidong]

------------------------------------------------------------
revno: 106141
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Wed 2011-10-19 20:41:15 -0400
message:
  Adapt to new minor mode function behavior in manual examples.
  
  * doc/emacs/custom.texi (Hooks, Init Examples):
  * doc/emacs/display.texi (Font Lock):
  * doc/emacs/fixit.texi (Spelling):
  * doc/emacs/rmail.texi (Rmail Display): Minor mode function with no arg now
  enables it.
  
  * doc/emacs/fixit.texi (Spelling): Fix description of inline completion.
modified:
  doc/emacs/ChangeLog
  doc/emacs/custom.texi
  doc/emacs/display.texi
  doc/emacs/fixit.texi
  doc/emacs/fortran-xtra.texi
  doc/emacs/rmail.texi

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2011-10-19 04:21:52 +0000
+++ b/doc/emacs/ChangeLog       2011-10-20 00:41:15 +0000
@@ -1,3 +1,13 @@
+2011-10-20  Chong Yidong  <address@hidden>
+
+       * custom.texi (Hooks, Init Examples):
+       * display.texi (Font Lock):
+       * fixit.texi (Spelling):
+       * rmail.texi (Rmail Display): Minor mode function with no arg now
+       enables it.
+
+       * fixit.texi (Spelling): Fix description of inline completion.
+
 2011-10-19  Chong Yidong  <address@hidden>
 
        * search.texi (Repeat Isearch, Error in Isearch): Add kindex

=== modified file 'doc/emacs/custom.texi'
--- a/doc/emacs/custom.texi     2011-10-01 21:54:33 +0000
+++ b/doc/emacs/custom.texi     2011-10-20 00:41:15 +0000
@@ -770,7 +770,7 @@
 Text mode and other modes based on Text mode:
 
 @example
-(add-hook 'text-mode-hook 'turn-on-auto-fill)
+(add-hook 'text-mode-hook 'auto-fill-mode)
 @end example
 
   Here is another example, showing how to use a hook to customize the
@@ -2174,8 +2174,7 @@
 Turn on Auto Fill mode automatically in Text mode and related modes.
 
 @example
-(add-hook 'text-mode-hook
-  '(lambda () (auto-fill-mode 1)))
+(add-hook 'text-mode-hook 'auto-fill-mode)
 @end example
 
 This shows how to add a hook function to a normal hook variable
@@ -2183,19 +2182,9 @@
 @code{lambda}, with a single-quote in front of it to make it a list
 constant rather than an expression.
 
-It's beyond the scope of this manual to explain Lisp functions, but for
-this example it is enough to know that the effect is to execute
address@hidden(auto-fill-mode 1)} when Text mode is entered.  You can replace
-that with any other expression that you like, or with several
-expressions in a row.
-
-Emacs comes with a function named @code{turn-on-auto-fill} whose
-definition is @code{(lambda () (auto-fill-mode 1))}.  Thus, a simpler
-way to write the above example is as follows:
-
address@hidden
-(add-hook 'text-mode-hook 'turn-on-auto-fill)
address@hidden example
+It's beyond the scope of this manual to explain Lisp functions, but
+for this example it is enough to know that the effect is to execute
+the @code{auto-fill-mode} function when Text mode is entered.
 
 @item
 Load the installed Lisp library named @file{foo} (actually a file

=== modified file 'doc/emacs/display.texi'
--- a/doc/emacs/display.texi    2011-10-18 21:11:17 +0000
+++ b/doc/emacs/display.texi    2011-10-20 00:41:15 +0000
@@ -703,16 +703,14 @@
 (global-font-lock-mode 0)
 @end example
 
address@hidden turn-on-font-lock
 @noindent
 If you have disabled Global Font Lock mode, you can still enable Font
 Lock for specific major modes by adding the function
address@hidden to the mode hooks (@pxref{Hooks}).  For
-example, to enable Font Lock mode for editing C files, you can do
-this:
address@hidden to the mode hooks (@pxref{Hooks}).  For example,
+to enable Font Lock mode for editing C files, you can do this:
 
 @example
-(add-hook 'c-mode-hook 'turn-on-font-lock)
+(add-hook 'c-mode-hook 'font-lock-mode)
 @end example
 
   Font Lock mode uses several specifically named faces to do its job,

=== modified file 'doc/emacs/fixit.texi'
--- a/doc/emacs/fixit.texi      2011-10-12 17:38:34 +0000
+++ b/doc/emacs/fixit.texi      2011-10-20 00:41:15 +0000
@@ -7,17 +7,14 @@
 @cindex typos, fixing
 @cindex mistakes, correcting
 
-  In this chapter we describe the commands that are especially useful
-when you catch a mistake in your text after you have made it, or
-change your mind while composing text on the fly.
-
-  The most fundamental command for correcting erroneous editing is the
-undo command @kbd{C-/} (which is also bound to @kbd{C-x u} and
address@hidden).  This undoes a single command, or a part of a command (as
-in the case of @code{query-replace}), or several consecutive
-self-inserting characters.  Consecutive repetitions of @kbd{C-/} undo
-earlier and earlier changes, back to the limit of the undo information
-available.
+  In this chapter we describe commands that are useful when you catch
+a mistake while editing.  The most fundamental command for correcting
+erroneous editing is the undo command @kbd{C-/} (which is also bound
+to @kbd{C-x u} and @kbd{C-_}).  This undoes a single command, or a
+part of a command (as in the case of @code{query-replace}), or several
+consecutive character insertions.  Consecutive repetitions of
address@hidden/} undo earlier and earlier changes, back to the limit of the
+undo information available.
 
   Aside from the commands described here, you can erase text using
 deletion commands such as @key{DEL} (@code{delete-backward-char}).
@@ -231,18 +228,19 @@
   This section describes the commands to check the spelling of a
 single word or of a portion of a buffer.  These commands only work if
 the spelling checker program Aspell, Ispell or Hunspell is installed.
-Aspell, Ispell or Hunspell are not part of Emacs, but one or the other
-is usually installed in GNU/Linux and other free operating systems.
+These programs are not part of Emacs, but one of them is usually
+installed in GNU/Linux and other free operating systems.
 @ifnottex
 @xref{Top, Aspell,, aspell, The Aspell Manual}.
 @end ifnottex
 
 @table @kbd
 @item M-$
-Check and correct spelling of the active region or the word at point
-(@code{ispell-word}).
+Check and correct spelling of the word at point (@code{ispell-word}).
+If the region is active, do it for all words in the region instead.
 @item M-x ispell
-Check and correct spelling in the active region or the entire buffer.
+Check and correct spelling of all words in the buffer.  If the region
+is active, do it for all words in the region instead.
 @item M-x ispell-buffer
 Check and correct spelling in the buffer.
 @item M-x ispell-region
@@ -355,14 +353,13 @@
 @end table
 
 @findex ispell-complete-word
-  In Text mode and related modes, the command @address@hidden
-(@code{ispell-complete-word}) shows a list of completions based on
+  In Text mode and related modes, @address@hidden
+(@code{ispell-complete-word}) performs in-buffer completion based on
 spelling correction.  Insert the beginning of a word, and then type
address@hidden@key{TAB}}; the command displays a completion list window.  (If
-your window manager intercepts @address@hidden, type @address@hidden
address@hidden or @kbd{C-M-i}.)  To choose one of the completions listed,
-click @kbd{Mouse-2} or @kbd{Mouse-1} fast on it, or move the cursor
-there in the completions window and type @key{RET}.  @xref{Text Mode}.
address@hidden@key{TAB}}; this shows shows a list of completions.  (If your
+window manager intercepts @address@hidden, type @address@hidden
address@hidden or @kbd{C-M-i}.)  Each completion is listed with a digit or
+character; type that digit or character to choose it.
 
 @cindex @code{ispell} program
 @findex ispell-kill-ispell
@@ -370,29 +367,27 @@
 to run, waiting for something to do, so that subsequent spell checking
 commands complete more quickly.  If you want to get rid of the
 process, use @kbd{M-x ispell-kill-ispell}.  This is not usually
-necessary, since the process uses no time except when you do spelling
-correction.
+necessary, since the process uses no processor time except when you do
+spelling correction.
 
 @vindex ispell-dictionary
 @vindex ispell-local-dictionary
 @vindex ispell-personal-dictionary
address@hidden ispell-change-dictionary
+  Ispell, Aspell and Hunspell look up spelling in two dictionaries:
+the standard dictionary and your personal dictionary.  The standard
+dictionary is specified by the variable @code{ispell-local-dictionary}
+or, if that is @code{nil}, by the variable @code{ispell-dictionary}.
+If both are @code{nil}, the spelling program's default dictionary is
+used.  The command @kbd{M-x ispell-change-dictionary} sets the
+standard dictionary for the buffer and then restarts the subprocess,
+so that it will use a different standard dictionary.  Your personal
+dictionary is specified by the variable
address@hidden  If that is @code{nil}, the
+spelling program looks for a personal dictionary in a default
+location.
+
 @vindex ispell-complete-word-dict
-  Ispell, Aspell and Hunspell use two dictionaries together for spell checking:
-the standard dictionary and your private dictionary.  The standard
-dictionary is specified by @code{ispell-local-dictionary} or,
-if @code{nil}, by @code{ispell-dictionary}.  If both are @code{nil}
-the default dictionary is selected.  The command
address@hidden ispell-change-dictionary} sets the standard dictionary for
-the buffer and then restarts the subprocess, so that it will use a
-different standard dictionary.  Personal dictionary is specified by
address@hidden  If @code{nil}, default value is
-used.
-
-  Set variable @code{ispell-dictionary} to select a specific default
-dictionary for all your documents. Set variable
address@hidden in the local variables section to
-select a specific dictionary for a given document.
-
   A separate dictionary is used for word completion.  The variable
 @code{ispell-complete-word-dict} specifies the file name of this
 dictionary.  The completion dictionary must be different because it
@@ -400,16 +395,14 @@
 is a spell checking dictionary but no word completion dictionary.
 
 @cindex Flyspell mode
address@hidden mode, Flyspell
 @findex flyspell-mode
address@hidden turn-on-flyspell
-  Flyspell mode is a fully-automatic way to check spelling as you edit
-in Emacs.  It operates by checking words as you change or insert them.
-When it finds a word that it does not recognize, it highlights that
-word.  This does not interfere with your editing, but when you see the
-highlighted word, you can move to it and fix it.  Type @kbd{M-x
-flyspell-mode} to enable or disable this mode in the current buffer.
-To enable Flyspell mode in all text mode buffers, add
address@hidden to @code{text-mode-hook}.
+  Flyspell mode is a minor mode that performs automatic spell checking
+as you type.  When it finds a word that it does not recognize, it
+highlights that word.  Type @kbd{M-x flyspell-mode} to toggle Flyspell
+mode in the current buffer.  To enable Flyspell mode in all text mode
+buffers, add @code{flyspell-mode} to @code{text-mode-hook}.
address@hidden
 
   When Flyspell mode highlights a word as misspelled, you can click on
 it with @kbd{Mouse-2} to display a menu of possible corrections and

=== modified file 'doc/emacs/fortran-xtra.texi'
--- a/doc/emacs/fortran-xtra.texi       2011-07-09 00:51:42 +0000
+++ b/doc/emacs/fortran-xtra.texi       2011-10-20 00:41:15 +0000
@@ -479,7 +479,7 @@
 Otherwise (and by default), the break comes before the delimiter.
 
   To enable Auto Fill in all Fortran buffers, add
address@hidden to @code{fortran-mode-hook}.
address@hidden to @code{fortran-mode-hook}.
 @iftex
 @xref{Hooks,,, emacs, the Emacs Manual}.
 @end iftex

=== modified file 'doc/emacs/rmail.texi'
--- a/doc/emacs/rmail.texi      2011-10-01 21:54:33 +0000
+++ b/doc/emacs/rmail.texi      2011-10-20 00:41:15 +0000
@@ -1198,7 +1198,7 @@
 
 @c FIXME goto-addr.el commentary says to use goto-address instead.
 @smallexample
-(add-hook 'rmail-show-message-hook (lambda () (goto-address-mode 1)))
+(add-hook 'rmail-show-message-hook 'goto-address-mode)
 @end smallexample
 
 @noindent