From unknown Mon Jun 23 11:27:06 2025 X-Loop: help-debbugs@gnu.org Subject: bug#18281: 24.4.50; doc of `customize-apropos*' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 16 Aug 2014 18:12:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 18281 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 18281@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.140821270525432 (code B ref -1); Sat, 16 Aug 2014 18:12:02 +0000 Received: (at submit) by debbugs.gnu.org; 16 Aug 2014 18:11:45 +0000 Received: from localhost ([127.0.0.1]:44800 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XIiS9-0006c7-03 for submit@debbugs.gnu.org; Sat, 16 Aug 2014 14:11:45 -0400 Received: from eggs.gnu.org ([208.118.235.92]:53472) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XIiS5-0006bt-Ss for submit@debbugs.gnu.org; Sat, 16 Aug 2014 14:11:43 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XIiRq-0007Vm-90 for submit@debbugs.gnu.org; Sat, 16 Aug 2014 14:11:36 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:38719) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XIiRq-0007Vi-6E for submit@debbugs.gnu.org; Sat, 16 Aug 2014 14:11:26 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:55194) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XIiRh-0006Nb-AS for bug-gnu-emacs@gnu.org; Sat, 16 Aug 2014 14:11:26 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XIiRY-0007VH-Ey for bug-gnu-emacs@gnu.org; Sat, 16 Aug 2014 14:11:17 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:35765) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XIiRY-0007VD-8d for bug-gnu-emacs@gnu.org; Sat, 16 Aug 2014 14:11:08 -0400 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id s7GIB6b7010894 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 16 Aug 2014 18:11:07 GMT Received: from aserz7021.oracle.com (aserz7021.oracle.com [141.146.126.230]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s7GIB6Yw009223 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sat, 16 Aug 2014 18:11:06 GMT Received: from abhmp0013.oracle.com (abhmp0013.oracle.com [141.146.116.19]) by aserz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s7GIB55E015735 for ; Sat, 16 Aug 2014 18:11:05 GMT MIME-Version: 1.0 Message-ID: Date: Sat, 16 Aug 2014 11:11:05 -0700 (PDT) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 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: -4.0 (----) This applies to `customize-apropos' and its related commands. 1. The doc is not clear wrt what happens when you provide a list of "words" as the input, instead of a regexp. It is very easily to misunderstand the inadequate description as saying that the words you enter are matched, not together sequentially against a single customize target, but individually against multiple customize targets. This is all the more true, since this command has as its aim to match any number of targets: it constructs a Customize buffer for all targets matched. Both the doc at (emacs) `Specific Customization' and the doc string are defective (misleading and incomplete) in this regard. The doc should say something like this: If you provide a list of words then all possible pairs of the words are matched together, in both orders, against the name of each Customize object of TYPE. That is, the object name must contain both words as sbubstrings. 2. The doc should also say that in this context a "word" is any string of characters that does not contain special regexp constructs. That is, the string is the same as `regexp-quote' applied to the string. This lets users know that the "words" can contain more than word-constituent chars. In GNU Emacs 24.4.50.1 (i686-pc-mingw32) of 2014-06-28 on ODIEONE Bzr revision: 117431 rgm@gnu.org-20140628015517-eku6hj8mpgcvfnso Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D/c/Devel/emacs/snapshot/trunk --enable-checking=3Dyes,glyphs 'CFLAGS=3D-O0 -g3' LDFLAGS=3D-Lc:/Devel/emacs/lib 'CPPFLAGS=3D-DGC_MCHECK=3D1 -Ic:/Devel/emacs/include'' From unknown Mon Jun 23 11:27:06 2025 X-Loop: help-debbugs@gnu.org Subject: bug#18281: 24.4.50; doc of `customize-apropos*' Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 03 Aug 2019 18:54:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 18281 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 18281@debbugs.gnu.org Received: via spool by 18281-submit@debbugs.gnu.org id=B18281.156485842711963 (code B ref 18281); Sat, 03 Aug 2019 18:54:01 +0000 Received: (at 18281) by debbugs.gnu.org; 3 Aug 2019 18:53:47 +0000 Received: from localhost ([127.0.0.1]:59918 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htzA2-00036t-Jv for submit@debbugs.gnu.org; Sat, 03 Aug 2019 14:53:46 -0400 Received: from quimby.gnus.org ([80.91.231.51]:51838) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htzA0-00036d-8g for 18281@debbugs.gnu.org; Sat, 03 Aug 2019 14:53:44 -0400 Received: from 77.18.62.220.tmi.telenormobil.no ([77.18.62.220] helo=sandy) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1htz9w-00073g-3e; Sat, 03 Aug 2019 20:53:42 +0200 From: Lars Ingebrigtsen References: Date: Sat, 03 Aug 2019 20:53:39 +0200 In-Reply-To: (Drew Adams's message of "Sat, 16 Aug 2014 11:11:05 -0700 (PDT)") Message-ID: <871ry2f5cc.fsf@mouse.gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.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 @@CONTACT_ADDRESS@@ for details. Content preview: Drew Adams writes: > This applies to `customize-apropos' and its related commands. > > 1. The doc is not clear wrt what happens when you provide a list of > "words" as the input, instead of a regexp. > > It is very easi [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP 0.0 TVD_RCVD_IP Message was received from an IP address -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) 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.0 (-) Drew Adams writes: > This applies to `customize-apropos' and its related commands. > > 1. The doc is not clear wrt what happens when you provide a list of > "words" as the input, instead of a regexp. > > It is very easily to misunderstand the inadequate description as saying > that the words you enter are matched, not together sequentially against > a single customize target, but individually against multiple customize > targets. > > This is all the more true, since this command has as its aim to match > any number of targets: it constructs a Customize buffer for all targets > matched. > > Both the doc at (emacs) `Specific Customization' and the doc string are > defective (misleading and incomplete) in this regard. > > The doc should say something like this: > > If you provide a list of words then all possible pairs of the words are > matched together, in both orders, against the name of each Customize > object of TYPE. That is, the object name must contain both words as > sbubstrings. I don't know what the doc string said at the time you filed the report (it would be helpful if you included that in your reports), but currently it says: --- Customize loaded options, faces and groups matching PATTERN. PATTERN can be a word, a list of words (separated by spaces), or a regexp (using some regexp special characters). If it is a word, search for matches for that word as a substring. If it is a list of words, search for matches for any two (or more) of those words. --- That seems quite clear to me, and I'm closing this bug report. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Sat Aug 03 14:53:53 2019 Received: (at control) by debbugs.gnu.org; 3 Aug 2019 18:53:53 +0000 Received: from localhost ([127.0.0.1]:59921 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htzA8-00037N-Vk for submit@debbugs.gnu.org; Sat, 03 Aug 2019 14:53:53 -0400 Received: from quimby.gnus.org ([80.91.231.51]:51852) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htzA6-00037A-Ry for control@debbugs.gnu.org; Sat, 03 Aug 2019 14:53:51 -0400 Received: from 77.18.62.220.tmi.telenormobil.no ([77.18.62.220] helo=sandy) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1htzA4-00073n-5s for control@debbugs.gnu.org; Sat, 03 Aug 2019 20:53:50 +0200 Date: Sat, 03 Aug 2019 20:53:47 +0200 Message-Id: <87zhkqdqro.fsf@mouse.gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #18281 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.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 @@CONTACT_ADDRESS@@ for details. Content preview: close 18281 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP 0.0 TVD_RCVD_IP Message was received from an IP address -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control 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.0 (-) close 18281 quit From unknown Mon Jun 23 11:27:06 2025 X-Loop: help-debbugs@gnu.org Subject: bug#18281: 24.4.50; doc of `customize-apropos*' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 03 Aug 2019 21:12:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 18281 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Lars Ingebrigtsen Cc: 18281@debbugs.gnu.org Received: via spool by 18281-submit@debbugs.gnu.org id=B18281.156486669830378 (code B ref 18281); Sat, 03 Aug 2019 21:12:01 +0000 Received: (at 18281) by debbugs.gnu.org; 3 Aug 2019 21:11:38 +0000 Received: from localhost ([127.0.0.1]:60125 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hu1JR-0007tt-Ss for submit@debbugs.gnu.org; Sat, 03 Aug 2019 17:11:38 -0400 Received: from userp2120.oracle.com ([156.151.31.85]:34978) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hu1JQ-0007th-4y for 18281@debbugs.gnu.org; Sat, 03 Aug 2019 17:11:36 -0400 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x73L9s0v012228; Sat, 3 Aug 2019 21:11:30 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=ulpQ+N1/umk6+Jacdmc8s9Zw9ndyI1ak9Pv29hJo5ZQ=; b=MX3WhqJkn/NL9liLmfE/2xZ5eP0AzzMAnfJU9wbLG7SgDSIS4a+4VchBVutKr/UWlGwA U1Jlsvr4zApQjc296Ya036I0Mt8pBbJeQRYiEo76lpowf5u3v9lSEIz9D/BfukUf7TH8 KUg6oDmCVEUNC2bawzzVKt6oWP0fZRIuB9bgafuirE/+euHr0ziDemFQdCy7sXevEAmU AETHx7MAsBD3lfJjzJg2jtGk0htNXIuV9iWOMXkJ3WDgDJSragY0fnyPR+q4tmyoL8nI Sw8C5k6/WkVMDaqy/lNKJKH5jNOAuBKaDiOOP8/JVIwHPINl3IU8vjEd3SSIX1hVZ9DF XQ== Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by userp2120.oracle.com with ESMTP id 2u52wqsvq7-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 03 Aug 2019 21:11:30 +0000 Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x73L7SXI005513; Sat, 3 Aug 2019 21:11:29 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserp3020.oracle.com with ESMTP id 2u523275f1-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 03 Aug 2019 21:11:29 +0000 Received: from abhmp0017.oracle.com (abhmp0017.oracle.com [141.146.116.23]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id x73LBRac010754; Sat, 3 Aug 2019 21:11:28 GMT MIME-Version: 1.0 Message-ID: <0d357ba7-59d2-41ea-843f-88d1f2217d13@default> Date: Sat, 3 Aug 2019 14:11:27 -0700 (PDT) From: Drew Adams References: <871ry2f5cc.fsf@mouse.gnus.org> In-Reply-To: <871ry2f5cc.fsf@mouse.gnus.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4873.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9338 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1906280000 definitions=main-1908030253 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9338 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1906280000 definitions=main-1908030253 X-Spam-Score: -2.3 (--) 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 (---) > > If you provide a list of words then all possible pairs of the words > > are matched together, in both orders, against the name of each=20 > > Customize object of TYPE. That is, the object name must contain > > both words as substrings. >=20 > I don't know what the doc string said at the time you filed the report > (it would be helpful if you included that in your reports), The build reported is the one the report is about. (That's why build info is included.) And yes, that was 5 years ago... A guess is that it said the same thing that is said in Emacs 23.4 - just this: customize-apropos is an interactive autoloaded Lisp function in `cus-edit.el'. It is bound to . (customize-apropos REGEXP &optional ALL) Customize all loaded options, faces and groups matching REGEXP. If ALL is `options', include only options. If ALL is `faces', include only faces. If ALL is `groups', include only groups. If ALL is t (interactively, with prefix arg), include variables that are not customizable options, as well as faces and groups (but we recommend using `apropos-variable' instead). > but currently it says: >=20 > Customize loaded options, faces and groups matching PATTERN. > PATTERN can be a word, a list of words (separated by spaces), > or a regexp (using some regexp special characters). If it is a word, > search for matches for that word as a substring. If it is a list of > words, search for matches for any two (or more) of those words. Good.