1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-12-02 08:22:22 +00:00

(Coding Conventions): Explain use of coding systems

to ensure one decoding for strings.
This commit is contained in:
Richard M. Stallman 2006-06-10 10:34:35 +00:00
parent f609f34556
commit 4c02cf8619

View File

@ -223,6 +223,31 @@ Lisp, so please don't use it in your programs. (Emacs uses such names
only for special-purpose buffers.) The users will find Emacs more only for special-purpose buffers.) The users will find Emacs more
coherent if all libraries use the same conventions. coherent if all libraries use the same conventions.
@item
If your program contains non-ASCII characters in string or character
constants, you should make sure Emacs always decodes these characters
the same way, regardless of the user's settings. There are two ways
to do that:
@itemize -
@item
Use coding system @code{emacs-mule}, and specify that for
@code{coding} in the @samp{-*-} line or the local variables list.
@example
;; XXX.el -*- coding: emacs-mule; -*-
@end example
@item
Use one of the coding systems based on ISO 2022 (such as
iso-8859-@var{n} and iso-2022-7bit), and specify it with @samp{!} at
the end for @code{coding}. (The @samp{!} turns off any possible
character translation.)
@example
;; XXX.el -*- coding: iso-latin-2!; -*-
@end example
@item @item
Indent each function with @kbd{C-M-q} (@code{indent-sexp}) using the Indent each function with @kbd{C-M-q} (@code{indent-sexp}) using the
default indentation parameters. default indentation parameters.