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.

1 files changed, 7 insertions, 6 deletions

diff --git a/doc/emacs/text.texi b/doc/emacs/text.texi
index 9c2822ce15b..c77dcf7fbce 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