diff options
| author | Dave Love | 2002-07-30 11:29:11 +0000 |
|---|---|---|
| committer | Dave Love | 2002-07-30 11:29:11 +0000 |
| commit | a032b9bd7a3fe3ab55e9d5d8e828911a88d603d9 (patch) | |
| tree | ecfc744599759410bb21ef6303e2f6743a003915 | |
| parent | 0c7d8ed979354a2e5ef3ab06f0cd9a4a60a04575 (diff) | |
| download | emacs-a032b9bd7a3fe3ab55e9d5d8e828911a88d603d9.tar.gz emacs-a032b9bd7a3fe3ab55e9d5d8e828911a88d603d9.zip | |
Updates for current changes.
| -rw-r--r-- | lispref/nonascii.texi | 27 |
1 files changed, 14 insertions, 13 deletions
diff --git a/lispref/nonascii.texi b/lispref/nonascii.texi index 47d14018a3a..a3976574b8d 100644 --- a/lispref/nonascii.texi +++ b/lispref/nonascii.texi | |||
| @@ -1,6 +1,6 @@ | |||
| 1 | @c -*-texinfo-*- | 1 | @c -*-texinfo-*- |
| 2 | @c This is part of the GNU Emacs Lisp Reference Manual. | 2 | @c This is part of the GNU Emacs Lisp Reference Manual. |
| 3 | @c Copyright (C) 1998, 1999 Free Software Foundation, Inc. | 3 | @c Copyright (C) 1998, 1999, 2002 Free Software Foundation, Inc. |
| 4 | @c See the file elisp.texi for copying conditions. | 4 | @c See the file elisp.texi for copying conditions. |
| 5 | @setfilename ../info/characters | 5 | @setfilename ../info/characters |
| 6 | @node Non-ASCII Characters, Searching and Matching, Text, Top | 6 | @node Non-ASCII Characters, Searching and Matching, Text, Top |
| @@ -87,7 +87,9 @@ This variable's value is entirely equivalent to @code{(default-value | |||
| 87 | default value. Setting the local binding of | 87 | default value. Setting the local binding of |
| 88 | @code{enable-multibyte-characters} in a specific buffer is not allowed, | 88 | @code{enable-multibyte-characters} in a specific buffer is not allowed, |
| 89 | but changing the default value is supported, and it is a reasonable | 89 | but changing the default value is supported, and it is a reasonable |
| 90 | thing to do, because it has no effect on existing buffers. | 90 | thing to do, because it has no effect on existing buffers. It can be |
| 91 | useful to bind it around a block of code to ensure it uses unibyte | ||
| 92 | consistently. | ||
| 91 | 93 | ||
| 92 | The @samp{--unibyte} command line option does its job by setting the | 94 | The @samp{--unibyte} command line option does its job by setting the |
| 93 | default value to @code{nil} early in startup. | 95 | default value to @code{nil} early in startup. |
| @@ -317,9 +319,7 @@ belongs to. | |||
| 317 | This function returns the charset property list of the character set | 319 | This function returns the charset property list of the character set |
| 318 | @var{charset}. Although @var{charset} is a symbol, this is not the same | 320 | @var{charset}. Although @var{charset} is a symbol, this is not the same |
| 319 | as the property list of that symbol. Charset properties are used for | 321 | as the property list of that symbol. Charset properties are used for |
| 320 | special purposes within Emacs; for example, | 322 | special purposes within Emacs. |
| 321 | @code{preferred-coding-system} helps determine which coding system to | ||
| 322 | use to encode characters in a charset. | ||
| 323 | @end defun | 323 | @end defun |
| 324 | 324 | ||
| 325 | @node Chars and Bytes | 325 | @node Chars and Bytes |
| @@ -570,7 +570,7 @@ data, and has the usual three variants which specify the end-of-line | |||
| 570 | conversion. @code{no-conversion} is equivalent to @code{raw-text-unix}: | 570 | conversion. @code{no-conversion} is equivalent to @code{raw-text-unix}: |
| 571 | it specifies no conversion of either character codes or end-of-line. | 571 | it specifies no conversion of either character codes or end-of-line. |
| 572 | 572 | ||
| 573 | The coding system @code{emacs-mule} specifies that the data is | 573 | The coding system @code{utf-8-emacs} specifies that the data is |
| 574 | represented in the internal Emacs encoding. This is like | 574 | represented in the internal Emacs encoding. This is like |
| 575 | @code{raw-text} in that no code conversion happens, but different in | 575 | @code{raw-text} in that no code conversion happens, but different in |
| 576 | that the result is multibyte data. | 576 | that the result is multibyte data. |
| @@ -578,21 +578,22 @@ that the result is multibyte data. | |||
| 578 | @defun coding-system-get coding-system property | 578 | @defun coding-system-get coding-system property |
| 579 | This function returns the specified property of the coding system | 579 | This function returns the specified property of the coding system |
| 580 | @var{coding-system}. Most coding system properties exist for internal | 580 | @var{coding-system}. Most coding system properties exist for internal |
| 581 | purposes, but one that you might find useful is @code{mime-charset}. | 581 | purposes, but one that you might find useful is @code{:mime-charset}. |
| 582 | That property's value is the name used in MIME for the character coding | 582 | That property's value is the name used in MIME for the character coding |
| 583 | which this coding system can read and write. Examples: | 583 | which this coding system can read and write. Examples: |
| 584 | 584 | ||
| 585 | @example | 585 | @example |
| 586 | (coding-system-get 'iso-latin-1 'mime-charset) | 586 | (coding-system-get 'iso-latin-1 :mime-charset) |
| 587 | @result{} iso-8859-1 | 587 | @result{} iso-8859-1 |
| 588 | (coding-system-get 'iso-2022-cn 'mime-charset) | 588 | (coding-system-get 'iso-2022-cn :mime-charset) |
| 589 | @result{} iso-2022-cn | 589 | @result{} iso-2022-cn |
| 590 | (coding-system-get 'cyrillic-koi8 'mime-charset) | 590 | (coding-system-get 'cyrillic-koi8 :mime-charset) |
| 591 | @result{} koi8-r | 591 | @result{} koi8-r |
| 592 | @end example | 592 | @end example |
| 593 | 593 | ||
| 594 | The value of the @code{mime-charset} property is also defined | 594 | The value of the @code{:mime-charset} property is also defined as an |
| 595 | as an alias for the coding system. | 595 | alias for the coding system, but normally coding system base names |
| 596 | should be the same as the MIME charset (lowercased). | ||
| 596 | @end defun | 597 | @end defun |
| 597 | 598 | ||
| 598 | @node Encoding and I/O | 599 | @node Encoding and I/O |
| @@ -939,7 +940,7 @@ of the right way to use the variable: | |||
| 939 | @example | 940 | @example |
| 940 | ;; @r{Read the file with no character code conversion.} | 941 | ;; @r{Read the file with no character code conversion.} |
| 941 | ;; @r{Assume @sc{crlf} represents end-of-line.} | 942 | ;; @r{Assume @sc{crlf} represents end-of-line.} |
| 942 | (let ((coding-system-for-write 'emacs-mule-dos)) | 943 | (let ((coding-system-for-write 'utf-8-emacs-dos)) |
| 943 | (insert-file-contents filename)) | 944 | (insert-file-contents filename)) |
| 944 | @end example | 945 | @end example |
| 945 | 946 | ||