master 993116e: Fix documentation of Outline cycling commands

[Eli Zaretskii]

branch: master
commit 993116eec9a09555c0e725c4672863a1776bbd0f
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    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.
---
 doc/emacs/text.texi | 13 +++++++------
 etc/NEWS            |  2 +-
 lisp/outline.el     |  2 +-
 3 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/doc/emacs/text.texi b/doc/emacs/text.texi
index 9c2822c..c77dcf7 100644
--- 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 6abf6c5..aa1582f 100644
--- 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 95670e0..a4ce9af 100644
--- 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)