Fix documentation of Outline cycling commands

* lisp/outline.el (outline-mode-map): Fix wording of a comment.

* doc/emacs/text.texi (Outline Visibility): Fix wording and markup
of a recently added paragraph.  Improve indexing.

* etc/NEWS: Fix whitespace of a recently added entry.

diff --git a/doc/emacs/text.texi b/doc/emacs/text.texi
index 9c2822ce15b5b4a10e8e4345d4ab9a0336625593..c77dcf7fbced1ebcaad2d16f4f0f825ee8900b95 100644 (file)
--- a/doc/emacs/text.texi
+++ b/doc/emacs/text.texi
@@ -1207,15 +1207,16 @@ everything except the top @var{n} levels of heading lines.  Note that
 it completely reveals all the @var{n} top levels and the body lines
 before the first heading.
 
+@cindex cycle visibility, in Outline mode
 @findex outline-cycle
 @findex outline-cycle-buffer
   Outline also provides two convenience commands to cycle the
-visibility of each section and the whole buffer.  Typing @kbd{TAB} on
-a heading invokes @code{outline-cycle}, which cycles the current
-section between "hide all", "subheadings", and "show all" state.
-Typing @kbd{S-TAB} invokes @code{outline-cycle-buffer}, which cycles
-the whole buffer between "only top-level headings", "all headings and
-subheadings", and "show all" states.
+visibility of each section and the whole buffer.  Typing
+@kbd{@key{TAB}} (@code{outline-cycle}) on a heading cycles the current
+section between ``hide all'', ``subheadings'', and ``show all''
+states.  Typing @kbd{S-@key{TAB}} (@code{outline-cycle-buffer}) cycles
+the whole buffer between ``only top-level headings'', ``all headings
+and subheadings'', and ``show all'' states.
 
 @anchor{Outline Search}
 @findex reveal-mode

diff --git a/etc/NEWS b/etc/NEWS
index 6abf6c5ae5d2e58a40cea9ed80f4706ffb81aa98..aa1582f0e75b8b6cb4e5cd674bdcbf08a5b179c6 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -238,7 +238,7 @@ trying to be non-destructive.
 +++
 *** New commands to cycle heading visibility.
 Typing 'TAB' on a heading cycles the current section between "hide
-all", "subheadings", and "show all" state. Typing 'S-TAB' anywhere in
+all", "subheadings", and "show all" state.  Typing 'S-TAB' anywhere in
 the buffer cycles the whole buffer between "only top-level headings",
 "all headings and subheadings", and "show all" states.
 

diff --git a/lisp/outline.el b/lisp/outline.el
index 95670e04936a677f792d0795fdda4f6f10248014..a4ce9afb4452fa791938ee5da19e66b6445714d0 100644 (file)
--- a/lisp/outline.el
+++ b/lisp/outline.el
@@ -179,7 +179,7 @@ in the file it applies to.")
   (let ((map (make-sparse-keymap)))
     (define-key map "\C-c" outline-mode-prefix-map)
     (define-key map [menu-bar] outline-mode-menu-bar-map)
-    ;; Only takes effect if the point is on a heading.
+    ;; Only takes effect if point is on a heading.
     (define-key map (kbd "TAB")
       `(menu-item "" outline-cycle
                   :filter ,(lambda (cmd)