From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.bugs Subject: bug#61062: 29.0.60; Split Outline Mode node to Outline Minor Mode node Date: Fri, 27 Jan 2023 09:56:52 +0200 Organization: LINKOV.NET Message-ID: <861qngh0l7.fsf@mail.linkov.net> References: <86k01aikr3.fsf@mail.linkov.net> <83h6wefqoc.fsf@gnu.org> <864jseiih3.fsf@mail.linkov.net> <83fsbyfkz8.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="16746"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/30.0.50 (x86_64-pc-linux-gnu) Cc: 61062@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Jan 27 09:01:25 2023 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1pLJfo-0004EK-WC for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 27 Jan 2023 09:01:25 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pLJfc-0008Cb-RJ; Fri, 27 Jan 2023 03:01:12 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pLJfS-00089v-Sf for bug-gnu-emacs@gnu.org; Fri, 27 Jan 2023 03:01:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pLJfS-0004AZ-KQ for bug-gnu-emacs@gnu.org; Fri, 27 Jan 2023 03:01:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pLJfS-00064q-G8 for bug-gnu-emacs@gnu.org; Fri, 27 Jan 2023 03:01:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Juri Linkov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 27 Jan 2023 08:01:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 61062 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 61062-submit@debbugs.gnu.org id=B61062.167480643623295 (code B ref 61062); Fri, 27 Jan 2023 08:01:02 +0000 Original-Received: (at 61062) by debbugs.gnu.org; 27 Jan 2023 08:00:36 +0000 Original-Received: from localhost ([127.0.0.1]:36644 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pLJf1-00063f-NJ for submit@debbugs.gnu.org; Fri, 27 Jan 2023 03:00:36 -0500 Original-Received: from relay3-d.mail.gandi.net ([217.70.183.195]:40981) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pLJes-000636-DS for 61062@debbugs.gnu.org; Fri, 27 Jan 2023 03:00:26 -0500 Original-Received: (Authenticated sender: juri@linkov.net) by mail.gandi.net (Postfix) with ESMTPSA id 9192F60002; Fri, 27 Jan 2023 08:00:18 +0000 (UTC) In-Reply-To: <83fsbyfkz8.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 25 Jan 2023 21:54:51 +0200") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:254247 Archived-At: >> Pushed, but not yet closed. I could try to document >> outline-minor-mode-highlight as well since its counterpart >> outline-minor-mode-cycle was already added to the manual. > > It sounds like this is a problematic option, whose use could produce > unwanted results. Are you sure it is a good idea to document it in > the manual? I agree that it's not suitable for the manual. Another question that I'm not sure about is whether it makes sense to mention all outline-minor-mode supported modes in etc/NEWS? I mean that we prepared outline-minor-mode related settings in some modes, but not enabled outline-minor-mode in these modes. For example, we set such values as outline-search-function, outline-level, outline-minor-mode-use-buttons, etc. in apropos-mode and xref. So the users could easily enable outline-minor-mode in these modes, and it will work without additional customization. Does it make sense to list these modes in etc/NEWS, so users will know where they can enable outline-minor-mode? Probably support for apropos-mode could be mentioned under the section Help mode, and outline-minor-mode for xref under the section Xref? BTW, it looks like more links could be added to the manual: diff --git a/doc/emacs/text.texi b/doc/emacs/text.texi index 83d5869ee64..6a943c775b2 100644 --- a/doc/emacs/text.texi +++ b/doc/emacs/text.texi @@ -1017,14 +1017,16 @@ Outline Minor Mode 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. @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 (@pxref{Outline Visibility, outline-cycle}). @node Outline Format @subsection Format of Outlines