[Emacs-diffs] trunk r113622: Doc fix.

[Xue Fuqiao]

------------------------------------------------------------
revno: 113622
revision-id: address@hidden
parent: address@hidden
committer: Xue Fuqiao <address@hidden>
branch nick: trunk
timestamp: Wed 2013-07-31 20:59:10 +0800
message:
  Doc fix.
  
  * doc/emacs/custom.texi (Specifying File Variables): Fix cross-references.
  
  * doc/emacs/mule.texi (Unibyte Mode): Fix cross-references.
  
  * doc/lispref/nonascii.texi (Non-ASCII Characters): Update menu.
  (Disabling Multibyte): Move here from doc/emacs/mule.texi.  Fix 
cross-references.
  
  * doc/lispref/elisp.texi (Top): Update menu.
modified:
  doc/emacs/ChangeLog            changelog-20091113204419-o5vbwnq5f7feedwu-6227
  doc/emacs/custom.texi          
custom.texi-20091113204419-o5vbwnq5f7feedwu-6240
  doc/emacs/mule.texi            mule.texi-20091113204419-o5vbwnq5f7feedwu-6270
  doc/lispref/ChangeLog          changelog-20091113204419-o5vbwnq5f7feedwu-6155
  doc/lispref/elisp.texi         elisp.texi-20091113204419-o5vbwnq5f7feedwu-6176
  doc/lispref/nonascii.texi      
nonascii.texi-20091113204419-o5vbwnq5f7feedwu-6202

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2013-07-31 12:04:25 +0000
+++ b/doc/emacs/ChangeLog       2013-07-31 12:59:10 +0000
@@ -1,5 +1,9 @@
 2013-07-31  Xue Fuqiao  <address@hidden>
 
+       * custom.texi (Specifying File Variables): Fix cross-references.
+
+       * mule.texi (Unibyte Mode): Fix cross-references.
+
        * macos.texi (Mac / GNUstep Basics): Mention `ns-alternate-modifier'.
 
        * cal-xtra.texi (Advanced Calendar/Diary Usage): Update menu.

=== modified file 'doc/emacs/custom.texi'
--- a/doc/emacs/custom.texi     2013-05-07 06:43:34 +0000
+++ b/doc/emacs/custom.texi     2013-07-31 12:59:10 +0000
@@ -1166,7 +1166,10 @@
 
 @item
 @code{unibyte} says to load or compile a file of Emacs Lisp in unibyte
-mode, if the value is @code{t}.  @xref{Disabling Multibyte}.
+mode, if the value is @code{t}.  @xref{Disabling Multibyte, ,
+Disabling Multibyte Characters, elisp, GNU Emacs Lisp Reference
+Manual}.
+
 @end itemize
 
 @noindent

=== modified file 'doc/emacs/mule.texi'
--- a/doc/emacs/mule.texi       2013-06-29 13:36:19 +0000
+++ b/doc/emacs/mule.texi       2013-07-31 12:59:10 +0000
@@ -90,7 +90,6 @@
 
 @menu
 * International Chars::     Basic concepts of multibyte characters.
-* Disabling Multibyte::     Controlling whether to use multibyte characters.
 * Language Environments::   Setting things up for the language you use.
 * Input Methods::           Entering text characters not on your keyboard.
 * Select Input Method::     Specifying your choice of input methods.
@@ -244,79 +243,6 @@
   decomposition: (65 768) ('A' '`')
 @end smallexample
 
address@hidden FIXME?  Does this section even belong in the user manual?
address@hidden Seems more appropriate to the lispref?
address@hidden Disabling Multibyte
address@hidden Disabling Multibyte Characters
-
-  By default, Emacs starts in multibyte mode: it stores the contents
-of buffers and strings using an internal encoding that represents
address@hidden characters using multi-byte sequences.  Multibyte
-mode allows you to use all the supported languages and scripts without
-limitations.
-
address@hidden turn multibyte support on or off
-  Under very special circumstances, you may want to disable multibyte
-character support, for a specific buffer.
-When multibyte characters are disabled in a buffer, we call
-that @dfn{unibyte mode}.  In unibyte mode, each character in the
-buffer has a character code ranging from 0 through 255 (0377 octal); 0
-through 127 (0177 octal) represent @acronym{ASCII} characters, and 128
-(0200 octal) through 255 (0377 octal) represent address@hidden
-characters.
-
-  To edit a particular file in unibyte representation, visit it using
address@hidden  @xref{Visiting}.  You can convert a
-multibyte buffer to unibyte by saving it to a file, killing the
-buffer, and visiting the file again with @code{find-file-literally}.
-Alternatively, you can use @kbd{C-x @key{RET} c}
-(@code{universal-coding-system-argument}) and specify @samp{raw-text}
-as the coding system with which to visit or save a file.  @xref{Text
-Coding}.  Unlike @code{find-file-literally}, finding a file as
address@hidden doesn't disable format conversion, uncompression, or
-auto mode selection.
-
address@hidden Not a single file in Emacs uses this feature.  Is it really worth
address@hidden mentioning in the _user_ manual?  Also, this duplicates somewhat
address@hidden "Loading Non-ASCII" from the lispref.
address@hidden Lisp files, and multibyte operation
address@hidden multibyte operation, and Lisp files
address@hidden unibyte operation, and Lisp files
address@hidden init file, and address@hidden characters
-  Emacs normally loads Lisp files as multibyte.
-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{coding: raw-text} in a file
-local variables section.  @xref{Specify Coding}.
-Then that file is always loaded as unibyte text.
address@hidden
address@hidden 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.
address@hidden ignore
-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.
-
address@hidden See http://debbugs.gnu.org/11226 for lack of unibyte tooltip.
address@hidden enable-multibyte-characters
-The buffer-local variable @code{enable-multibyte-characters} is
address@hidden in multibyte buffers, and @code{nil} in unibyte ones.
-The mode line also indicates whether a buffer is multibyte or not.
address@hidden Line}.  With a graphical display, in a multibyte buffer,
-the portion of the mode line that indicates the character set has a
-tooltip that (amongst other things) says that the buffer is multibyte.
-In a unibyte buffer, the character set indicator is absent.  Thus, in
-a unibyte buffer (when using a graphical display) there is normally
-nothing before the indication of the visited file's end-of-line
-convention (colon, backslash, etc.), unless you are using an input
-method.
-
address@hidden toggle-enable-multibyte-characters
-You can turn off multibyte support in a specific buffer by invoking the
-command @code{toggle-enable-multibyte-characters} in that buffer.
-
 @node Language Environments
 @section Language Environments
 @cindex language environments
@@ -1591,15 +1517,13 @@
 accented letters and punctuation needed by various European languages
 (and some non-European ones).  Note that Emacs considers bytes with
 codes in this range as raw bytes, not as characters, even in a unibyte
-buffer, i.e., if you disable multibyte characters.  However, Emacs
-can still handle these character codes as if they belonged to
address@hidden of the single-byte character sets at a time.  To specify
address@hidden of these codes to use, invoke @kbd{M-x
-set-language-environment} and specify a suitable language environment
-such as @address@hidden
-
-  For more information about unibyte operation, see
address@hidden Multibyte}.
+buffer, i.e., if you disable multibyte characters.  However, Emacs can
+still handle these character codes as if they belonged to @emph{one}
+of the single-byte character sets at a time.  To specify @emph{which}
+of these codes to use, invoke @kbd{M-x set-language-environment} and
+specify a suitable language environment such as @address@hidden
address@hidden Multibyte, , Disabling Multibyte Characters, elisp,
+GNU Emacs Lisp Reference Manual}.
 
 @vindex unibyte-display-via-language-environment
   Emacs can also display bytes in the range 160 to 255 as readable

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2013-07-30 13:53:28 +0000
+++ b/doc/lispref/ChangeLog     2013-07-31 12:59:10 +0000
@@ -1,3 +1,10 @@
+2013-07-31  Xue Fuqiao  <address@hidden>
+
+       * nonascii.texi (Non-ASCII Characters): Update menu.
+       (Disabling Multibyte): Move here from doc/emacs/mule.texi.  Fix 
cross-references.
+
+       * elisp.texi (Top): Update menu.
+
 2013-07-30  Xue Fuqiao  <address@hidden>
 
        * windows.texi (Window History): Mention the default value of

=== modified file 'doc/lispref/elisp.texi'
--- a/doc/lispref/elisp.texi    2013-07-22 09:19:00 +0000
+++ b/doc/lispref/elisp.texi    2013-07-31 12:59:10 +0000
@@ -1194,6 +1194,7 @@
 address@hidden Characters
 
 * Text Representations::    How Emacs represents text.
+* Disabling Multibyte::     Controlling whether to use multibyte characters.
 * Converting Representations::  Converting unibyte to multibyte and vice versa.
 * Selecting a Representation::  Treating a byte sequence as unibyte or multi.
 * Character Codes::         How unibyte and multibyte relate to

=== modified file 'doc/lispref/nonascii.texi'
--- a/doc/lispref/nonascii.texi 2013-07-06 08:05:21 +0000
+++ b/doc/lispref/nonascii.texi 2013-07-31 12:59:10 +0000
@@ -13,6 +13,7 @@
 
 @menu
 * Text Representations::    How Emacs represents text.
+* Disabling Multibyte::     Controlling whether to use multibyte characters.
 * Converting Representations::  Converting unibyte to multibyte and vice versa.
 * Selecting a Representation::  Treating a byte sequence as unibyte or multi.
 * Character Codes::         How unibyte and multibyte relate to
@@ -140,6 +141,55 @@
 result a unibyte string.
 @end defun
 
address@hidden Disabling Multibyte
address@hidden Disabling Multibyte Characters
address@hidden disabling multibyte
+
+  By default, Emacs starts in multibyte mode: it stores the contents
+of buffers and strings using an internal encoding that represents
address@hidden characters using multi-byte sequences.  Multibyte
+mode allows you to use all the supported languages and scripts without
+limitations.
+
address@hidden turn multibyte support on or off
+  Under very special circumstances, you may want to disable multibyte
+character support, for a specific buffer.
+When multibyte characters are disabled in a buffer, we call
+that @dfn{unibyte mode}.  In unibyte mode, each character in the
+buffer has a character code ranging from 0 through 255 (0377 octal); 0
+through 127 (0177 octal) represent @acronym{ASCII} characters, and 128
+(0200 octal) through 255 (0377 octal) represent address@hidden
+characters.
+
+  To edit a particular file in unibyte representation, visit it using
address@hidden  @xref{Visiting Functions}.  You can
+convert a multibyte buffer to unibyte by saving it to a file, killing
+the buffer, and visiting the file again with
address@hidden  Alternatively, you can use @kbd{C-x
address@hidden c} (@code{universal-coding-system-argument}) and specify
address@hidden as the coding system with which to visit or save a
+file.  @xref{Text Coding, , Specifying a Coding System for File Text,
+emacs, GNU Emacs Manual}.  Unlike @code{find-file-literally}, finding
+a file as @samp{raw-text} doesn't disable format conversion,
+uncompression, or auto mode selection.
+
address@hidden See http://debbugs.gnu.org/11226 for lack of unibyte tooltip.
address@hidden enable-multibyte-characters
+The buffer-local variable @code{enable-multibyte-characters} is
address@hidden in multibyte buffers, and @code{nil} in unibyte ones.
+The mode line also indicates whether a buffer is multibyte or not.
+With a graphical display, in a multibyte buffer, the portion of the
+mode line that indicates the character set has a tooltip that (amongst
+other things) says that the buffer is multibyte.  In a unibyte buffer,
+the character set indicator is absent.  Thus, in a unibyte buffer
+(when using a graphical display) there is normally nothing before the
+indication of the visited file's end-of-line convention (colon,
+backslash, etc.), unless you are using an input method.
+
address@hidden toggle-enable-multibyte-characters
+You can turn off multibyte support in a specific buffer by invoking the
+command @code{toggle-enable-multibyte-characters} in that buffer.
+
 @node Converting Representations
 @section Converting Text Representations