From: Glenn Morris Date: Thu, 10 May 2012 02:54:07 +0000 (-0700) Subject: Update doc for obsolescence of "unibyte: t" X-Git-Tag: emacs-24.2.90~471^2~132 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=b8a82b6930b669a8a434d685a351e52194e6f7d9;p=emacs.git Update doc for obsolescence of "unibyte: t" * doc/emacs/mule.texi (Disabling Multibyte): * doc/lispref/loading.texi (Loading Non-ASCII): Replace the obsolete "unibyte: t" with "coding: raw-text". * etc/NEWS: Related markup. --- diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog index 95db7194053..b166262a7ca 100644 --- a/doc/emacs/ChangeLog +++ b/doc/emacs/ChangeLog @@ -1,5 +1,8 @@ 2012-05-10 Glenn Morris + * mule.texi (Disabling Multibyte): Replace the obsolete "unibyte: t" + with "coding: raw-text". + * files.texi (Interlocking): Mention create-lockfiles option. 2012-05-09 Chong Yidong diff --git a/doc/emacs/mule.texi b/doc/emacs/mule.texi index b0b35bf14b5..35aee6b94a2 100644 --- a/doc/emacs/mule.texi +++ b/doc/emacs/mule.texi @@ -287,20 +287,17 @@ auto mode selection. This includes the Emacs initialization file, @file{.emacs}, and the initialization files of packages such as Gnus. However, you can specify unibyte loading for a -particular Lisp file, by adding an entry @samp{unibyte: t} in a file -local variables section (@pxref{File Variables}). Then that file is -always loaded as unibyte text. Note that this does not represent a -real @code{unibyte} variable, rather it just acts as an indicator -to Emacs in the same way as @code{coding} does (@pxref{Specify Coding}). +particular Lisp file, by adding an entry @samp{coding: raw-text} in a file +local variables section. @xref{Specify Coding}. +Then that file is always loaded as unibyte text. @ignore @c I don't see the point of this statement: The motivation for these conventions is that it is more reliable to always load any particular Lisp file in the same way. @end ignore -Note also that this feature only applies to @emph{loading} Lisp files -for evaluation, not to visiting them for editing. You can also load a -Lisp file as unibyte, on any one occasion, by typing @kbd{C-x -@key{RET} c raw-text @key{RET}} immediately before loading it. +You can also load a Lisp file as unibyte, on any one occasion, by +typing @kbd{C-x @key{RET} c raw-text @key{RET}} immediately before +loading it. @c See http://debbugs.gnu.org/11226 for lack of unibyte tooltip. @vindex enable-multibyte-characters diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index 2967e644558..a64c4386e33 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,5 +1,8 @@ 2012-05-10 Glenn Morris + * loading.texi (Loading Non-ASCII): Replace the obsolete "unibyte: t" + with "coding: raw-text". + * files.texi (File Locks): Mention create-lockfiles option. 2012-05-09 Glenn Morris diff --git a/doc/lispref/loading.texi b/doc/lispref/loading.texi index c9f438f6e47..b012091d4a8 100644 --- a/doc/lispref/loading.texi +++ b/doc/lispref/loading.texi @@ -374,7 +374,7 @@ strings are multibyte strings should not be noticeable, since inserting them in unibyte buffers converts them to unibyte automatically. However, if this does make a difference, you can force a particular Lisp file to be interpreted as unibyte by writing -@samp{unibyte: t} in a local variables section. With +@samp{coding: raw-text} in a local variables section. With that designator, the file will unconditionally be interpreted as unibyte, even in an ordinary multibyte Emacs session. This can matter when making keybindings to non-@acronym{ASCII} characters written as diff --git a/etc/NEWS b/etc/NEWS index 0726b091989..10247eb1520 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -69,6 +69,7 @@ specifying any file to visit or expression to evaluate. ** You can prevent the creation of lock files by setting `create-lockfiles' to nil. Use with caution, and only if you really need to. ++++ ** Using "unibyte: t" in Lisp source files is obsolete. Use "coding: raw-text" instead.