From: Juri Linkov <juri@linkov.net>
Date: Sat, 28 Jan 2023 17:59:22 +0000 (+0200)
Subject: Minor documentation improvements for outline-minor-mode (bug#61062)
X-Git-Tag: emacs-29.0.90~575
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=450db0587a91ff13403488fbabc744567be7f6fa;p=emacs.git

Minor documentation improvements for outline-minor-mode (bug#61062)

* doc/emacs/text.texi (Outline Minor Mode, Outline Minor Mode):
Add pxrefs to "Icons" and "Outline Visibility".

* etc/NEWS: Mention outline-minor-mode for two modes.
---

diff --git a/doc/emacs/text.texi b/doc/emacs/text.texi
index 83d5869ee64..3cc5f10582a 100644
--- a/doc/emacs/text.texi
+++ b/doc/emacs/text.texi
@@ -1017,14 +1017,16 @@ this variable is @code{insert}, the buttons are inserted directly into
 the buffer text, so @key{RET} on the button will also toggle display
 of the section, like a mouse click does.  If the value is
 @code{in-margins}, Outline minor mode will use the window margins to
-indicate that a section is hidden.
+indicate that a section is hidden.  The buttons are customizable as icons
+(@pxref{Icons}).
 
 @vindex outline-minor-mode-cycle
   If the @code{outline-minor-mode-cycle} user option is
-non-@code{nil}, the @kbd{TAB} and @kbd{S-@key{TAB}} keys are enabled on the
-outline heading lines.  @kbd{TAB} cycles hiding, showing the
-sub-heading, and showing all for the current section.  @kbd{S-@key{TAB}}
-does the same for the entire buffer.
+non-@code{nil}, the @kbd{TAB} and @kbd{S-@key{TAB}} keys that cycle
+the visibility are enabled on the outline heading lines
+(@pxref{Outline Visibility, outline-cycle}).  @kbd{TAB} cycles hiding,
+showing the sub-heading, and showing all for the current section.
+@kbd{S-@key{TAB}} does the same for the entire buffer.
 
 @node Outline Format
 @subsection Format of Outlines
diff --git a/etc/NEWS b/etc/NEWS
index 4d199676848..fb211f9b7d0 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1018,6 +1018,8 @@ quotes removed.
 
 ---
 *** 'M-x apropos-variable' output now includes values of variables.
+Such apropos buffer is more easily viewed with outlining after
+enabling 'outline-minor-mode' in 'apropos-mode'.
 
 +++
 *** New docstring syntax to indicate that symbols shouldn't be links.
@@ -2480,6 +2482,10 @@ matches.
 ---
 *** New function 'xref-show-xrefs'.
 
+*** 'outline-minor-mode' is supported in Xref buffers.
+You can enable outlining by adding 'outline-minor-mode' to
+'xref-after-update-hook'.
+
 ** File Notifications
 
 +++