procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

(User-Chosen Coding Systems): Document that select-safe-coding-system

Browse source 
suggests raw-text if there are raw bytes in the region.
(Explicit Encoding): Warn not to use `undecided' when encoding.
This commit is contained in:
Eli Zaretskii 2009-02-14 14:12:15 +00:00
parent aff01dd96f
commit 77730170c0
2 changed files with 18 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
doc/lispref/ChangeLog
View file

@ -1,3 +1,10 @@
2009-02-14 Eli Zaretskii <eliz@gnu.org>
* 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 <rgm@gnu.org>
* frames.texi (Visibility of Frames): Mention the effect multiple

11
doc/lispref/nonascii.texi
View file

@ -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