all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* Improvements to `(emacs)File Variables'
@ 2004-11-14 19:02 Reiner Steib
  2004-11-14 21:12 ` Stefan Monnier
  0 siblings, 1 reply; 27+ messages in thread
From: Reiner Steib @ 2004-11-14 19:02 UTC (permalink / raw)
  Cc: Simon Krahnke

Hi,

`unibyte: t' is not mentioned at all in (info "(emacs)File Variables").

Additionally, the paragraph starting with »Two "variable names" have
special meanings ...« is misleading because beside `mode' and `eval'
also `unibyte' and `coding' have special meanings:

,----[ (info "(emacs)File Variables") ]
|    Two "variable names" have special meanings in a local variables
| list: a value for the variable `mode' really sets the major mode, and a
| value for the variable `eval' is simply evaluated as an expression and
| the value is ignored.  `mode' and `eval' are not real variables;
`----

How about the following patches?  Okay to install?

2004-11-14  Reiner Steib  <Reiner.Steib@gmx.de>

	* custom.texi (File Variables): Add `unibyte' and make it more
	clear that `unibyte' and `coding' are special.  Suggested by Simon
	Krahnke <overlord@gmx.li>.

	* mule.texi (Enabling Multibyte): Refer to File Variables.
	Suggested by Simon Krahnke <overlord@gmx.li>.

--8<---------------cut here---------------start------------->8---
--- custom.texi	21 Sep 2004 12:47:25 +0200	1.67
+++ custom.texi	14 Nov 2004 19:39:36 +0100	
@@ -961,7 +961,8 @@
   You can also specify the coding system for a file in this way: just
 specify a value for the ``variable'' named @code{coding}.  The ``value''
 must be a coding system name that Emacs recognizes.  @xref{Coding
-Systems}.
+Systems}.  @w{@samp{unibyte: t}} specifies unibyte loading for a
+particular Lisp file.  @xref{Enabling Multibyte}.
 
   The @code{eval} pseudo-variable, described below, can be specified in
 the first line as well.
@@ -1022,14 +1023,15 @@
 # End:
 @end example
 
-  Two ``variable names'' have special meanings in a local variables
+  Some ``variable names'' have special meanings in a local variables
 list: a value for the variable @code{mode} really sets the major mode,
 and a value for the variable @code{eval} is simply evaluated as an
-expression and the value is ignored.  @code{mode} and @code{eval} are
-not real variables; setting variables named @code{mode} and @code{eval}
-in any other context has no special meaning.  @emph{If @code{mode} is
-used to set a major mode, it should be the first ``variable'' in the
-list.}  Otherwise, the entries that precede it in the list of the local
+expression and the value is ignored.  @code{coding}, @code{unibyte},
+@code{mode} and @code{eval} are not real variables; setting variables
+named @code{coding}, @code{unibyte}, @code{mode} and @code{eval} in any
+other context has no special meaning.  @emph{If @code{mode} is used to
+set a major mode, it should be the first ``variable'' in the list.}
+Otherwise, the entries that precede it in the list of the local
 variables are likely to be ignored, since most modes kill all local
 variables as part of their initialization.
--8<---------------cut here---------------end--------------->8---

(Not reformatted yet to make the change more clear:)
--8<---------------cut here---------------start------------->8---
--- mule.texi	04 Mar 2004 18:23:24 +0100	1.68
+++ mule.texi	14 Nov 2004 19:52:46 +0100	
@@ -199,7 +199,8 @@
 file, @file{.emacs}, and the initialization files of Emacs packages
 such as Gnus.  However, you can specify unibyte loading for a
 particular Lisp file, by putting @w{@samp{-*-unibyte: t;-*-}} in a
-comment on the first line.  Then that file is always loaded as unibyte
+comment on the first line (@xpref{File Variables}).
+Then that file is always loaded as unibyte
 text, even if you did not start Emacs with @samp{--unibyte}.  The
 motivation for these conventions is that it is more reliable to always
 load any particular Lisp file in the same way.  However, you can load
--8<---------------cut here---------------end--------------->8---

Bye, Reiner.
-- 
       ,,,
      (o o)
---ooO-(_)-Ooo---  |  PGP key available  |  http://rsteib.home.pages.de/

^ permalink raw reply	[flat|nested] 27+ messages in thread

end of thread, other threads:[~2004-11-29 19:04 UTC | newest]

Thread overview: 27+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2004-11-14 19:02 Improvements to `(emacs)File Variables' Reiner Steib
2004-11-14 21:12 ` Stefan Monnier
2004-11-14 23:26   ` Miles Bader
2004-11-14 23:46     ` Stefan Monnier
2004-11-14 23:55       ` Miles Bader
2004-11-15  0:18         ` Stefan Monnier
2004-11-15  4:53           ` Miles Bader
2004-11-15  5:15             ` Stefan Monnier
2004-11-16 16:48             ` Richard Stallman
2004-11-16 16:49     ` Richard Stallman
2004-11-16 16:59       ` Stefan Monnier
2004-11-18  2:55         ` Richard Stallman
2004-11-18 16:47           ` Stefan Monnier
2004-11-18 17:07             ` Simon Krahnke
2004-11-18 18:04               ` Stefan Monnier
2004-11-19  1:23                 ` Info-search-whitespace (Was: Improvements to `(emacs)File Variables') Juri Linkov
2004-11-19  5:06                   ` Info-search-whitespace Stefan Monnier
2004-11-19 17:48                     ` Info-search-whitespace Juri Linkov
2004-11-19 20:04                     ` Info-search-whitespace Richard Stallman
2004-11-19 20:41                       ` Info-search-whitespace David Kastrup
2004-11-21 15:39                         ` Info-search-whitespace Richard Stallman
2004-11-21 16:09                           ` Info-search-whitespace David Kastrup
2004-11-22  0:18                           ` Info-search-whitespace Stefan Monnier
2004-11-23 16:30                             ` Info-search-whitespace Richard Stallman
2004-11-19  7:15                   ` Info-search-whitespace (Was: Improvements to `(emacs)File Variables') Eli Zaretskii
2004-11-19  2:25             ` Improvements to `(emacs)File Variables' Richard Stallman
2004-11-29 19:04               ` Reiner Steib

Code repositories for project(s) associated with this external index

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

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.