1 files changed, 8 insertions, 5 deletions

diff --git a/lisp/international/codepage.el b/lisp/international/codepage.el
index 400907f4db7..4816fce0f57 100644
--- a/lisp/international/codepage.el
+++ b/lisp/international/codepage.el
@@ -53,7 +53,9 @@ ENCODER is a translation table for encoding Emacs multibyte characters into
 external DOS codepage codes.
 
 Note that the coding systems created by this function support automatic
-detection of the EOL format."
+detection of the EOL format.  However, the decoders and encoders created
+for these coding systems only support DOS and Unix style EOLs (the -mac
+variety is actually just an alias for the -unix variety)."
   (save-match-data
     (let* ((coding-name (symbol-name coding))
            (ccl-decoder-dos
@@ -409,13 +411,14 @@ character' is generated by (make-char CHARSET OFFSET)."
 
 ;;;###autoload
 (defun cp-make-coding-systems-for-codepage (codepage iso-name offset)
-  "Create 2 coding systems to convert IBM CODEPAGE into charset ISO-NAME
+  "Create a coding system to convert IBM CODEPAGE into charset ISO-NAME
 whose first character is at offset OFFSET from the beginning of 8-bit
 ASCII table.
 
-The two coding systems are identical except for the EOL conversion: one
-of them decodes DOS-style EOLs, the other assumes Unix style and doesn't
-perform any EOL conversions."
+The created coding system has the usual 3 subsidiary systems: for Unix-,
+DOS- and Mac-style EOL conversion.  However, unlike built-in coding
+systems, the Mac-style EOL conversion is currently not supported by the
+decoder and encoder created by this function."
   (let* ((decode-table (intern (format "%s-decode-table" codepage)))
          (nonascii-table
           (intern (format "%s-nonascii-translation-table" codepage)))