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: Thu, 21 Jan 2016 23:32:29 +0300 Message-ID: <56A1405D.7080706@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> <5694055E.6050201@yandex.ru> <83si1udcaz.fsf@gnu.org> <569D64AC.1060606@yandex.ru> <83powxbh6c.fsf@gnu.org> <569EB04F.800@yandex.ru> <8337tsc133.fsf@gnu.org> <569FF3C4.1030906@yandex.ru> <86mvry69l0.fsf@stephe-leake.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 1453408366 10267 80.91.229.3 (21 Jan 2016 20:32:46 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 21 Jan 2016 20:32:46 +0000 (UTC) Cc: Eli Zaretskii , emacs-devel@gnu.org To: Stephen Leake Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jan 21 21:32:45 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 1aMLuN-0006c5-7i for ged-emacs-devel@m.gmane.org; Thu, 21 Jan 2016 21:32:43 +0100 Original-Received: from localhost ([::1]:49648 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aMLuJ-0000E2-9x for ged-emacs-devel@m.gmane.org; Thu, 21 Jan 2016 15:32:39 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:47430) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aMLuF-0000DU-6M for emacs-devel@gnu.org; Thu, 21 Jan 2016 15:32:35 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aMLuC-0007yG-0Z for emacs-devel@gnu.org; Thu, 21 Jan 2016 15:32:35 -0500 Original-Received: from mail-lf0-x22c.google.com ([2a00:1450:4010:c07::22c]:33607) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aMLuB-0007yB-P9; Thu, 21 Jan 2016 15:32:31 -0500 Original-Received: by mail-lf0-x22c.google.com with SMTP id m198so34429384lfm.0; Thu, 21 Jan 2016 12:32:31 -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=pDg/MM/qBAF+8EuyHO9o/6SpBCjBFliQXTaNmL7T0Dg=; b=GVb/DYtfaW3JNyNCSwl5qpl0LrF19i5misOUjuxAIH/j+S/8w0uqQVlJPgI8KlF1hh GNMI6xb3L0lsgNOhSRezxLE6uJbb2crX2t6OhWv4+/LhKP1wDE7o6jV+1vrWO5AR1EXO vl3ww8pVNFvl0X9wUZBYaDclQMRSoAnnM2Ozh0yitoa3S6G1xo9BCz/jgzaydNQqTrh4 vbOvPYEg0m7WjMBFg5sSQezX+aRvQt30wcO/73dq5aC5rgYF68b6+91bgkBqw3GlLiIA K0rmRDXCNwqnki6xJ0RtNz7GfpbbO2DxGO62nQrooJ4/Crl/YIEhoLauwGC6g/y6zRtK BHDQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:sender:subject:to:references:cc:from:message-id :date:user-agent:mime-version:in-reply-to:content-type :content-transfer-encoding; bh=pDg/MM/qBAF+8EuyHO9o/6SpBCjBFliQXTaNmL7T0Dg=; b=jQ/GcFX2hJYljBbPZ+9okdy+LxdTDi2Qvx7caQw1bTXIjujiR44EUpu+mGaIrunbyR DGWa82t0GtgBd1UNAoO4S9kTivKvJ+ER8ylGAixKxIrnikqnEzFneOEs4YHOGWkUKAX8 FTvglrNBeCAyu+3iyPdqYwjGu/2eJCjg2++X9jMWduxmfoHS32mD4kj0D6giPsJLs5bQ WJUEvGCOZ63Bkz9/5CyIZ36X40Qd6yon9LJ94obWIL5wXt+GUgfvaMtHZK3uDujzdLAS 7J/zXtD/rxcqqbON25MIAmUKqgOnqHwpEZtbb/Vr9GBGWfcq8x8xZ7v/O661goLO7HJX HZAg== X-Gm-Message-State: ALoCoQnc8clpxFXa74H8bYqiV8lcrN1NfaCy7gDPTwii+r1A8AwNIds1t59yj92TMT9M8DAGPzpZi+x3FMDssxDFgEbW+oYl/Q== X-Received: by 10.25.24.195 with SMTP id 64mr13194710lfy.156.1453408350923; Thu, 21 Jan 2016 12:32:30 -0800 (PST) Original-Received: from [192.168.1.190] ([178.252.127.222]) by smtp.googlemail.com with ESMTPSA id o3sm431468lfb.39.2016.01.21.12.32.30 (version=TLSv1/SSLv3 cipher=OTHER); Thu, 21 Jan 2016 12:32:30 -0800 (PST) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:44.0) Gecko/20100101 Thunderbird/44.0 In-Reply-To: <86mvry69l0.fsf@stephe-leake.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2a00:1450:4010:c07::22c 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:198534 Archived-At: On 01/21/2016 10:01 PM, Stephen Leake wrote: > I think we should move more towards relying on "project" commands for > operations on sets of files; xref is then mostly a tool that project > commands use. > > Another way to look at this is that any xref backend should also provide > a project backend, so the two sets of commands always operate on the > same set of files. I would state it like this: most projects that provide an xref backend, should provide a project backend as well, or at least set project-vc-external-roots-function. The reverse is probably also true. The main exceptions are simplistic backends, for languages without strong tooling. I thought about having xref.el depend on project.el (by, say, passing the current project to xref-backend-functions), but I'm less confident in the user-facing parts of project.el than in xref commands. So it would make a more-stable facility depend on a less-stable one, unfortunately.