Mercurial > emacs
changeset 35807:8e8e96ebe639
(make-coding-system): Add description
about recognized properties in the docstring.
author | Kenichi Handa <handa@m17n.org> |
---|---|
date | Wed, 31 Jan 2001 23:51:49 +0000 |
parents | 1d75f7b1955f |
children | 3507e0283ebb |
files | lisp/international/mule.el |
diffstat | 1 files changed, 58 insertions(+), 1 deletions(-) [+] |
line wrap: on
line diff
--- a/lisp/international/mule.el Wed Jan 31 23:50:06 2001 +0000 +++ b/lisp/international/mule.el Wed Jan 31 23:51:49 2001 +0000 @@ -710,7 +710,64 @@ decoding and encoding. CCL programs should be specified by their symbols. -PROPERTIES is an alist of properties vs the corresponding values. +PROPERTIES is an alist of properties vs the corresponding values. The +following properties are recognized: + + o post-read-conversion + + The value is a function to call after some text is inserted and + decoded by the coding system itself and before any functions in + `after-insert-functions' are called. The arguments to this + function is the same as those of a function in + `after-insert-functions', i.e. LENGTH of a text while putting point + at the head of the text to be decoded + + o pre-write-conversion + + The value is a function to call after all functions in + `write-region-annotate-functions' and `buffer-file-format' are + called, and before the text is encoded by the coding system itself. + The arguments to this function is the same as those of a function + in `write-region-annotate-functions', i.e. FROM and TO specifying + region of a text. + + o translation-table-for-decode + + The value is a translation table to be applied on decoding. See + the function `make-translation-table' for the format of translation + table. + + o translation-table-for-encode + + The value is a translation table to be applied on encoding. + + o safe-chars + + The value is a char table. If a character has non-nil value in it, + the character is safely supported by the coding system. This + overrides the specification of safe-charsets. + + o safe-charsets + + The value is a list of charsets safely supported by the coding + system. The value t means that all charsets Emacs handles are + supported. Even if some charset is not in this list, it doesn't + mean that the charset can't be encoded in the coding system, + instead, it just means that some other receiver of a text encoded + in the coding system won't be able to handle that charset. + + o mime-charset + + The value is a symbol of which name is `MIME-charset' parameter of + the coding system. + + o valid-codes (meaningful only for a coding system based on CCL) + + The value is a list to indicate valid byte ranges of the encoded + file. Each element of the list is an integer or a cons of integer. + In the former case, the integer value is a valid byte code. In the + latter case, the integers specifies the range of valid byte codes. + These properties are set in PLIST, a property list. This function also sets properties `coding-category' and `alias-coding-systems' automatically.