From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stephen Leake Newsgroups: gmane.emacs.devel Subject: Re: project.el semantics Date: Tue, 10 Nov 2015 17:41:59 -0600 Message-ID: <86h9kt777c.fsf@stephe-leake.org> References: <86pp1j4ejm.fsf@stephe-leake.org> <86bnd21q0r.fsf@stephe-leake.org> <55F97EA2.9000408@yandex.ru> <86mvwmz58h.fsf@stephe-leake.org> <55F9A5F8.1030505@yandex.ru> <86pp1ixem2.fsf@stephe-leake.org> <55FAFC36.5010506@yandex.ru> <86twqrww0u.fsf_-_@stephe-leake.org> <563EA9B9.5080404@yandex.ru> <86vb9dufs0.fsf@stephe-leake.org> <563F4915.1080008@yandex.ru> <867flrbksb.fsf@stephe-leake.org> <56409F2D.9060300@yandex.ru> <5641412B.8080106@yandex.ru> <564145FC.5020905@yandex.ru> <5641634C.9000409@yandex.ru> <5641CCCB.6050206@yandex.ru> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1447198962 31256 80.91.229.3 (10 Nov 2015 23:42:42 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 10 Nov 2015 23:42:42 +0000 (UTC) Cc: emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Nov 11 00:42:32 2015 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 1ZwIYT-0000l1-PU for ged-emacs-devel@m.gmane.org; Wed, 11 Nov 2015 00:42:26 +0100 Original-Received: from localhost ([::1]:36188 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZwIYP-0001dk-03 for ged-emacs-devel@m.gmane.org; Tue, 10 Nov 2015 18:42:21 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52931) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZwIYK-0001d9-OZ for emacs-devel@gnu.org; Tue, 10 Nov 2015 18:42:17 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZwIYF-0000mQ-Ke for emacs-devel@gnu.org; Tue, 10 Nov 2015 18:42:16 -0500 Original-Received: from gproxy6-pub.mail.unifiedlayer.com ([67.222.39.168]:34322) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1ZwIYF-0000m7-DD for emacs-devel@gnu.org; Tue, 10 Nov 2015 18:42:11 -0500 Original-Received: (qmail 4503 invoked by uid 0); 10 Nov 2015 23:42:07 -0000 Original-Received: from unknown (HELO cmgw4) (10.0.90.85) by gproxy6.mail.unifiedlayer.com with SMTP; 10 Nov 2015 23:42:06 -0000 Original-Received: from host114.hostmonster.com ([74.220.207.114]) by cmgw4 with id fzi31r0132UdiVW01zi62i; Tue, 10 Nov 2015 16:42:06 -0700 X-Authority-Analysis: v=2.1 cv=IekUBwaa c=1 sm=1 tr=0 a=CQdxDb2CKd3SRg4I0/XZPQ==:117 a=CQdxDb2CKd3SRg4I0/XZPQ==:17 a=DsvgjBjRAAAA:8 a=f5113yIGAAAA:8 a=9i_RQKNPAAAA:8 a=hEr_IkYJT6EA:10 a=x_XPkuGwIRMA:10 a=qtqOOiqGOCEA:10 a=vaJtXVxTAAAA:8 a=QM0iSkER7wcViiG_RHAA:9 Original-Received: from [76.218.37.33] (port=53125 helo=TAKVER2) by host114.hostmonster.com with esmtpa (Exim 4.84) (envelope-from ) id 1ZwIY7-0008Jx-NU; Tue, 10 Nov 2015 16:42:03 -0700 In-Reply-To: <5641CCCB.6050206@yandex.ru> (Dmitry Gutov's message of "Tue, 10 Nov 2015 12:54:03 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.5 (windows-nt) X-Identified-User: {2442:host114.hostmonster.com:stephele:stephe-leake.org} {sentby:smtp auth 76.218.37.33 authed with stephen_leake@stephe-leake.org} X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 67.222.39.168 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:194002 Archived-At: Dmitry Gutov writes: > On 11/10/2015 08:00 AM, John Wiegley wrote: > >> I guess I'm just asking exactly what you'd like to discuss about the code. If >> you want a review, then I know what's being asked for. Otherwise, is there an >> open question that needs my comment? It seems to be developing along fairly >> well. > > You can see we disagree about some things with Stephen, from the > discussion. These issues relate to method names, docstrings and the > FIXME that's in the file. More precisely, the only hot issue is the semantics of "package-library-roots" and "package-roots". They provide the list of directories that are related to the user's project in some way (contain code, or documentation, or dependencies (other packages or libraries)). One use for these is to provide the search path for grep, or for locate-file (with some glue code). I don't understand why we have both; one would be sufficient. I have yet to see an actual use case that requires both. Since we have both, I don't understand what directories go in one vs the other. The rationale seems to change each time I propose a different use case. One way to move forward would be to start a manual section for package.el, and capture use cases in it, so we could refer to them. Or capture use cases in a design document, if we don't want them in the user manual. -- -- Stephe