From debbugs-submit-bounces@debbugs.gnu.org Wed Jan 25 12:34:45 2023 Received: (at submit) by debbugs.gnu.org; 25 Jan 2023 17:34:45 +0000 Received: from localhost ([127.0.0.1]:59864 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pKjfY-0000FU-Oj for submit@debbugs.gnu.org; Wed, 25 Jan 2023 12:34:45 -0500 Received: from lists.gnu.org ([209.51.188.17]:33168) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pKjfX-0000FN-BY for submit@debbugs.gnu.org; Wed, 25 Jan 2023 12:34:43 -0500 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 1pKjfX-0007zP-5Z for bug-gnu-emacs@gnu.org; Wed, 25 Jan 2023 12:34:43 -0500 Received: from relay5-d.mail.gandi.net ([2001:4b98:dc4:8::225]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pKjfV-0006Ds-6U for bug-gnu-emacs@gnu.org; Wed, 25 Jan 2023 12:34:42 -0500 Received: (Authenticated sender: juri@linkov.net) by mail.gandi.net (Postfix) with ESMTPSA id 024761C000D for ; Wed, 25 Jan 2023 17:34:35 +0000 (UTC) From: Juri Linkov To: bug-gnu-emacs@gnu.org Subject: 29.0.60; Split Outline Mode node to Outline Minor Mode node Organization: LINKOV.NET Date: Wed, 25 Jan 2023 19:31:28 +0200 Message-ID: <86k01aikr3.fsf@mail.linkov.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/30.0.50 (x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Received-SPF: pass client-ip=2001:4b98:dc4:8::225; envelope-from=juri@linkov.net; helo=relay5-d.mail.gandi.net X-Spam_score_int: -25 X-Spam_score: -2.6 X-Spam_bar: -- X-Spam_report: (-2.6 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.6 (-) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.6 (--) --=-=-= Content-Type: text/plain Tags: patch Text that describes Outline minor mode is too long and more features will be added to it, so better to split it to the separate node: --=-=-= Content-Type: text/x-diff Content-Disposition: inline; filename=outline-minor-mode-node.patch diff --git a/doc/emacs/text.texi b/doc/emacs/text.texi index 8fbf731a4f7..83d5869ee64 100644 --- a/doc/emacs/text.texi +++ b/doc/emacs/text.texi @@ -958,8 +958,6 @@ Outline Mode @cindex invisible lines @findex outline-mode -@findex outline-minor-mode -@vindex outline-minor-mode-prefix @vindex outline-mode-hook Outline mode is a major mode derived from Text mode, which is specialized for editing outlines. It provides commands to navigate @@ -982,6 +980,19 @@ Outline Mode line really kills all the following invisible text associated with the ellipsis. +@menu +* Outline Minor Mode:: Outline mode to use with other major modes. +* Outline Format:: What the text of an outline looks like. +* Outline Motion:: Special commands for moving through outlines. +* Outline Visibility:: Commands to control what is visible. +* Outline Views:: Outlines and multiple views. +* Foldout:: Folding means zooming in on outlines. +@end menu + +@node Outline Minor Mode +@subsection Outline Minor Mode + +@findex outline-minor-mode Outline minor mode is a buffer-local minor mode which provides the same commands as the major mode, Outline mode, but can be used in conjunction with other major modes. You can type @kbd{M-x @@ -990,6 +1001,7 @@ Outline Mode specific file (@pxref{File Variables}). @kindex C-c @@ @r{(Outline minor mode)} +@vindex outline-minor-mode-prefix The major mode, Outline mode, provides special key bindings on the @kbd{C-c} prefix. Outline minor mode provides similar bindings with @kbd{C-c @@} as the prefix; this is to reduce the conflicts with the @@ -1014,14 +1026,6 @@ Outline Mode sub-heading, and showing all for the current section. @kbd{S-@key{TAB}} does the same for the entire buffer. -@menu -* Outline Format:: What the text of an outline looks like. -* Outline Motion:: Special commands for moving through outlines. -* Outline Visibility:: Commands to control what is visible. -* Outline Views:: Outlines and multiple views. -* Foldout:: Folding means zooming in on outlines. -@end menu - @node Outline Format @subsection Format of Outlines --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Wed Jan 25 12:51:42 2023 Received: (at 61062) by debbugs.gnu.org; 25 Jan 2023 17:51:42 +0000 Received: from localhost ([127.0.0.1]:59898 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pKjvy-0000kf-Dd for submit@debbugs.gnu.org; Wed, 25 Jan 2023 12:51:42 -0500 Received: from eggs.gnu.org ([209.51.188.92]:34344) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pKjvw-0000kR-9B for 61062@debbugs.gnu.org; Wed, 25 Jan 2023 12:51:41 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pKjvq-0000Id-Hy; Wed, 25 Jan 2023 12:51:34 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=1fd8ZjxgGhQrqxWyAyeMndsVe2INqptHxkoPXVmGbZ0=; b=J144+gc/mfsh OMgOsYDgGl7io2tODskUNlDvazhLdTiHuavyvvaHGG85KiAD5rLELW6SZFmMpOIvgHb8JAc/nGRHw cxrZ3M1qsVA4r0/5h7t5NMUREsm41w8ytxdyU28t2vArgSs82CaFfY9Ae8iaY5tcrWcTvqXO9lTDW DrrDk273Xf7dcXA5FE3uScIrsr1aAYaEPxwP/zgkT8bxew9zYdGElQme2XYSyvQ1JD5mWqkWk4QBP rUno1NI1V+PyvCNZWag1JBd0HP4eLC2UGh8jTJyy08fiBVIhPGnDAlwmeKEEWkFBE3nl2aoSFWZ8e TpUBGn3qTd4ZP1wiv/ozWg==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pKjvq-0005bV-1Q; Wed, 25 Jan 2023 12:51:34 -0500 Date: Wed, 25 Jan 2023 19:51:47 +0200 Message-Id: <83h6wefqoc.fsf@gnu.org> From: Eli Zaretskii To: Juri Linkov In-Reply-To: <86k01aikr3.fsf@mail.linkov.net> (message from Juri Linkov on Wed, 25 Jan 2023 19:31:28 +0200) Subject: Re: bug#61062: 29.0.60; Split Outline Mode node to Outline Minor Mode node References: <86k01aikr3.fsf@mail.linkov.net> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 61062 Cc: 61062@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Juri Linkov > Date: Wed, 25 Jan 2023 19:31:28 +0200 > > Text that describes Outline minor mode is too long and more features > will be added to it, so better to split it to the separate node: I agree, thanks. From debbugs-submit-bounces@debbugs.gnu.org Wed Jan 25 13:21:32 2023 Received: (at 61062) by debbugs.gnu.org; 25 Jan 2023 18:21:32 +0000 Received: from localhost ([127.0.0.1]:59970 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pKkOq-0001ZF-0o for submit@debbugs.gnu.org; Wed, 25 Jan 2023 13:21:32 -0500 Received: from relay3-d.mail.gandi.net ([217.70.183.195]:44717) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pKkOo-0001Z2-HN for 61062@debbugs.gnu.org; Wed, 25 Jan 2023 13:21:30 -0500 Received: (Authenticated sender: juri@linkov.net) by mail.gandi.net (Postfix) with ESMTPSA id 3B1E860002; Wed, 25 Jan 2023 18:21:21 +0000 (UTC) From: Juri Linkov To: Eli Zaretskii Subject: Re: bug#61062: 29.0.60; Split Outline Mode node to Outline Minor Mode node In-Reply-To: <83h6wefqoc.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 25 Jan 2023 19:51:47 +0200") Organization: LINKOV.NET References: <86k01aikr3.fsf@mail.linkov.net> <83h6wefqoc.fsf@gnu.org> Date: Wed, 25 Jan 2023 20:20:40 +0200 Message-ID: <864jseiih3.fsf@mail.linkov.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/30.0.50 (x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 61062 Cc: 61062@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) >> Text that describes Outline minor mode is too long and more features >> will be added to it, so better to split it to the separate node: > > I agree, thanks. 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. From debbugs-submit-bounces@debbugs.gnu.org Wed Jan 25 14:54:49 2023 Received: (at 61062) by debbugs.gnu.org; 25 Jan 2023 19:54:49 +0000 Received: from localhost ([127.0.0.1]:60026 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pKlr7-00042J-3M for submit@debbugs.gnu.org; Wed, 25 Jan 2023 14:54:49 -0500 Received: from eggs.gnu.org ([209.51.188.92]:34844) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pKlr2-000424-IT for 61062@debbugs.gnu.org; Wed, 25 Jan 2023 14:54:48 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pKlqw-0003ZL-Uo; Wed, 25 Jan 2023 14:54:38 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=qNfjhwILO2wcTCaM5BZ8CmEssC3lVUPYAcWXVxw9PI8=; b=N2OXHEKlU2ji VUpNsaolpA8i+2a7VQxPLbEUG4GNh1LaiaLYd5gaUWEtTSAfFUu5ezUl8Bm5cveViEcxSKVX4HQGI XsSnOd46LGlaHD+X8BVldCYwtYVuY9dMnfy5nU9VBzYFksPoTdAiUdyEgQVW8H6Qc176oMrqX+8UC enPyI12xAm3uf4IuwMRIdVFhX9h7MixfNNQzuf4UPmd84bew1z3U8JKEYsSWCz2ym6OGnYHIirPW8 Kz01NdXmesxvLrXF81AfoSiPU2g8BlgJvjNG5BH/8SbG1nghr8Ierqt6yDeM1vfnMWKxRcu+9Tr6A 0T2WHoukgyrG0d1UGXKcuA==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pKlqw-0006o4-Dk; Wed, 25 Jan 2023 14:54:38 -0500 Date: Wed, 25 Jan 2023 21:54:51 +0200 Message-Id: <83fsbyfkz8.fsf@gnu.org> From: Eli Zaretskii To: Juri Linkov In-Reply-To: <864jseiih3.fsf@mail.linkov.net> (message from Juri Linkov on Wed, 25 Jan 2023 20:20:40 +0200) Subject: Re: bug#61062: 29.0.60; Split Outline Mode node to Outline Minor Mode node References: <86k01aikr3.fsf@mail.linkov.net> <83h6wefqoc.fsf@gnu.org> <864jseiih3.fsf@mail.linkov.net> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 61062 Cc: 61062@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Juri Linkov > Cc: 61062@debbugs.gnu.org > Date: Wed, 25 Jan 2023 20:20:40 +0200 > > >> Text that describes Outline minor mode is too long and more features > >> will be added to it, so better to split it to the separate node: > > > > I agree, thanks. > > 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? From debbugs-submit-bounces@debbugs.gnu.org Fri Jan 27 03:00:36 2023 Received: (at 61062) by debbugs.gnu.org; 27 Jan 2023 08:00:36 +0000 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 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 Received: (Authenticated sender: juri@linkov.net) by mail.gandi.net (Postfix) with ESMTPSA id 9192F60002; Fri, 27 Jan 2023 08:00:18 +0000 (UTC) From: Juri Linkov To: Eli Zaretskii Subject: Re: bug#61062: 29.0.60; Split Outline Mode node to Outline Minor Mode node In-Reply-To: <83fsbyfkz8.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 25 Jan 2023 21:54:51 +0200") Organization: LINKOV.NET References: <86k01aikr3.fsf@mail.linkov.net> <83h6wefqoc.fsf@gnu.org> <864jseiih3.fsf@mail.linkov.net> <83fsbyfkz8.fsf@gnu.org> Date: Fri, 27 Jan 2023 09:56:52 +0200 Message-ID: <861qngh0l7.fsf@mail.linkov.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/30.0.50 (x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 61062 Cc: 61062@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) >> 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 From debbugs-submit-bounces@debbugs.gnu.org Fri Jan 27 03:16:01 2023 Received: (at 61062) by debbugs.gnu.org; 27 Jan 2023 08:16:01 +0000 Received: from localhost ([127.0.0.1]:36674 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pLJtw-0006VT-Uk for submit@debbugs.gnu.org; Fri, 27 Jan 2023 03:16:01 -0500 Received: from eggs.gnu.org ([209.51.188.92]:48708) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pLJtu-0006VA-Kl for 61062@debbugs.gnu.org; Fri, 27 Jan 2023 03:15:59 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pLJto-0008Fp-T3; Fri, 27 Jan 2023 03:15:53 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=1Twokh8HXMbiKMN9Fs7RHTKncDnrRlaZ+QbPSCCyM6o=; b=Qg0Qgv0XGH+3 gZm6DvZPgHR61IjlDveolqa+NsYJ2cTV5ulNLjoP5F1Gd3V8RysJM4EVza0ZvN1gFqC2M1fDaWhsL 803vp+BVq3fis8wXSoJThzWB/CHRZtk4RnMpT5/mp7n0ETRtGBbfmSmij0Ft74Wb3XaHBoc1WLsNT q4kmyRbUctr8JrORcfhYvmBrb6bwAZeqNaylSge8vkfNb5EvFVsrIkNNgtFMrPuQFj7zZzg4alKCO dvxIm6925FSaqFLx9CYvxoU1epN98yh1cLsx2T4u/lPoMWTV+aYFGRswbWwvX+oCxxCbGAMOeM/+A Psc3fxrJgjBbGf3HVpQMCw==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pLJto-0005Xx-Cc; Fri, 27 Jan 2023 03:15:52 -0500 Date: Fri, 27 Jan 2023 10:15:37 +0200 Message-Id: <838rhocs0m.fsf@gnu.org> From: Eli Zaretskii To: Juri Linkov In-Reply-To: <861qngh0l7.fsf@mail.linkov.net> (message from Juri Linkov on Fri, 27 Jan 2023 09:56:52 +0200) Subject: Re: bug#61062: 29.0.60; Split Outline Mode node to Outline Minor Mode node References: <86k01aikr3.fsf@mail.linkov.net> <83h6wefqoc.fsf@gnu.org> <864jseiih3.fsf@mail.linkov.net> <83fsbyfkz8.fsf@gnu.org> <861qngh0l7.fsf@mail.linkov.net> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 61062 Cc: 61062@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Juri Linkov > Cc: 61062@debbugs.gnu.org > Date: Fri, 27 Jan 2023 09:56:52 +0200 > > 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? If the list is not too long, I think listing those modes in NEWS would be useful. > BTW, it looks like more links could be added to the manual: Adding cross-references is always a Good Thing, thanks. The only situation where such cross-references could be inappropriate is if some prior text in the same node and close enough already has a cross-reference to the same place. In all other cases, such cross-references are most welcome. From debbugs-submit-bounces@debbugs.gnu.org Sat Jan 28 13:00:22 2023 Received: (at 61062) by debbugs.gnu.org; 28 Jan 2023 18:00:22 +0000 Received: from localhost ([127.0.0.1]:41471 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pLpUz-0006Yy-Ua for submit@debbugs.gnu.org; Sat, 28 Jan 2023 13:00:22 -0500 Received: from relay11.mail.gandi.net ([217.70.178.231]:33951) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pLpUv-0006YZ-0O; Sat, 28 Jan 2023 13:00:20 -0500 Received: (Authenticated sender: juri@linkov.net) by mail.gandi.net (Postfix) with ESMTPSA id 9A12D100004; Sat, 28 Jan 2023 18:00:09 +0000 (UTC) From: Juri Linkov To: Eli Zaretskii Subject: Re: bug#61062: 29.0.60; Split Outline Mode node to Outline Minor Mode node In-Reply-To: <838rhocs0m.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 27 Jan 2023 10:15:37 +0200") Organization: LINKOV.NET References: <86k01aikr3.fsf@mail.linkov.net> <83h6wefqoc.fsf@gnu.org> <864jseiih3.fsf@mail.linkov.net> <83fsbyfkz8.fsf@gnu.org> <861qngh0l7.fsf@mail.linkov.net> <838rhocs0m.fsf@gnu.org> Date: Sat, 28 Jan 2023 19:59:47 +0200 Message-ID: <86pmay4k18.fsf@mail.linkov.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/30.0.50 (x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 61062 Cc: 61062@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) close 61062 29.0.60 quit >> 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? > > If the list is not too long, I think listing those modes in NEWS would > be useful. Done. >> BTW, it looks like more links could be added to the manual: > > Adding cross-references is always a Good Thing, thanks. The only > situation where such cross-references could be inappropriate is if > some prior text in the same node and close enough already has a > cross-reference to the same place. In all other cases, such > cross-references are most welcome. Also pushed to emacs-29. From unknown Sun Jun 22 03:56:49 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 26 Feb 2023 12:24:07 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator