From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package Date: Mon, 11 Jan 2016 22:41:18 +0300 Message-ID: <5694055E.6050201@yandex.ru> References: <20160109191428.26341.44105@vcs.savannah.gnu.org> <5691C9D2.7080905@yandex.ru> <83egdpmo1j.fsf@gnu.org> <56929D6F.2050508@yandex.ru> <834melmfa4.fsf@gnu.org> <5692B1E0.8010100@yandex.ru> <831t9pma4e.fsf@gnu.org> <5693FDFA.2070607@yandex.ru> <83ziwbkj5l.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1452541309 4358 80.91.229.3 (11 Jan 2016 19:41:49 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 11 Jan 2016 19:41:49 +0000 (UTC) Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jan 11 20:41:44 2016 Return-path: Envelope-to: ged-emacs-devel@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 1aIiLV-0004Yg-2m for ged-emacs-devel@m.gmane.org; Mon, 11 Jan 2016 20:41:41 +0100 Original-Received: from localhost ([::1]:56579 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aIiLU-0007AH-GM for ged-emacs-devel@m.gmane.org; Mon, 11 Jan 2016 14:41:40 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:41414) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aIiLF-0007AB-2d for emacs-devel@gnu.org; Mon, 11 Jan 2016 14:41:28 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aIiLB-0007Ko-25 for emacs-devel@gnu.org; Mon, 11 Jan 2016 14:41:25 -0500 Original-Received: from mail-lb0-x22a.google.com ([2a00:1450:4010:c04::22a]:34628) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aIiLA-0007Kj-QE; Mon, 11 Jan 2016 14:41:20 -0500 Original-Received: by mail-lb0-x22a.google.com with SMTP id cl12so42906815lbc.1; Mon, 11 Jan 2016 11:41:20 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:subject:to:references:cc:from:message-id:date:user-agent :mime-version:in-reply-to:content-type:content-transfer-encoding; bh=GJ4bJyTouOD8TU1B4QC05EPOrDOwuemHkz46JL2/8Cw=; b=nf8qGXnS8/5QM/HCJpXVYSD3J1C6DnX7AU/7puAYJ52GCLpYd5SAzgzMZO4ZuosCuh eaXkOYIBrchHr3bCC//0doTCLnIyKf2ph+/QJu8zpOavU36xC3Z/loIdvALXu/mhr08f 01u9Cn/vwSrbmjXzkgfX9a/RX+rl78kG5cL+5OY1YS6BWDg4A1z2jYrzF5BWrR2bRzFE l4WYiZh0knHQXopHklk1DwzSZXDcSs+qf5ipXZuxyTC4J/bsR0EB9OVi7CluPIKyuR/8 6oMgQsDxaZBIIaKJ2JdN9tlOQcbblLV07Kq9iz+IDoJzYXqten7gKClvdaRr/FHbnk2k +/DA== X-Received: by 10.112.46.35 with SMTP id s3mr26651844lbm.115.1452541280034; Mon, 11 Jan 2016 11:41:20 -0800 (PST) Original-Received: from [192.168.1.190] ([178.252.127.222]) by smtp.googlemail.com with ESMTPSA id e130sm12616386lfe.9.2016.01.11.11.41.18 (version=TLSv1/SSLv3 cipher=OTHER); Mon, 11 Jan 2016 11:41:18 -0800 (PST) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:43.0) Gecko/20100101 Thunderbird/43.0 In-Reply-To: <83ziwbkj5l.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2a00:1450:4010:c04::22a X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:198044 Archived-At: On 01/11/2016 10:31 PM, Eli Zaretskii wrote: > Doesn't sound right to me. This is an important command, and a good > addition to the Emacs features. Leaving it out of the manual just > because we cannot find a good place for it, or a good way to squeeze > it into the chapter, sounds... unwise. Also because it relies on a very scarcely documented facility, which comes with its own gotchas. > ... xref-find-refrerences was the least of my problems when I worked > on this. It's just one command. The "external tools" are only used in it, however. And my main complaint is against calling them "backends". > What I needed is a coherent framework that would bring some order to > this group of commands and features. You might want to make the requirements more specific. > Thanks, that's what I need. If the concepts and the overall idea are > good, the details will fall in place by themselves. So, um, what exactly is missing in my previous response? I feel like I've answered all questions. Aside from writing the "structure of the section", that is, because that sounds about as easy as rewriting the manual myself.