unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: Aidan Kehoe <kehoea@parhasard.net>
Cc: emacs-devel@gnu.org
Subject: Re: Activate an input-method from file-local variables?
Date: Sun, 16 Jul 2006 13:59:39 +0200	[thread overview]
Message-ID: <17594.10795.173314.750640@parhasard.net> (raw)
In-Reply-To: <E1G204D-00026O-6W@fencepost.gnu.org>


 Ar an séú lá déag de mí Iúil, scríobh Richard Stallman: 

 >     XEmacs lispref that mention the connection to buffer-local variables,
 >     and am
 > 
 > We try to improve GNU Emacs documentation, but we cannot be
 > responsible for deficiencies of forked versions such as GNU XEmacs.

I didn’t suggest that you were; I mentioned the XEmacs documentation because
it was relevant to answering David’s question. 

 >     having trouble finding something that mentions it explicitly in the GNU
 >     Emacs Lisp reference manual. (And since ?coding? is treated specially
 > 
 > File local variables are a user feature, not a Lisp programming
 > feature,

They are both. You need an awareness of programming Lisp to use them,
something not true for most things detailed in the Emacs Manual.

 > so they are documented in the Emacs Manual.
 > 
 >     Ah, here we are; three
 >     throwaway sentences in Local Variables in Files,
 > 
 > I see you found the section in the Emacs Manual which documents them.
 > (There is an xref to it in the Lisp Manual.)
 > 
 > Why do you call that text "throwaway"?  It is right at the start of
 > the section, and states the point explicitly.  It says everything
 > there is to say about the question.

It doesn’t call them buffer-local variables. In GNU Emacs, variables can be
local to a let binding or lambda, local to a buffer, or local to a frame. I
read the first sentence ‘A file can specify local variable values for use
when you edit the file with Emacs.’ as just one more semantic extension of
the word ‘local’; the phrase ‘it automatically makes those variables local
to the buffer’ and a couple of phrases more in that section are what says
that the variables are buffer-local.

I call those three phrases ‘throwaway’ because they don’t arise at the start
of any section, they are mentioned in passing rather than emphasised.

 >     no mention whatsoever in
 >     Creating and Deleting Buffer-Local Bindings.
 > 
 > (When you mention a section title, would you please say which
 > manual you're talking about?  That would help me find it
 > so I can think about your point.)
 > 
 > That section describes Lisp facilities for creating and deleting
 > buffer-local bindings.  File local variable lists don't belong there.

File local variable lists create buffer-local bindings! That’s what David
just explained to me. 

 > Anyway, it seems that I can make the xref in the Lisp Manual clearer,
 > and restate this basic point.  What do you think of this new text?
 > 
 >       A file can specify local variable values; Emacs uses these to create
 >     buffer-local bindings for those variables in the buffer visiting that
 >     file.  @xref{File variables, , Local Variables in Files, emacs, The
 >     GNU Emacs Manual}, for basic information about file local variables.
 >     This section describes the functions and variables that affect
 >     processing of file local variables.

I find it much clearer; thank you for your thought on this. 

-- 
Santa Maradona, priez pour moi!

  reply	other threads:[~2006-07-16 11:59 UTC|newest]

Thread overview: 16+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2006-07-15 14:38 Activate an input-method from file-local variables? Stefan Monnier
2006-07-15 14:47 ` Aidan Kehoe
2006-07-15 14:55   ` David Kastrup
2006-07-15 16:55     ` Aidan Kehoe
2006-07-16  6:25       ` Richard Stallman
2006-07-16 11:59         ` Aidan Kehoe [this message]
2006-07-17  1:41           ` Richard Stallman
2006-07-17  7:29             ` Aidan Kehoe
2006-07-18  0:12               ` Richard Stallman
2006-07-15 21:57   ` Stefan Monnier
2006-07-16 11:36     ` Aidan Kehoe
2006-07-16 12:32       ` Stefan Monnier
2006-07-18  1:25         ` Kenichi Handa
2006-07-18 14:44           ` Stefan Monnier
2006-07-19  0:45             ` Kenichi Handa
2006-07-18 14:59           ` Richard Stallman

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=17594.10795.173314.750640@parhasard.net \
    --to=kehoea@parhasard.net \
    --cc=emacs-devel@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).