Adjudicate comments to "International" chapter of Emacs manual

* doc/emacs/mule.texi (International Chars)
(Language Environments, Input Methods, Defining Fontsets)
(Modifying Fontsets): Minor wording changes and typo fixes.
Reported by Francis Wright <f.j.wright@live.co.uk> in
emacs-manual-bugs@gnu.org.

diff --git a/doc/emacs/mule.texi b/doc/emacs/mule.texi
index bccba596d3eb37794e80838a8f7e4ddabfda8d6f..be07bcc5bb26cea4d8fb4099dbbf52d2803ff2c7 100644 (file)
--- a/doc/emacs/mule.texi
+++ b/doc/emacs/mule.texi
@@ -124,7 +124,7 @@ can insert characters that your keyboard does not support, using
 @kbd{C-x 8 @key{RET}} (@code{insert-char}).  @xref{Inserting Text}.
 Shorthands are available for some common characters; for example, you
 can insert a left single quotation mark @t{‘} by typing @kbd{C-x 8
-[}, or in Electric Quote mode often by simply typing @kbd{`}.
+[}, or in Electric Quote mode, usually by simply typing @kbd{`}.
 @xref{Quotation Marks}.  Emacs also supports
 various @dfn{input methods}, typically one for each script or
 language, which make it easier to type characters in the script.
@@ -379,7 +379,7 @@ least---the way Emacs decodes non-@acronym{ASCII} characters sent by your keyboa
   If you modify the @env{LC_ALL}, @env{LC_CTYPE}, or @env{LANG}
 environment variables while running Emacs (by using @kbd{M-x setenv}),
 you may want to invoke the @code{set-locale-environment}
-function afterwards to readjust the language environment from the new
+command afterwards to readjust the language environment from the new
 locale.
 
 @vindex locale-preferred-coding-systems
@@ -508,11 +508,10 @@ entering the separate letter and accent.  For example, @kbd{o ^ ^} gives
 you the two characters @samp{o^}.  Another way is to type another letter
 after the @kbd{o}---something that won't combine with that---and
 immediately delete it.  For example, you could type @kbd{o o @key{DEL}
-^} to get separate @samp{o} and @samp{^}.
-
-  Another method, more general but not quite as easy to type, is to use
-@kbd{C-\ C-\} between two characters to stop them from combining.  This
-is the command @kbd{C-\} (@code{toggle-input-method}) used twice.
+^} to get separate @samp{o} and @samp{^}.  Another method, more
+general but not quite as easy to type, is to use @kbd{C-\ C-\} between
+two characters to stop them from combining.  This is the command
+@kbd{C-\} (@code{toggle-input-method}) used twice.
 @ifnottex
 @xref{Select Input Method}.
 @end ifnottex
@@ -1377,7 +1376,7 @@ hex code or thin space or an empty box instead.  (@xref{Text Display, ,
 glyphless characters}, for details.)
 
 @node Defining Fontsets
-@section Defining fontsets
+@section Defining Fontsets
 
 @vindex standard-fontset-spec
 @vindex w32-standard-fontset-spec
@@ -1408,8 +1407,8 @@ created automatically.  Their names have @samp{bold} instead of
 @acronym{ASCII} font that you specify with the @samp{Font} resource or
 the @samp{-fn} argument, or the default font that Emacs found when it
 started.  This is the @dfn{startup fontset} and its name is
-@code{fontset-startup}.  It does this by replacing the
-@var{charset_registry} field with @samp{fontset}, and replacing
+@code{fontset-startup}.  Emacs generates this fontset by replacing the
+@var{charset_registry} field with @samp{fontset}, and replacing the
 @var{charset_encoding} field with @samp{startup}, then using the
 resulting string to specify a fontset.
 
@@ -1455,14 +1454,15 @@ The resource value should have this form:
 @end smallexample
 
 @noindent
-@var{fontpattern} should have the form of a standard X font name (see
-the previous fontset-startup example), except
-for the last two fields.  They should have the form
-@samp{fontset-@var{alias}}.
+where @var{fontpattern} should have the form of a standard X font name
+(see the previous fontset-startup example), except for the last two
+fields.  They should have the form @samp{fontset-@var{alias}}.
 
-  The fontset has two names, one long and one short.  The long name is
-@var{fontpattern}.  The short name is @samp{fontset-@var{alias}}.  You
-can refer to the fontset by either name.
+  Each fontset has two names, one long and one short.  The long name
+is  @var{fontpattern}.  The short name is @samp{fontset-@var{alias}},
+the last 2 fields of the long name (e.g., @samp{fontset-startup} for
+the  fontset automatically created at startup).  You can refer to the
+fontset by either name.
 
   The construct @samp{@var{charset}:@var{font}} specifies which font to
 use (in this fontset) for one particular character set.  Here,
@@ -1478,7 +1478,7 @@ that describe the character set.  For the @acronym{ASCII} character font,
   In addition, when several consecutive fields are wildcards, Emacs
 collapses them into a single wildcard.  This is to prevent use of
 auto-scaled fonts.  Fonts made by scaling larger fonts are not usable
-for editing, and scaling a smaller font is not also useful, because it is
+for editing, and scaling a smaller font is also not useful, because it is
 better to use the smaller font in its own size, which is what Emacs
 does.
 
@@ -1547,7 +1547,7 @@ used.  Some examples are:
 (set-fontset-font "fontset-default" 'iso-8859-3
                   "Liberation Mono")
 
-;; Prefer a big5 font for han characters
+;; Prefer a big5 font for han characters.
 (set-fontset-font "fontset-default"
                   'han (font-spec :registry "big5")
                   nil 'prepend)