From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#22692: docstring for xref-find-definitions Date: Sat, 27 Feb 2016 14:43:04 +0200 Message-ID: <83twkub9yf.fsf@gnu.org> References: <20283.1455584523@allegro.localdomain> <673.1455767121@allegro.localdomain> <83ziuyt122.fsf@gnu.org> <56C7123A.6040408@yandex.ru> <83vb5kr9xt.fsf@gnu.org> <56C7C042.2010907@yandex.ru> <83wppzpyqb.fsf@gnu.org> <87k2lwz3j6.fsf@mail.linkov.net> <56CBA940.2080907@yandex.ru> <8360xacul0.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 8bit X-Trace: ger.gmane.org 1456577065 10942 80.91.229.3 (27 Feb 2016 12:44:25 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 27 Feb 2016 12:44:25 +0000 (UTC) Cc: 22692@debbugs.gnu.org, juri@linkov.net, m.kupfer@acm.org To: Dmitry Gutov Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Feb 27 13:44:11 2016 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 1aZeEE-0003E1-VE for geb-bug-gnu-emacs@m.gmane.org; Sat, 27 Feb 2016 13:44:11 +0100 Original-Received: from localhost ([::1]:54587 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aZeEE-0003TF-Al for geb-bug-gnu-emacs@m.gmane.org; Sat, 27 Feb 2016 07:44:10 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54617) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aZeEA-0003SZ-Jq for bug-gnu-emacs@gnu.org; Sat, 27 Feb 2016 07:44:07 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aZeE6-0004dY-Hk for bug-gnu-emacs@gnu.org; Sat, 27 Feb 2016 07:44:06 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:51109) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aZeE6-0004dU-Eq for bug-gnu-emacs@gnu.org; Sat, 27 Feb 2016 07:44:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84) (envelope-from ) id 1aZeE6-000312-AM for bug-gnu-emacs@gnu.org; Sat, 27 Feb 2016 07:44:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 27 Feb 2016 12:44:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 22692 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 22692-submit@debbugs.gnu.org id=B22692.145657702311560 (code B ref 22692); Sat, 27 Feb 2016 12:44:02 +0000 Original-Received: (at 22692) by debbugs.gnu.org; 27 Feb 2016 12:43:43 +0000 Original-Received: from localhost ([127.0.0.1]:48236 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZeDk-00030L-CL for submit@debbugs.gnu.org; Sat, 27 Feb 2016 07:43:43 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:35341) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZeDi-000308-MF for 22692@debbugs.gnu.org; Sat, 27 Feb 2016 07:43:38 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aZeDc-0004b0-UH for 22692@debbugs.gnu.org; Sat, 27 Feb 2016 07:43:33 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:44535) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aZeDU-0004a3-6o; Sat, 27 Feb 2016 07:43:24 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4956 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aZeDT-00085H-CB; Sat, 27 Feb 2016 07:43:23 -0500 In-reply-to: (message from Dmitry Gutov on Sat, 27 Feb 2016 14:35:20 +0200) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.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:113947 Archived-At: > Cc: 22692@debbugs.gnu.org, juri@linkov.net, m.kupfer@acm.org > From: Dmitry Gutov > Date: Sat, 27 Feb 2016 14:35:20 +0200 > > On 02/27/2016 12:32 PM, Eli Zaretskii wrote: > > > The current doc string looks OK to me: it describes the behavior very > > well. > > Great. I believe the only thing holding this bug is making the choice > about the "valid" in the manual. You mean, whether to remove the "valid" part from the 2nd sentence reproduced below? ‘M-.’ (‘xref-find-definitions’) shows the definitions of the identifier at point. With a prefix argument, or if there’s no valid identifier at point, it prompts for the identifier. ^^^^^ I'd say let's remove it.