aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEli Zaretskii2001-07-17 10:39:21 +0000
committerEli Zaretskii2001-07-17 10:39:21 +0000
commit12de6e2620330e1d42286a9673b9253369812432 (patch)
tree2be9fb5c342d5877fa72e9ec0502a47f7dfe3de7
parentb2c8319e4ea8f893dcbced259a801bfa4e64e823 (diff)
downloademacs-12de6e2620330e1d42286a9673b9253369812432.tar.gz
emacs-12de6e2620330e1d42286a9673b9253369812432.zip
Proofreading fixes from Chris Green <chris_e_green@yahoo.com>
and "J. Otto Tennant" <jot@visi.com>.
-rw-r--r--man/mule.texi102
1 files changed, 53 insertions, 49 deletions
diff --git a/man/mule.texi b/man/mule.texi
index b3fb4ee756a..7052b58e73d 100644
--- a/man/mule.texi
+++ b/man/mule.texi
@@ -217,13 +217,13 @@ characters.
217you used @samp{--unibyte}. This includes the Emacs initialization 217you used @samp{--unibyte}. This includes the Emacs initialization
218file, @file{.emacs}, and the initialization files of Emacs packages 218file, @file{.emacs}, and the initialization files of Emacs packages
219such as Gnus. However, you can specify unibyte loading for a 219such as Gnus. However, you can specify unibyte loading for a
220particular Lisp file, by putting @samp{-*-unibyte: t;-*-} in a comment 220particular Lisp file, by putting @w{@samp{-*-unibyte: t;-*-}} in a
221on the first line. Then that file is always loaded as unibyte text, 221comment on the first line. Then that file is always loaded as unibyte
222even if you did not start Emacs with @samp{--unibyte}. The motivation 222text, even if you did not start Emacs with @samp{--unibyte}. The
223for these conventions is that it is more reliable to always load any 223motivation for these conventions is that it is more reliable to always
224particular Lisp file in the same way. However, you can load a Lisp 224load any particular Lisp file in the same way. However, you can load
225file as unibyte, on any one occasion, by typing @kbd{C-x @key{RET} c 225a Lisp file as unibyte, on any one occasion, by typing @kbd{C-x
226raw-text @key{RET}} immediately before loading it. 226@key{RET} c raw-text @key{RET}} immediately before loading it.
227 227
228 The mode line indicates whether multibyte character support is enabled 228 The mode line indicates whether multibyte character support is enabled
229in the current buffer. If it is, there are two or more characters (most 229in the current buffer. If it is, there are two or more characters (most
@@ -302,7 +302,7 @@ preferred coding system as needed for the locale.
302 302
303 If you modify the @env{LC_ALL}, @env{LC_CTYPE}, or @env{LANG} 303 If you modify the @env{LC_ALL}, @env{LC_CTYPE}, or @env{LANG}
304environment variables while running Emacs, you may want to invoke the 304environment variables while running Emacs, you may want to invoke the
305@code{set-locale-environment} function afterwards to readjust the 305@code{set-locale-environment} function afterwards to re-adjust the
306language environment from the new locale. 306language environment from the new locale.
307 307
308@vindex locale-preferred-coding-systems 308@vindex locale-preferred-coding-systems
@@ -363,7 +363,7 @@ characters can share one input method. A few languages support several
363input methods. 363input methods.
364 364
365 The simplest kind of input method works by mapping ASCII letters 365 The simplest kind of input method works by mapping ASCII letters
366into another alphabet; this allows you to type characters which your 366into another alphabet; this allows you to type characters that your
367keyboard doesn't support directly. This is how the Greek and Russian 367keyboard doesn't support directly. This is how the Greek and Russian
368input methods work. 368input methods work.
369 369
@@ -405,7 +405,7 @@ characters. For example, in input method @code{latin-1-postfix}, the
405sequence @kbd{e '} combines to form an @samp{e} with an accent. What if 405sequence @kbd{e '} combines to form an @samp{e} with an accent. What if
406you want to enter them as separate characters? 406you want to enter them as separate characters?
407 407
408 One way is to type the accent twice; that is a special feature for 408 One way is to type the accent twice; this is a special feature for
409entering the separate letter and accent. For example, @kbd{e ' '} gives 409entering the separate letter and accent. For example, @kbd{e ' '} gives
410you the two characters @samp{e'}. Another way is to type another letter 410you the two characters @samp{e'}. Another way is to type another letter
411after the @kbd{e}---something that won't combine with that---and 411after the @kbd{e}---something that won't combine with that---and
@@ -470,7 +470,7 @@ Display a list of all the supported input methods.
470@kindex C-x RET C-\ 470@kindex C-x RET C-\
471 To choose an input method for the current buffer, use @kbd{C-x 471 To choose an input method for the current buffer, use @kbd{C-x
472@key{RET} C-\} (@code{set-input-method}). This command reads the 472@key{RET} C-\} (@code{set-input-method}). This command reads the
473input method name with the minibuffer; the name normally starts with the 473input method name from the minibuffer; the name normally starts with the
474language environment that it is meant to be used with. The variable 474language environment that it is meant to be used with. The variable
475@code{current-input-method} records which input method is selected. 475@code{current-input-method} records which input method is selected.
476 476
@@ -606,7 +606,7 @@ Display a list of all the supported coding systems.
606@findex describe-coding-system 606@findex describe-coding-system
607 The command @kbd{C-h C} (@code{describe-coding-system}) displays 607 The command @kbd{C-h C} (@code{describe-coding-system}) displays
608information about particular coding systems. You can specify a coding 608information about particular coding systems. You can specify a coding
609system name as argument; alternatively, with an empty argument, it 609system name as the argument; alternatively, with an empty argument, it
610describes the coding systems currently selected for various purposes, 610describes the coding systems currently selected for various purposes,
611both in the current buffer and as the defaults, and the priority list 611both in the current buffer and as the defaults, and the priority list
612for recognizing coding systems (@pxref{Recognize Coding}). 612for recognizing coding systems (@pxref{Recognize Coding}).
@@ -718,9 +718,9 @@ several times, each use adds one element to the front of the priority
718list. 718list.
719 719
720 If you use a coding system that specifies the end-of-line conversion 720 If you use a coding system that specifies the end-of-line conversion
721type, such as @code{iso-8859-1-dos}, what that means is that Emacs 721type, such as @code{iso-8859-1-dos}, what this means is that Emacs
722should attempt to recognize @code{iso-8859-1} with priority, and should 722should attempt to recognize @code{iso-8859-1} with priority, and should
723use DOS end-of-line conversion in case it recognizes @code{iso-8859-1}. 723use DOS end-of-line conversion if it recognizes @code{iso-8859-1}.
724 724
725@vindex file-coding-system-alist 725@vindex file-coding-system-alist
726 Sometimes a file name indicates which coding system to use for the 726 Sometimes a file name indicates which coding system to use for the
@@ -770,21 +770,22 @@ the buffer.
770 The default value of @code{inhibit-iso-escape-detection} is 770 The default value of @code{inhibit-iso-escape-detection} is
771@code{nil}. We recommend that you not change it permanently, only for 771@code{nil}. We recommend that you not change it permanently, only for
772one specific operation. That's because many Emacs Lisp source files 772one specific operation. That's because many Emacs Lisp source files
773that contain non-ASCII characters are encoded in the coding system 773in the Emacs distribution contain non-ASCII characters encoded in the
774@code{iso-2022-7bit} in the Emacs distribution, and they won't be 774coding system @code{iso-2022-7bit}, and they won't be
775decoded correctly when you visit those files if you suppress the 775decoded correctly when you visit those files if you suppress the
776escape sequence detection. 776escape sequence detection.
777 777
778@vindex coding 778@vindex coding
779 You can specify the coding system for a particular file using the 779 You can specify the coding system for a particular file using the
780@samp{-*-@dots{}-*-} construct at the beginning of a file, or a local 780@w{@samp{-*-@dots{}-*-}} construct at the beginning of a file, or a
781variables list at the end (@pxref{File Variables}). You do this by 781local variables list at the end (@pxref{File Variables}). You do this
782defining a value for the ``variable'' named @code{coding}. Emacs does 782by defining a value for the ``variable'' named @code{coding}. Emacs
783not really have a variable @code{coding}; instead of setting a variable, 783does not really have a variable @code{coding}; instead of setting a
784it uses the specified coding system for the file. For example, 784variable, it uses the specified coding system for the file. For
785@samp{-*-mode: C; coding: latin-1;-*-} specifies use of the Latin-1 785example, @samp{-*-mode: C; coding: latin-1;-*-} specifies use of the
786coding system, as well as C mode. If you specify the coding explicitly 786Latin-1 coding system, as well as C mode. If you specify the coding
787in the file, that overrides @code{file-coding-system-alist}. 787explicitly in the file, that overrides
788@code{file-coding-system-alist}.
788 789
789@vindex auto-coding-alist 790@vindex auto-coding-alist
790@vindex auto-coding-regexp-alist 791@vindex auto-coding-regexp-alist
@@ -819,14 +820,15 @@ Coding}).
819 820
820 You can insert any possible character into any Emacs buffer, but 821 You can insert any possible character into any Emacs buffer, but
821most coding systems can only handle some of the possible characters. 822most coding systems can only handle some of the possible characters.
822This means that you can insert characters that cannot be encoded with 823This means that it is possible for you to insert characters that
823the coding system that will be used to save the buffer. For example, 824cannot be encoded with the coding system that will be used to save the
824you could start with an ASCII file and insert a few Latin-1 characters 825buffer. For example, you could start with an ASCII file and insert a
825into it, or you could edit a text file in Polish encoded in 826few Latin-1 characters into it, or you could edit a text file in
826@code{iso-8859-2} and add to it translations of several Polish words 827Polish encoded in @code{iso-8859-2} and add to it translations of
827into Russian. When you save the buffer, Emacs cannot use the current 828several Polish words into Russian. When you save the buffer, Emacs
828value of @code{buffer-file-coding-system}, because the characters you 829cannot use the current value of @code{buffer-file-coding-system},
829added cannot be encoded by that coding system. 830because the characters you added cannot be encoded by that coding
831system.
830 832
831 When that happens, Emacs tries the most-preferred coding system (set 833 When that happens, Emacs tries the most-preferred coding system (set
832by @kbd{M-x prefer-coding-system} or @kbd{M-x 834by @kbd{M-x prefer-coding-system} or @kbd{M-x
@@ -859,7 +861,7 @@ Emacs encodes outgoing mail using the Latin-1 coding system.
859 861
860@vindex rmail-decode-mime-charset 862@vindex rmail-decode-mime-charset
861 When you get new mail in Rmail, each message is translated 863 When you get new mail in Rmail, each message is translated
862automatically from the coding system it is written in---as if it were a 864automatically from the coding system it is written in, as if it were a
863separate file. This uses the priority list of coding systems that you 865separate file. This uses the priority list of coding systems that you
864have specified. If a MIME message specifies a character set, Rmail 866have specified. If a MIME message specifies a character set, Rmail
865obeys that specification, unless @code{rmail-decode-mime-charset} is 867obeys that specification, unless @code{rmail-decode-mime-charset} is
@@ -1041,14 +1043,14 @@ messages and @code{format-time-string} formats and time stamps. You
1041should choose a coding system that is compatible with the underlying 1043should choose a coding system that is compatible with the underlying
1042system's text representation, which is normally specified by one of 1044system's text representation, which is normally specified by one of
1043the environment variables @env{LC_ALL}, @env{LC_CTYPE}, and 1045the environment variables @env{LC_ALL}, @env{LC_CTYPE}, and
1044@env{LANG}. (The first one whose value is nonempty is the one that 1046@env{LANG}. (The first one, in the order specified above, whose value
1045determines the text representation.) 1047is nonempty is the one that determines the text representation.)
1046 1048
1047@node Fontsets 1049@node Fontsets
1048@section Fontsets 1050@section Fontsets
1049@cindex fontsets 1051@cindex fontsets
1050 1052
1051 A font for X typically defines shapes for one alphabet or script. 1053 A font for X typically defines shapes for a single alphabet or script.
1052Therefore, displaying the entire range of scripts that Emacs supports 1054Therefore, displaying the entire range of scripts that Emacs supports
1053requires a collection of many fonts. In Emacs, such a collection is 1055requires a collection of many fonts. In Emacs, such a collection is
1054called a @dfn{fontset}. A fontset is defined by a list of fonts, each 1056called a @dfn{fontset}. A fontset is defined by a list of fonts, each
@@ -1068,7 +1070,7 @@ additional font support.}
1068and the @dfn{startup fontset}. The standard fontset is most likely to 1070and the @dfn{startup fontset}. The standard fontset is most likely to
1069have fonts for a wide variety of non-ASCII characters; however, this is 1071have fonts for a wide variety of non-ASCII characters; however, this is
1070not the default for Emacs to use. (By default, Emacs tries to find a 1072not the default for Emacs to use. (By default, Emacs tries to find a
1071font which has bold and italic variants.) You can specify use of the 1073font that has bold and italic variants.) You can specify use of the
1072standard fontset with the @samp{-fn} option, or with the @samp{Font} X 1074standard fontset with the @samp{-fn} option, or with the @samp{Font} X
1073resource (@pxref{Font X}). For example, 1075resource (@pxref{Font X}). For example,
1074 1076
@@ -1136,7 +1138,7 @@ window frame:
1136 With the X resource @samp{Emacs.Font}, you can specify a fontset name 1138 With the X resource @samp{Emacs.Font}, you can specify a fontset name
1137just like an actual font name. But be careful not to specify a fontset 1139just like an actual font name. But be careful not to specify a fontset
1138name in a wildcard resource like @samp{Emacs*Font}---that wildcard 1140name in a wildcard resource like @samp{Emacs*Font}---that wildcard
1139specification applies to various other purposes, such as menus, and 1141specification is used for various other purposes, such as menus, and
1140menus cannot handle fontsets. 1142menus cannot handle fontsets.
1141 1143
1142 You can specify additional fontsets using X resources named 1144 You can specify additional fontsets using X resources named
@@ -1171,7 +1173,8 @@ that describe the character set. For the ASCII character font,
1171collapses them into a single wildcard. This is to prevent use of 1173collapses them into a single wildcard. This is to prevent use of
1172auto-scaled fonts. Fonts made by scaling larger fonts are not usable 1174auto-scaled fonts. Fonts made by scaling larger fonts are not usable
1173for editing, and scaling a smaller font is not useful because it is 1175for editing, and scaling a smaller font is not useful because it is
1174better to use the smaller font in its own size, which Emacs does. 1176better to use the smaller font in its own size, which is what Emacs
1177does.
1175 1178
1176 Thus if @var{fontpattern} is this, 1179 Thus if @var{fontpattern} is this,
1177 1180
@@ -1250,13 +1253,13 @@ sequences mostly correspond to those of the prefix input methods.
1250@cindex ISO Latin character sets 1253@cindex ISO Latin character sets
1251@cindex Unibyte operation 1254@cindex Unibyte operation
1252 The ISO 8859 Latin-@var{n} character sets define character codes in 1255 The ISO 8859 Latin-@var{n} character sets define character codes in
1253the range 160 to 255 to handle the accented letters and punctuation 1256the range 0240 to 0377 octal (160 to 255 decimal) to handle the
1254needed by various European languages (and some non-European ones). 1257accented letters and punctuation needed by various European languages
1255If you disable multibyte 1258(and some non-European ones). If you disable multibyte characters,
1256characters, Emacs can still handle @emph{one} of these character codes 1259Emacs can still handle @emph{one} of these character codes at a time.
1257at a time. To specify @emph{which} of these codes to use, invoke 1260To specify @emph{which} of these codes to use, invoke @kbd{M-x
1258@kbd{M-x set-language-environment} and specify a suitable language 1261set-language-environment} and specify a suitable language environment
1259environment such as @samp{Latin-@var{n}}. 1262such as @samp{Latin-@var{n}}.
1260 1263
1261 For more information about unibyte operation, see @ref{Enabling 1264 For more information about unibyte operation, see @ref{Enabling
1262Multibyte}. Note particularly that you probably want to ensure that 1265Multibyte}. Note particularly that you probably want to ensure that
@@ -1282,7 +1285,7 @@ them yet.
1282 1285
1283@findex standard-display-8bit 1286@findex standard-display-8bit
1284@cindex 8-bit display 1287@cindex 8-bit display
1285 Normally non-ISO-8859 characters (between characters 128 and 159 1288 Normally non-ISO-8859 characters (decimal codes between 128 and 159
1286inclusive) are displayed as octal escapes. You can change this for 1289inclusive) are displayed as octal escapes. You can change this for
1287non-standard ``extended'' versions of ISO-8859 character sets by using the 1290non-standard ``extended'' versions of ISO-8859 character sets by using the
1288function @code{standard-display-8bit} in the @code{disp-table} library. 1291function @code{standard-display-8bit} in the @code{disp-table} library.
@@ -1293,8 +1296,9 @@ characters:
1293@itemize @bullet 1296@itemize @bullet
1294@cindex 8-bit input 1297@cindex 8-bit input
1295@item 1298@item
1296If your keyboard can generate character codes 128 and up, representing 1299If your keyboard can generate character codes 128 (decimal) and up,
1297non-ASCII characters, you can type those character codes directly. 1300representing non-ASCII characters, you can type those character codes
1301directly.
1298 1302
1299On a windowing terminal, you should not need to do anything special to 1303On a windowing terminal, you should not need to do anything special to
1300use these keys; they should simply work. On a text-only terminal, you 1304use these keys; they should simply work. On a text-only terminal, you