From: Eli Zaretskii Date: Sat, 14 Feb 2009 14:12:15 +0000 (+0000) Subject: (User-Chosen Coding Systems): Document that select-safe-coding-system X-Git-Tag: emacs-pretest-23.0.91~212 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=77730170c0fb941193d3178acb0ffd53c4980140;p=emacs.git (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. --- diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index 3313a74158d..cfff6a23539 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,3 +1,10 @@ +2009-02-14 Eli Zaretskii + + * nonascii.texi (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. + 2009-02-11 Glenn Morris * frames.texi (Visibility of Frames): Mention the effect multiple diff --git a/doc/lispref/nonascii.texi b/doc/lispref/nonascii.texi index 7e4c767ad43..478a9eca060 100644 --- a/doc/lispref/nonascii.texi +++ b/doc/lispref/nonascii.texi @@ -1187,6 +1187,10 @@ is the text in the current buffer between @var{from} and @var{to}. If @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 +@code{raw-text} for its encoding. + If @var{default-coding-system} is non-@code{nil}, 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 @@ The result of encoding is logically a sequence of bytes, but the buffer remains multibyte if it was multibyte before, and any 8-bit bytes are converted to their multibyte representation (@pxref{Text Representations}). + +@cindex @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