From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: asm-mode patch to allow per-file comment character setting from file locals Date: Tue, 13 Jun 2006 20:56:00 +0300 Message-ID: References: <2E2BAEFF-FEAD-4616-87CD-3B77D2734256@alastairs-place.net> <19321565-3F93-4299-996F-8A2081C462AF@alastairs-place.net> <85bqsyfrhb.fsf@lola.goethe.zz> <853beaf0c4.fsf@lola.goethe.zz> <6C1D0482-9501-47E5-A79E-C40EF7B349A8@alastairs-place.net> Reply-To: Eli Zaretskii NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1150221393 28330 80.91.229.2 (13 Jun 2006 17:56:33 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 13 Jun 2006 17:56:33 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Jun 13 19:56:28 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1FqD7m-0003Rs-Cs for ged-emacs-devel@m.gmane.org; Tue, 13 Jun 2006 19:56:23 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FqD7l-0000L5-Uc for ged-emacs-devel@m.gmane.org; Tue, 13 Jun 2006 13:56:21 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1FqD7Z-0000Jd-8M for emacs-devel@gnu.org; Tue, 13 Jun 2006 13:56:09 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1FqD7Y-0000IN-Fy for emacs-devel@gnu.org; Tue, 13 Jun 2006 13:56:08 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FqD7Y-0000Hz-BS for emacs-devel@gnu.org; Tue, 13 Jun 2006 13:56:08 -0400 Original-Received: from [192.114.186.66] (helo=romy.inter.net.il) by monty-python.gnu.org with esmtp (Exim 4.52) id 1FqDGX-00030E-Ro for emacs-devel@gnu.org; Tue, 13 Jun 2006 14:05:26 -0400 Original-Received: from HOME-C4E4A596F7 (IGLD-80-230-34-238.inter.net.il [80.230.34.238]) by romy.inter.net.il (MOS 3.7.3-GA) with ESMTP id EWK52146 (AUTH halo1); Tue, 13 Jun 2006 20:56:01 +0300 (IDT) Original-To: Alastair Houghton In-reply-to: <6C1D0482-9501-47E5-A79E-C40EF7B349A8@alastairs-place.net> (message from Alastair Houghton on Tue, 13 Jun 2006 11:36:29 +0100) 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:55863 Archived-At: > From: Alastair Houghton > Date: Tue, 13 Jun 2006 11:36:29 +0100 > Cc: Stefan Monnier , emacs-devel@gnu.org > > >>> Files set from a file local variables block are made buffer-local, > >>> anyway. > >> > >> Which isn't stated in the Elisp info documentation (which I *did* > >> read), > > > > File local variable blocks are not documented in the Elisp manual at > > all. They are a user-level feature. > > *My* copy of the Elisp manual has a node entitled "File Local Variables". Which says, as its very first paragraph: This section describes the functions and variables that affect processing of file local variables. *Note (emacs)File variables, for basic information about file local variables. So this section describes the _functions_and_variables_ related to local vars _processing_, not the user-level information for which you are referred to the user's manual. And the user manual says, in the very first paragraph of the node referenced above: Visiting the file checks for local variable specifications; it automatically makes these variables local to the buffer, and sets them to the values specified in the file. Do we agree now that the information you were looking for is in the docs? If you think something in these texts is unclear or missing, please tell what that is, thanks. > If I'm wrong or have misunderstood something, or have missed > something in the docs, I don't mind being told that, but I also > don't see why I should put up with remarks I perceive as cheeky > given that I'm giving my time (and/or my employer's time) for free. > I don't think that's an unreasonable expectation. I think you should assume a possible misunderstanding, before you actually decide that a remark that sounds cheeky to you is indeed cheeky. Please don't forget that for most of the people here (including David and myself) English is not their first language. Fine nuances of English are not always clear to us. And you are not the only one who gives their time for free. All the rest of us, including, but not limited to, those with gnu.org addresses, are also volunteers, answering questions and helping maintain Emacs on their own free time. So the politeness and good manners are equally reasonably expected on both sides. > If it was not a gnu.org address, that's different because you don't > have any control over them and they don't represent the FSF. People with gnu.org address don't represent the FSF in any way, they just happen to have accounts on gnu.org machines because they do work for the GNU project. > I think the Elisp manual's node (the larger of the two nodes that > discuss file locals) should explicitly state that they are > automatically made buffer local. If it had done, I'd probably have > seen it. I'll leave it to Richard to decide whether this information should be actually added to the ELisp manual, but please understand that we cannot repeat in the ELisp manual everything that the user manual says, as it will inflate the ELisp manual too much. That's what cross-references are for--to say things in one place, then point there in several related ones. > The node in the Emacs manual is very short and looks like a menu > node with an introduction, rather than actual documentation per se. See the citation above: what you were looking for is right there before the menu, I think.