From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lars Magne Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#4257: Documentation for where-is-preferred-modifier is obscure Date: Tue, 12 Jul 2011 23:13:30 +0200 Message-ID: References: <20090825162444.GA8178@muc.de> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1310507252 27278 80.91.229.12 (12 Jul 2011 21:47:32 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Tue, 12 Jul 2011 21:47:32 +0000 (UTC) Cc: 4257@debbugs.gnu.org To: Alan Mackenzie Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Jul 12 23:47:27 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Qgknf-0004Gj-Kt for geb-bug-gnu-emacs@m.gmane.org; Tue, 12 Jul 2011 23:47:27 +0200 Original-Received: from localhost ([::1]:42001 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qgkne-0005kI-GF for geb-bug-gnu-emacs@m.gmane.org; Tue, 12 Jul 2011 17:47:26 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:39228) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QgkIO-0006Nr-94 for bug-gnu-emacs@gnu.org; Tue, 12 Jul 2011 17:15:12 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QgkIJ-0004sz-MW for bug-gnu-emacs@gnu.org; Tue, 12 Jul 2011 17:15:07 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:56635) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QgkIJ-0004sg-BW for bug-gnu-emacs@gnu.org; Tue, 12 Jul 2011 17:15:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1QgkII-0003Ud-9X; Tue, 12 Jul 2011 17:15:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Lars Magne Ingebrigtsen Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 12 Jul 2011 21:15:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 4257 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed Original-Received: via spool by 4257-submit@debbugs.gnu.org id=B4257.131050524313345 (code B ref 4257); Tue, 12 Jul 2011 21:15:02 +0000 Original-Received: (at 4257) by debbugs.gnu.org; 12 Jul 2011 21:14:03 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QgkHH-0003SP-Cb for submit@debbugs.gnu.org; Tue, 12 Jul 2011 17:14:03 -0400 Original-Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QgkHB-0003S8-A6 for 4257@debbugs.gnu.org; Tue, 12 Jul 2011 17:13:57 -0400 Original-Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1QgkGy-0005zH-2O; Tue, 12 Jul 2011 23:13:40 +0200 In-Reply-To: <20090825162444.GA8178@muc.de> (Alan Mackenzie's message of "Tue, 25 Aug 2009 16:24:44 +0000") User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) X-Now-Playing: Peter Gabriel's _Plays Live (1)_: "Family Snapshot" X-Hashcash: 1:23:110712:4257@debbugs.gnu.org::6bkIHEswFMs5BKNF:00000000000000000000000000000000000000000YEAM X-Hashcash: 1:23:110712:acm@muc.de::uNi4pKa1P+4u1Xik:0000000uI5W X-MailScanner-ID: 1QgkGy-0005zH-2O MailScanner-NULL-Check: 1311110020.22344@kh2ZSNB5ni+3PAqUF5euwg X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Tue, 12 Jul 2011 17:15:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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:48793 Archived-At: Alan Mackenzie writes: > The doc string for `where-is-preferred-modifier' is > > where-is-preferred-modifier is a variable defined in `C source code'. > Its value is nil > > Documentation: > Preferred modifier to use for `where-is'. > When a single binding is requested, `where-is' will return one that > uses this modifier if possible. If nil, or if no such binding exists, > bindings using keys without modifiers (or only with meta) will be > preferred. > > . This leaves the user having to guess what a "modifier for `where-is'" > is. This is bad. By "modifier" they mean a modifier key. I've now clarified this in the doc string in Emacs 24. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/