From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#18281: 24.4.50; doc of `customize-apropos*' Date: Sat, 16 Aug 2014 11:11:05 -0700 (PDT) Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1408212759 32181 80.91.229.3 (16 Aug 2014 18:12:39 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 16 Aug 2014 18:12:39 +0000 (UTC) To: 18281@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Aug 16 20:12:28 2014 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1XIiSp-0002YY-NV for geb-bug-gnu-emacs@m.gmane.org; Sat, 16 Aug 2014 20:12:27 +0200 Original-Received: from localhost ([::1]:36241 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XIiSp-0006WO-9O for geb-bug-gnu-emacs@m.gmane.org; Sat, 16 Aug 2014 14:12:27 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55275) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XIiSb-0006SE-CC for bug-gnu-emacs@gnu.org; Sat, 16 Aug 2014 14:12:23 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XIiSR-0007ZO-1r for bug-gnu-emacs@gnu.org; Sat, 16 Aug 2014 14:12:13 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:37857) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XIiSQ-0007ZK-Ra for bug-gnu-emacs@gnu.org; Sat, 16 Aug 2014 14:12:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1XIiSQ-0006ce-7Z for bug-gnu-emacs@gnu.org; Sat, 16 Aug 2014 14:12:02 -0400 X-Loop: help-debbugs@gnu.org 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: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.140821270525432 (code B ref -1); Sat, 16 Aug 2014 18:12:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 16 Aug 2014 18:11:45 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 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.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:92490 Archived-At: 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''