[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs/doc/lispref nonascii.texi
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] emacs/doc/lispref nonascii.texi |
Date: |
Sat, 14 Feb 2009 14:11:38 +0000 |
CVSROOT: /cvsroot/emacs
Module name: emacs
Changes by: Eli Zaretskii <eliz> 09/02/14 14:11:38
Modified files:
doc/lispref : nonascii.texi
Log message:
(User-Chosen Coding Systems): Document that select-safe-coding-system
suggests raw-text if there are raw bytes in the region.
(Explicit Encoding): Warn not to use `undecided' when encoding.
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/nonascii.texi?cvsroot=emacs&r1=1.22&r2=1.23
Patches:
Index: nonascii.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/lispref/nonascii.texi,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -b -r1.22 -r1.23
--- nonascii.texi 7 Feb 2009 11:48:00 -0000 1.22
+++ nonascii.texi 14 Feb 2009 14:11:37 -0000 1.23
@@ -1187,6 +1187,10 @@
@var{from} is a string, the string specifies the text to encode, and
@var{to} is ignored.
+If the specified text includes raw bytes (@pxref{Text
+Representations}), @code{select-safe-coding-system} suggests
address@hidden for its encoding.
+
If @var{default-coding-system} is address@hidden, that is the first
coding system to try; if that can handle the text,
@code{select-safe-coding-system} returns that coding system. It can
@@ -1543,6 +1547,13 @@
buffer remains multibyte if it was multibyte before, and any 8-bit
bytes are converted to their multibyte representation (@pxref{Text
Representations}).
+
address@hidden @code{undecided} coding-system, when encoding
+Do @emph{not} use @code{undecided} for @var{coding-system} when
+encoding text, since that may lead to unexpected results. Instead,
+use @code{select-safe-coding-system} (@pxref{User-Chosen Coding
+Systems, select-safe-coding-system}) to suggest a suitable encoding,
+if there's no obvious pertinent value for @var{coding-system}.
@end deffn
@defun encode-coding-string string coding-system &optional nocopy buffer