X-Loop: help-debbugs@HIDDEN
Subject: bug#79829: [PATCH] hideshow: Update Header Commentary.
Resent-From: Elijah Gabe =?UTF-8?Q?P=C3=A9rez?= <eg642616@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Fri, 14 Nov 2025 03:53:02 +0000
Resent-Message-ID: <handler.79829.B.176309232810152 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: report 79829
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: patch
To: 79829 <at> debbugs.gnu.org
X-Debbugs-Original-To: bug-gnu-emacs@HIDDEN
Received: via spool by submit <at> debbugs.gnu.org id=B.176309232810152
(code B ref -1); Fri, 14 Nov 2025 03:53:02 +0000
Received: (at submit) by debbugs.gnu.org; 14 Nov 2025 03:52:08 +0000
Received: from localhost ([127.0.0.1]:59386 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1vJkr2-0002dg-27
for submit <at> debbugs.gnu.org; Thu, 13 Nov 2025 22:52:08 -0500
Received: from lists.gnu.org ([2001:470:142::17]:55820)
by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
(Exim 4.84_2) (envelope-from <eg642616@HIDDEN>)
id 1vJkr0-0002d7-2u
for submit <at> debbugs.gnu.org; Thu, 13 Nov 2025 22:52:06 -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 <eg642616@HIDDEN>)
id 1vJkql-0000k8-9q
for bug-gnu-emacs@HIDDEN; Thu, 13 Nov 2025 22:51:51 -0500
Received: from mail-yw1-x1144.google.com ([2607:f8b0:4864:20::1144])
by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
(Exim 4.90_1) (envelope-from <eg642616@HIDDEN>)
id 1vJkqi-0004Sr-N9
for bug-gnu-emacs@HIDDEN; Thu, 13 Nov 2025 22:51:49 -0500
Received: by mail-yw1-x1144.google.com with SMTP id
00721157ae682-786943affbaso13341217b3.0
for <bug-gnu-emacs@HIDDEN>; Thu, 13 Nov 2025 19:51:47 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=gmail.com; s=20230601; t=1763092307; x=1763697107; darn=gnu.org;
h=mime-version:message-id:date:subject:to:from:from:to:cc:subject
:date:message-id:reply-to;
bh=DHBG05SRsHdk3opVKZVFRpqImaMn7xmBUJv1GykCJDc=;
b=N9FscEMbnuvTNjb9h6ids7bQuF2jT10Aos4OefMvHBk1hKmnHMhrDo8Eio1HUuR8+e
G5ABSq4QK6zNivjSX0EN+j/QKlR2+TKN0FxkduJbYmAzTMjMQWBSs/XfURhT5aYX18LR
KJsTLb1u+tmaJV9Qz7UtUnD4lStpbcdpRTCEbEKOEZEVjLUj+PhWRrkrVUztxfpAS86D
r/sQT2JlPcDIP+4HHb68pFSMlY7N8AfomQ79Gx3W0CRDm6E4nzq+dYTDPuEoRjLHAocB
OV0GPYZMf53F4XBKgxXSgfIR7sqms79mW2lqDI6r1EixbJI810zomL/EQ0W7Ppe6g4hX
E1CQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20230601; t=1763092307; x=1763697107;
h=mime-version:message-id:date:subject:to:from:x-gm-gg
:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to;
bh=DHBG05SRsHdk3opVKZVFRpqImaMn7xmBUJv1GykCJDc=;
b=Jp8jfKzRKT2rGEvqMPAEEV5lo46C1mwF8BJ5CH7SYYV36xDemS1IOwJ3T+kH7ByyID
gLucivbpKutCLMFY2cF31Or0zBDYPpi0QwCSM5zrtNX66JC/4LkqFECJZE5QvV8VFSPp
ZKFBfTp/g+OwHfxdMCvuvprvOAnAbprZzBWmJPwd1jPyKBxprj2yAIYgrOJHbXsAX4j1
vP1RTK8KonvF8SZRVkuWcoG/QBWC0ymYXkAprPVJN26LaFmH7KahtesUuVC+iPr/OFA7
7/y8iuGVmQom3sY4Btl5eZ6oam5Iwr0cxteFzLu8zl3ytdKrF3Xu11ENH2KhC8imXkvH
vA0Q==
X-Gm-Message-State: AOJu0Yy4PVtWHgapNzu2Vy/Ico/p5ynw2PwdJrwuxcNn0QGUF/tV/vZT
8DiY8MmGrJS/gle4NxxpMPRPlCmgsmd+icO2YGCmBsMlsiSpVobJCiZihqBpM452
X-Gm-Gg: ASbGncvYT0vNlCeyfaouL5iW5RcCPMNpXsanBF0VQg5cAnPyZPHujWr1jHIVFO9RiR7
mxEj4owRkc8JXfBM5zLz89wvPnFYKkLPilDipnj/sFpFJRBjpBSvdSyrCGpb489b5J58QVmiSbo
VMOl12uE5FmmNDznYg3hO0Hivazlp/upxdUxTCU08DU3R3JSdfY5nCfscJp6f2GVM+EjgRv4Sx9
DCtfowpuVOnWddgBLKe1KH6qNT5fbKJcvgWhFy9GTizdJIFbl4sbDly2pRlK/pvF8cGbzxwxRUE
PZ1av/9WFulw5Cu8IGjH1A8Tj7Q3KlIqtZwE372elECCIeSUVicgZPGiYsdPLFlhT6r8iLVtYlS
6E1qwO8/K3/C5Y7Ojq48g6t4IKKx13xGJIXmAEFUvY9/DK/MCCdmPCo+Ed94oUFRKR2I4
X-Google-Smtp-Source: AGHT+IGdKQAZVcaviGbMKAVxh9xW5zMxBiUYyWJU5jgWyAUuQz1TOXpBWj6jxFkkoY9jUR9yWzoWEg==
X-Received: by 2002:a05:690e:1505:b0:63f:9f5a:a555 with SMTP id
956f58d0204a3-641e768f6aamr1782421d50.50.1763092306750;
Thu, 13 Nov 2025 19:51:46 -0800 (PST)
Received: from fedora ([189.215.165.71]) by smtp.gmail.com with ESMTPSA id
956f58d0204a3-6410e9e964dsm1346388d50.5.2025.11.13.19.51.42
for <bug-gnu-emacs@HIDDEN>
(version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
Thu, 13 Nov 2025 19:51:46 -0800 (PST)
From: Elijah Gabe =?UTF-8?Q?P=C3=A9rez?= <eg642616@HIDDEN>
Date: Thu, 13 Nov 2025 21:51:34 -0600
Message-ID: <87ms4p8e61.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="=-=-="
Received-SPF: pass client-ip=2607:f8b0:4864:20::1144;
envelope-from=eg642616@HIDDEN; helo=mail-yw1-x1144.google.com
X-Spam_score_int: -17
X-Spam_score: -1.8
X-Spam_bar: -
X-Spam_report: (-1.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,
DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,
FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001,
RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001,
SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: 1.2 (+)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
has NOT identified this incoming email as spam. The original
message has been attached to this so you can view it or label
similar future email. If you have any questions, see
the administrator of that system for details.
Content preview: Tags: patch This add a new section in the `;; Commentary:`
header to explain how to migrate from the obsolete `hs-special-modes-alist`
to the new API variables in the hope of guiding package maintainers to update
[...] Content analysis details: (1.2 points, 10.0 required)
pts rule name description
---- ---------------------- --------------------------------------------------
1.0 SPF_SOFTFAIL SPF: sender does not match SPF record (softfail)
-0.0 RCVD_IN_DNSWL_NONE RBL: Sender listed at https://www.dnswl.org/,
no trust [2001:470:142:0:0:0:0:17 listed in] [list.dnswl.org]
0.0 FREEMAIL_FROM Sender email is commonly abused enduser mail
provider (eg642616[at]gmail.com)
-0.0 SPF_HELO_PASS SPF: HELO matches SPF record
0.2 FREEMAIL_ENVFROM_END_DIGIT Envelope-from freemail username ends
in digit (eg642616[at]gmail.com)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 0.2 (/)
--=-=-=
Content-Type: text/plain
Tags: patch
This add a new section in the `;; Commentary:` header to explain how to
migrate from the obsolete `hs-special-modes-alist` to the new API
variables in the hope of guiding package maintainers to update their
code appropriately.
--=-=-=
Content-Type: text/x-patch
Content-Disposition: attachment;
filename=0001-hideshow-Update-Header-Commentary.-Bug.patch
From 9fa5b4289e074358a1bcc02192513d9fa6e41f74 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?El=C3=ADas=20Gabriel=20P=C3=A9rez?= <eg642616@HIDDEN>
Date: Thu, 13 Nov 2025 20:12:47 -0600
Subject: [PATCH] hideshow: Update Header Commentary. (Bug#)
* lisp/progmodes/hideshow.el: Document how to migrate from
'hs-special-modes-alist'.
---
lisp/progmodes/hideshow.el | 26 ++++++++++++++++++++++++--
1 file changed, 24 insertions(+), 2 deletions(-)
diff --git a/lisp/progmodes/hideshow.el b/lisp/progmodes/hideshow.el
index 18a621f71ef..4bbc968c82d 100644
--- a/lisp/progmodes/hideshow.el
+++ b/lisp/progmodes/hideshow.el
@@ -146,7 +146,9 @@
;; (overlay-end ov)))
;; 'face 'font-lock-type-face)))))
-;; * Adding support for a major mode
+;; * Extending hideshow
+
+;; ** Adding support for a major mode
;;
;; Normally, hideshow tries to determine appropriate values for block
;; and comment definitions by examining the major mode settings. If the
@@ -170,7 +172,7 @@
;; cases, `hs-forward-sexp-function' specifies another function to use
;; instead.
-;; ** Tree-sitter support
+;; *** Tree-sitter support
;;
;; All the treesit based modes already have support for hidding/showing
;; using the treesit thing `list' (see `treesit-major-mode-setup').
@@ -181,6 +183,26 @@
;; values in `hs-adjust-block-end-function' and `hs-adjust-block-beginning-function' to
;; properly hide the code block.
+;; ** Migrating from `hs-special-modes-alist'
+;;
+;; Starting with Emacs v31.1, `hs-special-modes-alist' has been
+;; deprecated. Instead, hideshow provides a new set of buffer-local
+;; variables that replace each of the options in
+;; `hs-special-modes-alist':
+;;
+;; hs-special-modes-alist
+;; '(MODE ; Not necessary, set the variables locally inside the
+;; ; definition of the minor or major mode.
+;; START | (START . MDATA) ::= `hs-block-start-regexp'
+;; & `hs-block-start-mdata-select'
+;; END ::= 'hs-block-end-regexp'
+;; COMMENT-START ::= 'hs-c-start-regexp'
+;; FORWARD-SEXP-FUNC ::= 'hs-forward-sexp-function'
+;; ADJUST-BEG-FUNC ::= 'hs-adjust-block-beginning-function'
+;; FIND-BLOCK-BEGINNING-FUNC ::= 'hs-find-block-beginning-function'
+;; FIND-NEXT-BLOCK-FUNC ::= 'hs-find-next-block-function'
+;; LOOKING-AT-BLOCK-START-P-FUNC ::= 'hs-looking-at-block-start-predicate')
+
;; * Bugs
;;
;; (1) Sometimes `hs-headline' can become out of sync. To reset, type
--
2.51.1
--=-=-=
Content-Type: text/plain
--
- E.G via Gnus and Org.
--=-=-=--
Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) Content-Type: text/plain; charset=utf-8 X-Loop: help-debbugs@HIDDEN From: help-debbugs@HIDDEN (GNU bug Tracking System) To: Elijah Gabe =?UTF-8?Q?P=C3=A9rez?= <eg642616@HIDDEN> Subject: bug#79829: Acknowledgement ([PATCH] hideshow: Update Header Commentary.) Message-ID: <handler.79829.B.176309232810152.ack <at> debbugs.gnu.org> References: <87ms4p8e61.fsf@HIDDEN> X-Gnu-PR-Message: ack 79829 X-Gnu-PR-Package: emacs X-Gnu-PR-Keywords: patch Reply-To: 79829 <at> debbugs.gnu.org Date: Fri, 14 Nov 2025 03:53:02 +0000 Thank you for filing a new bug report with debbugs.gnu.org. This is an automatically generated reply to let you know your message has been received. Your message is being forwarded to the package maintainers and other interested parties for their attention; they will reply in due course. Your message has been sent to the package maintainer(s): bug-gnu-emacs@HIDDEN If you wish to submit further information on this problem, please send it to 79829 <at> debbugs.gnu.org. Please do not send mail to help-debbugs@HIDDEN unless you wish to report a problem with the Bug-tracking system. --=20 79829: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D79829 GNU Bug Tracking System Contact help-debbugs@HIDDEN with problems
X-Loop: help-debbugs@HIDDEN
Subject: bug#79829: [PATCH] hideshow: Update Header Commentary.
Resent-From: Juri Linkov <juri@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Fri, 14 Nov 2025 07:22:02 +0000
Resent-Message-ID: <handler.79829.B79829.17631048769327 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 79829
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: patch
To: Elijah Gabe =?UTF-8?Q?P=C3=A9rez?= <eg642616@HIDDEN>
Cc: 79829 <at> debbugs.gnu.org
Received: via spool by 79829-submit <at> debbugs.gnu.org id=B79829.17631048769327
(code B ref 79829); Fri, 14 Nov 2025 07:22:02 +0000
Received: (at 79829) by debbugs.gnu.org; 14 Nov 2025 07:21:16 +0000
Received: from localhost ([127.0.0.1]:59762 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1vJo7P-0002QM-W4
for submit <at> debbugs.gnu.org; Fri, 14 Nov 2025 02:21:16 -0500
Received: from mout-p-201.mailbox.org ([2001:67c:2050:0:465::201]:54026)
by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
(Exim 4.84_2) (envelope-from <juri@HIDDEN>)
id 1vJo7N-0002QD-Pu; Fri, 14 Nov 2025 02:21:14 -0500
Received: from smtp102.mailbox.org (smtp102.mailbox.org
[IPv6:2001:67c:2050:b231:465::102])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256)
(No client certificate requested)
by mout-p-201.mailbox.org (Postfix) with ESMTPS id 4d77pn0mx1z9v3G;
Fri, 14 Nov 2025 08:21:05 +0100 (CET)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linkov.net; s=MBO0001;
t=1763104865;
h=from:from:reply-to:subject:subject:date:date:message-id:message-id:
to:to:cc:cc:mime-version:mime-version:content-type:content-type:
in-reply-to:in-reply-to:references:references;
bh=v6BLyFgIedz9NcmquUbn/cvGCSmawinfK54UuoBmg20=;
b=Wu+BqNzIpVjFvf0ovF6DODTngfg0I6MWUyvmmFxJw9QTrCHnHqZ/HdCz9b7oo7jJcAXgBl
MHbMIunEYM7mgeQ/sCxgSKlOVbLkG7z2Vl0s2J3/HqgOYnhLN0Sd8o6XPwNKvq8Jr6l22Y
TVM/yWB2fqB543xpyAIFQK/UoeZrB6NvtKJGilCyVh0kjfNxs2h7Azsk0V5YE3trEBRMgX
n8Pa/9EdLC2gmqJnZiOjZqrz8gNdm196+kEpDcmxZo9y+e7HqpPpEHHTNTKf+gCulrtiUr
cWQOFzb8tTN1wgjs4WpcNu9RTayHsMWt9RgXnui0vwLN2aCsJ4/7MqYJvSr57Q==
Authentication-Results: outgoing_mbo_mout; dkim=none;
spf=pass (outgoing_mbo_mout: domain of juri@HIDDEN designates
2001:67c:2050:b231:465::102 as permitted sender)
smtp.mailfrom=juri@HIDDEN
From: Juri Linkov <juri@HIDDEN>
In-Reply-To: <87ms4p8e61.fsf@HIDDEN>
Organization: LINKOV.NET
References: <87ms4p8e61.fsf@HIDDEN>
Date: Fri, 14 Nov 2025 09:20:20 +0200
Message-ID: <87pl9lqdvv.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain
X-Rspamd-Queue-Id: 4d77pn0mx1z9v3G
X-Spam-Score: -0.7 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)
close 79829 31.0.50
thanks
> This add a new section in the `;; Commentary:` header to explain how to
> migrate from the obsolete `hs-special-modes-alist` to the new API
> variables in the hope of guiding package maintainers to update their
> code appropriately.
Thanks, pushed.
Received: (at control) by debbugs.gnu.org; 14 Nov 2025 07:21:16 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Fri Nov 14 02:21:16 2025 Received: from localhost ([127.0.0.1]:59764 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1vJo7Q-0002QO-9d for submit <at> debbugs.gnu.org; Fri, 14 Nov 2025 02:21:16 -0500 Received: from mout-p-201.mailbox.org ([2001:67c:2050:0:465::201]:54026) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from <juri@HIDDEN>) id 1vJo7N-0002QD-Pu; Fri, 14 Nov 2025 02:21:14 -0500 Received: from smtp102.mailbox.org (smtp102.mailbox.org [IPv6:2001:67c:2050:b231:465::102]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by mout-p-201.mailbox.org (Postfix) with ESMTPS id 4d77pn0mx1z9v3G; Fri, 14 Nov 2025 08:21:05 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linkov.net; s=MBO0001; t=1763104865; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=v6BLyFgIedz9NcmquUbn/cvGCSmawinfK54UuoBmg20=; b=Wu+BqNzIpVjFvf0ovF6DODTngfg0I6MWUyvmmFxJw9QTrCHnHqZ/HdCz9b7oo7jJcAXgBl MHbMIunEYM7mgeQ/sCxgSKlOVbLkG7z2Vl0s2J3/HqgOYnhLN0Sd8o6XPwNKvq8Jr6l22Y TVM/yWB2fqB543xpyAIFQK/UoeZrB6NvtKJGilCyVh0kjfNxs2h7Azsk0V5YE3trEBRMgX n8Pa/9EdLC2gmqJnZiOjZqrz8gNdm196+kEpDcmxZo9y+e7HqpPpEHHTNTKf+gCulrtiUr cWQOFzb8tTN1wgjs4WpcNu9RTayHsMWt9RgXnui0vwLN2aCsJ4/7MqYJvSr57Q== Authentication-Results: outgoing_mbo_mout; dkim=none; spf=pass (outgoing_mbo_mout: domain of juri@HIDDEN designates 2001:67c:2050:b231:465::102 as permitted sender) smtp.mailfrom=juri@HIDDEN From: Juri Linkov <juri@HIDDEN> To: Elijah Gabe =?iso-8859-1?Q?P=E9rez?= <eg642616@HIDDEN> Subject: Re: bug#79829: [PATCH] hideshow: Update Header Commentary. In-Reply-To: <87ms4p8e61.fsf@HIDDEN> Organization: LINKOV.NET References: <87ms4p8e61.fsf@HIDDEN> Date: Fri, 14 Nov 2025 09:20:20 +0200 Message-ID: <87pl9lqdvv.fsf@HIDDEN> MIME-Version: 1.0 Content-Type: text/plain X-Rspamd-Queue-Id: 4d77pn0mx1z9v3G X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: control Cc: 79829 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.7 (-) close 79829 31.0.50 thanks > This add a new section in the `;; Commentary:` header to explain how to > migrate from the obsolete `hs-special-modes-alist` to the new API > variables in the hope of guiding package maintainers to update their > code appropriately. Thanks, pushed.
X-Loop: help-debbugs@HIDDEN
Subject: bug#79829: [PATCH] hideshow: Update Header Commentary.
Resent-From: Eli Zaretskii <eliz@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Fri, 14 Nov 2025 07:34:01 +0000
Resent-Message-ID: <handler.79829.B79829.176310558821622 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 79829
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: patch
To: Elijah Gabe =?UTF-8?Q?P=C3=A9rez?= <eg642616@HIDDEN>
Cc: 79829 <at> debbugs.gnu.org
Received: via spool by 79829-submit <at> debbugs.gnu.org id=B79829.176310558821622
(code B ref 79829); Fri, 14 Nov 2025 07:34:01 +0000
Received: (at 79829) by debbugs.gnu.org; 14 Nov 2025 07:33:08 +0000
Received: from localhost ([127.0.0.1]:59811 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1vJoIu-0005cg-Fj
for submit <at> debbugs.gnu.org; Fri, 14 Nov 2025 02:33:08 -0500
Received: from eggs.gnu.org ([2001:470:142:3::10]:42110)
by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
(Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1vJoIr-0005cH-Vl
for 79829 <at> debbugs.gnu.org; Fri, 14 Nov 2025 02:33:06 -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 <eliz@HIDDEN>)
id 1vJoIm-0007pC-Gf; Fri, 14 Nov 2025 02:33:00 -0500
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From:
Date; bh=ZG2ssGFZZ/GsGrmW3stLGU0cuIlOCi1PXz7Txw9YW+8=; b=GAjtkNhChP0vcf6boxPl
8XwHY4DTFaWfQ+TN9aALH/lcMns7qCXTweV19Z4e8M+OliuGp/UXyuCDQLGhvoLwhv8AeNBbwvn77
A8/IR7kQPG91mWQNlSXYlAY+MRhUvgKbMnbPYnOQ7FB8c3WSQdWoqkbL/wkOmKGxf342Unfg2AWyp
lNuBQKdoiTsBsz6YWlt3S0yEwVFeyJgV3IiwFJhmle13UbgT39bSWnv3I4SA7C0m/hkuNGjPY+SM3
7kBK9PjfMpk8+5Gs7w3P+uX+dMf4H0W1Zj/xcljqy5YjRoZrI57BrxgfYkzYwtMWL+8ZVtt7Ck7o5
lQ5pk/FUX/qn9A==;
Date: Fri, 14 Nov 2025 09:32:37 +0200
Message-Id: <86jyztqdbe.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
In-Reply-To: <87ms4p8e61.fsf@HIDDEN> (message from Elijah Gabe
=?UTF-8?Q?P=C3=A9rez?= on Thu, 13 Nov 2025 21:51:34 -0600)
References: <87ms4p8e61.fsf@HIDDEN>
MIME-version: 1.0
Content-type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
X-Spam-Score: -2.3 (--)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)
> From: Elijah Gabe Pérez <eg642616@HIDDEN>
> Date: Thu, 13 Nov 2025 21:51:34 -0600
>
> This add a new section in the `;; Commentary:` header to explain how to
> migrate from the obsolete `hs-special-modes-alist` to the new API
> variables in the hope of guiding package maintainers to update their
> code appropriately.
Thanks, additions to documentation are always welcome.
> +;; hs-special-modes-alist
> +;; '(MODE ; Not necessary, set the variables locally inside the
> +;; ; definition of the minor or major mode.
> +;; START | (START . MDATA) ::= `hs-block-start-regexp'
> +;; & `hs-block-start-mdata-select'
> +;; END ::= 'hs-block-end-regexp'
> +;; COMMENT-START ::= 'hs-c-start-regexp'
> +;; FORWARD-SEXP-FUNC ::= 'hs-forward-sexp-function'
> +;; ADJUST-BEG-FUNC ::= 'hs-adjust-block-beginning-function'
> +;; FIND-BLOCK-BEGINNING-FUNC ::= 'hs-find-block-beginning-function'
> +;; FIND-NEXT-BLOCK-FUNC ::= 'hs-find-next-block-function'
> +;; LOOKING-AT-BLOCK-START-P-FUNC ::= 'hs-looking-at-block-start-predicate')
This is unnecessarily technical, IMO. I would instead say something
more easily understood, like
Here's the list of elements in the (now deprecated)
`hs-special-modes-alist' and the corresponding buffer-local
variables which replace them:
Instead of this Use this
------------------------------------------------------------------------
START hs-block-start-regexp
(START . MDATA) hs-block-start-regexp and hs-block-start-mdata-select
END hs-block-end-regexp
COMMENT-START hs-c-start-regexp
etc., I hope I make my idea clear.
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997 nCipher Corporation Ltd,
1994-97 Ian Jackson.