From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.devel Subject: Re: files.el: Patch to make project-settings optional/customizable Date: Thu, 20 Nov 2008 00:45:05 +0200 Organization: JURTA Message-ID: <87iqqjcp3j.fsf@jurta.org> References: <5f0ff9220811130629t505badf9kb1bcc380df89a08f@mail.gmail.com> <200811131619.mADGJukm010206@mothra.ics.uci.edu> <87prkz4kgh.fsf@cyd.mit.edu> <200811131728.mADHSH2M010654@mothra.ics.uci.edu> <871vxflbxb.fsf@cyd.mit.edu> <200811131848.mADImPMQ011099@mothra.ics.uci.edu> <200811181636.mAIGa9Lx000571@mothra.ics.uci.edu> <87prks6693.fsf@jurta.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1227135373 32135 80.91.229.12 (19 Nov 2008 22:56:13 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 19 Nov 2008 22:56:13 +0000 (UTC) Cc: Tom Tromey , "T.V. Raman" , emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Nov 19 23:57:14 2008 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1L2vxf-0002oz-U6 for ged-emacs-devel@m.gmane.org; Wed, 19 Nov 2008 23:55:52 +0100 Original-Received: from localhost ([127.0.0.1]:53442 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L2vwX-0007mE-9E for ged-emacs-devel@m.gmane.org; Wed, 19 Nov 2008 17:54:41 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1L2vwS-0007m4-Em for emacs-devel@gnu.org; Wed, 19 Nov 2008 17:54:36 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1L2vwR-0007lo-JQ for emacs-devel@gnu.org; Wed, 19 Nov 2008 17:54:36 -0500 Original-Received: from [199.232.76.173] (port=41015 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L2vwR-0007ll-GB for emacs-devel@gnu.org; Wed, 19 Nov 2008 17:54:35 -0500 Original-Received: from relay03.kiev.sovam.com ([62.64.120.201]:57535) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1L2vwR-00043z-ES for emacs-devel@gnu.org; Wed, 19 Nov 2008 17:54:35 -0500 Original-Received: from [83.170.232.243] (helo=smtp.svitonline.com) by relay03.kiev.sovam.com with esmtp (Exim 4.67) (envelope-from ) id 1L2vwM-0000rp-Pe; Thu, 20 Nov 2008 00:54:31 +0200 In-Reply-To: (Stefan Monnier's message of "Tue, 18 Nov 2008 21:01:37 -0500") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (x86_64-pc-linux-gnu) X-Scanner-Signature: e04e44772e0ad72f7751591e8aa1bd99 X-DrWeb-checked: yes X-SpamTest-Envelope-From: juri@jurta.org X-SpamTest-Group-ID: 00000000 X-SpamTest-Header: Trusted X-SpamTest-Info: Profiles 5784 [Nov 20 2008] X-SpamTest-Info: {received from trusted relay: common white list} X-SpamTest-Info: {HEADERS: header Content-Type found without required header Content-Transfer-Encoding} X-SpamTest-Method: white ip list X-SpamTest-Rate: 10 X-SpamTest-Status: Trusted X-SpamTest-Status-Extended: trusted X-SpamTest-Version: SMTP-Filter Version 3.0.0 [0278], KAS30/Release X-detected-operating-system: by monty-python.gnu.org: Genre and OS details not recognized. X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:105834 Archived-At: > As for its name: we're not wedded to it, AFAIK. It was the result of > a pretty long thread, so it's not going to be easy to find something > else that's more or less consensual. But for starters, if people could > argue about why it's "ugly", maybe we can tweak it. Looking at the current documentation and function names we can see a wide diversity of used terms: directory local variables dir-settings variable settings project-bindings project settings directory-project project classes (that have nothing to do with OOP!) All this is very confusing. In http://thread.gmane.org/gmane.emacs.devel/78366/focus=78378 Richard said that the term "project" is misleading and asked to rename "project" in the documentation and the function names. But for unknown reasons that was not really done for the function names. Also in http://thread.gmane.org/gmane.emacs.devel/78366/focus=78404 Stefan asked to rename "project" to "directory variables" or "directory-local variables" that was eventually renamed in the manual but not in code. And even Tom tended to think that "project" is a misnomer ;) http://thread.gmane.org/gmane.emacs.devel/77852/focus=78054 So let's get rid of "project" in the function names and use the common prefix dir-local-variables by analogy with file-local-variables. This also suggest renaming "bindings" and "settings" to "variables". Since the only term the user have to remember will be "directory-local variables" this suggests using a file name derived from it. Since the file name should be short a good candidate is ".dir-locals.el". It is similar to the file name used by the good package http://www.loveshack.ukfsn.org/emacs/dir-locals.el that is now obsoleted after the same functionality is implemented now in files.el. But dir-locals.el uses a different file name, so ".dir-locals.el" has no conflict with this package and can be considered as inheriting a good file name from it. I've also checked in long threads http://thread.gmane.org/gmane.emacs.devel/74257 http://thread.gmane.org/gmane.emacs.devel/77852 http://thread.gmane.org/gmane.emacs.devel/78366 http://thread.gmane.org/gmane.emacs.devel/97396 that the file name ".dir-locals.el" doesn't contradict the reached consensus, because 1. it is still a dotfile with a leading . in its name, 2. the file name ends with `.el', 3. there is no `emacs' in the name. -- Juri Linkov http://www.jurta.org/emacs/