Minor improvements in the "International" chapter of Emacs manual

* doc/emacs/mule.texi (File Name Coding): Stop enumerating all the
versions of MS-Windows.
(Modifying Fontsets, Unibyte Mode, Bidirectional Editing): Improve
wording.  Reported by Francis Wright <f.j.wright@live.co.uk> in
emacs-manual-bugs@gnu.org.
This commit is contained in:
Eli Zaretskii 2018-01-29 19:47:50 +02:00
parent 79252d3127
commit 490c736013

View file

@ -1207,13 +1207,13 @@ using the internal Emacs representation.
@cindex file-name encoding, MS-Windows @cindex file-name encoding, MS-Windows
@vindex w32-unicode-filenames @vindex w32-unicode-filenames
When Emacs runs on MS-Windows versions that are descendants of the When Emacs runs on MS-Windows versions that are descendants of the
NT family (Windows 2000, XP, Vista, Windows 7, and Windows 8), the NT family (Windows 2000, XP, Vista, Windows 7, and all the later
value of @code{file-name-coding-system} is largely ignored, as Emacs versions), the value of @code{file-name-coding-system} is largely
by default uses APIs that allow passing Unicode file names directly. ignored, as Emacs by default uses APIs that allow passing Unicode file
By contrast, on Windows 9X, file names are encoded using names directly. By contrast, on Windows 9X, file names are encoded
@code{file-name-coding-system}, which should be set to the codepage using @code{file-name-coding-system}, which should be set to the
(@pxref{Coding Systems, codepage}) pertinent for the current system codepage (@pxref{Coding Systems, codepage}) pertinent for the current
locale. The value of the variable @code{w32-unicode-filenames} system locale. The value of the variable @code{w32-unicode-filenames}
controls whether Emacs uses the Unicode APIs when it calls OS controls whether Emacs uses the Unicode APIs when it calls OS
functions that accept file names. This variable is set by the startup functions that accept file names. This variable is set by the startup
code to @code{nil} on Windows 9X, and to @code{t} on newer versions of code to @code{nil} on Windows 9X, and to @code{t} on newer versions of
@ -1570,9 +1570,9 @@ used. Some examples are:
unpleasant results for characters for which they are used, and you may unpleasant results for characters for which they are used, and you may
wish to instruct Emacs to completely ignore them while searching for a wish to instruct Emacs to completely ignore them while searching for a
suitable font required to display a character. You can do that by suitable font required to display a character. You can do that by
adding the offending fonts to the value of @code{face-ignored-fonts} adding the offending fonts to the value of the variable
variable, which is a list. Here's an example to put in your @code{face-ignored-fonts}, which is a list. Here's an example to put
@file{~/.emacs}: in your @file{~/.emacs}:
@example @example
(add-to-list 'face-ignored-fonts "Some Bad Font") (add-to-list 'face-ignored-fonts "Some Bad Font")
@ -1673,10 +1673,10 @@ should use the command @kbd{M-x set-keyboard-coding-system} or
customize the variable @code{keyboard-coding-system} to specify which customize the variable @code{keyboard-coding-system} to specify which
coding system your keyboard uses (@pxref{Terminal Coding}). Enabling coding system your keyboard uses (@pxref{Terminal Coding}). Enabling
this feature will probably require you to use @key{ESC} to type Meta this feature will probably require you to use @key{ESC} to type Meta
characters; however, on a console terminal or in @code{xterm}, you can characters; however, on a console terminal or a terminal emulator such
arrange for Meta to be converted to @key{ESC} and still be able to as @code{xterm}, you can arrange for Meta to be converted to @key{ESC}
type 8-bit characters present directly on the keyboard or using and still be able to type 8-bit characters present directly on the
@key{Compose} or @key{AltGr} keys. @xref{User Input}. keyboard or using @key{Compose} or @key{AltGr} keys. @xref{User Input}.
@cindex @code{iso-transl} library @cindex @code{iso-transl} library
@cindex compose character @cindex compose character
@ -1777,13 +1777,13 @@ for editing bidirectional text.
@dfn{logical} (or @dfn{reading}) order: the buffer or string position @dfn{logical} (or @dfn{reading}) order: the buffer or string position
of the first character you read precedes that of the next character. of the first character you read precedes that of the next character.
Reordering of bidirectional text into the @dfn{visual} order happens Reordering of bidirectional text into the @dfn{visual} order happens
at display time. As result, character positions no longer increase at display time. As a result, character positions no longer increase
monotonically with their positions on display. Emacs implements the monotonically with their positions on display. Emacs implements the
Unicode Bidirectional Algorithm (UBA) described in the Unicode Unicode Bidirectional Algorithm (UBA) described in the Unicode
Standard Annex #9, for reordering of bidirectional text for display. Standard Annex #9, for reordering of bidirectional text for display.
It deviates from the UBA only in how continuation lines are displayed It deviates from the UBA only in how continuation lines are displayed
when text direction is opposite to the base paragraph direction, when text direction is opposite to the base paragraph direction,
e.g. when a long line of English text appears in a right-to-left e.g., when a long line of English text appears in a right-to-left
paragraph. paragraph.
@vindex bidi-display-reordering @vindex bidi-display-reordering
@ -1835,12 +1835,13 @@ thin blank characters; on text terminals they display as blanks.
Because characters are reordered for display, Emacs commands that Because characters are reordered for display, Emacs commands that
operate in the logical order or on stretches of buffer positions may operate in the logical order or on stretches of buffer positions may
produce unusual effects. For example, @kbd{C-f} and @kbd{C-b} produce unusual effects. For example, the commands @kbd{C-f} and
commands move point in the logical order, so the cursor will sometimes @kbd{C-b} move point in the logical order, so the cursor will
jump when point traverses reordered bidirectional text. Similarly, a sometimes jump when point traverses reordered bidirectional text.
highlighted region covering a contiguous range of character positions Similarly, a highlighted region covering a contiguous range of
may look discontinuous if the region spans reordered text. This is character positions may look discontinuous if the region spans
normal and similar to the behavior of other programs that support reordered text. This is normal and similar to the behavior of other
bidirectional text. If you set @code{visual-order-cursor-movement} to programs that support bidirectional text. If you set
a non-@code{nil} value, cursor motion by the arrow keys follows the @code{visual-order-cursor-movement} to a non-@code{nil} value, cursor
visual order on screen (@pxref{Moving Point, visual-order movement}). motion by the arrow keys follows the visual order on screen
(@pxref{Moving Point, visual-order movement}).