From 993116eec9a09555c0e725c4672863a1776bbd0f Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Tue, 13 Oct 2020 19:39:11 +0300 Subject: [PATCH] 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 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 diff --git a/etc/NEWS b/etc/NEWS index 6abf6c5ae5d..aa1582f0e75 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 95670e04936..a4ce9afb445 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) -- 2.39.5