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

Improve documentation of 'define-coding-system'

Browse source 
* lisp/international/mule.el (define-coding-system): Warn against
possible infinite recursion in pre-write-conversion and
post-read-conversion functions.  (Bug#25203)
This commit is contained in:
Eli Zaretskii 2016-12-16 10:49:31 +02:00
parent 467768f64e
commit b19fb4995e
1 changed files with 11 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

13
lisp/international/mule.el
View file

@ -713,7 +713,11 @@ decoded by the coding system itself and before any functions in
`after-insert-functions' are called. This function is passed one `after-insert-functions' are called. This function is passed one
argument: the number of characters in the text to convert, with argument: the number of characters in the text to convert, with
point at the start of the text. The function should leave point point at the start of the text. The function should leave point
unchanged, and should return the new character count. unchanged, and should return the new character count. Note that
this function should avoid reading from files or receiving text
from subprocesses -- anything that could invoke decoding; if it
must do so, it should bind `coding-system-for-read' to a value
other than the current coding-system, to avoid infinite recursion.
`:pre-write-conversion' `:pre-write-conversion'
@ -722,7 +726,12 @@ VALUE must be a function to call after all functions in
called, and before the text is encoded by the coding system called, and before the text is encoded by the coding system
itself. This function should convert the whole text in the itself. This function should convert the whole text in the
current buffer. For backward compatibility, this function is current buffer. For backward compatibility, this function is
passed two arguments which can be ignored. passed two arguments which can be ignored. Note that this
function should avoid writing to files or sending text to
subprocesses -- anything that could invoke encoding; if it
must do so, it should bind `coding-system-for-write' to a
value other than the current coding-system, to avoid infinite
recursion.
`:default-char' `:default-char'