Add arch taglines
[bpt/emacs.git] / lisp / international / mule.el
index 1e7fa52..12419ee 100644 (file)
@@ -2,6 +2,7 @@
 
 ;; Copyright (C) 1995 Electrotechnical Laboratory, JAPAN.
 ;; Licensed to the Free Software Foundation.
+;; Copyright (C) 2001, 2002 Free Software Foundation, Inc.
 
 ;; Keywords: mule, multilingual, character set, coding system
 
 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 ;; Boston, MA 02111-1307, USA.
 
+;;; Commentary:
+
 ;;; Code:
 
-(defconst mule-version "5.0 (AOI)" "\
+(defconst mule-version "5.0 (SAKAKI)" "\
 Version number and name of this version of MULE (multilingual environment).")
 
 (defconst mule-version-date "1999.12.7" "\
@@ -61,7 +64,7 @@ Return t if file exists."
            (message "Loading %s (source)..." file)
          (message "Loading %s..." file)))
       (when purify-flag
-       (setq preloaded-file-list (cons file preloaded-file-list)))
+       (push file preloaded-file-list))
       (unwind-protect
          (let ((load-file-name fullname)
                (set-auto-coding-for-load t)
@@ -100,9 +103,8 @@ Return t if file exists."
 
 ;; API (Application Program Interface) for charsets.
 
-;; Return t if OBJ is a quoted symbol
-;; and the symbol is the name of a standard charset.
 (defsubst charset-quoted-standard-p (obj)
+  "Return t if OBJ is a quoted symbol, and is the name of a standard charset."
   (and (listp obj) (eq (car obj) 'quote)
        (symbolp (car-safe (cdr obj)))
        (let ((vector (get (car-safe (cdr obj)) 'charset)))
@@ -138,10 +140,12 @@ LEADING-CODE-BASE (integer) is the base leading-code for the
 LEADING-CODE-EXT (integer) is the extended leading-code for the
   charset.  All charsets of less than 0xA0 has the value 0.
 ISO-FINAL-CHAR (character) is the final character of the
-  corresponding ISO 2022 charset.
+  corresponding ISO 2022 charset.  If the charset is not assigned
+  any final character, the value is -1.
 ISO-GRAPHIC-PLANE (integer) is the graphic plane to be invoked
   while encoding to variants of ISO 2022 coding system, one of the
   following: 0/graphic-plane-left(GL), 1/graphic-plane-right(GR).
+  If the charset is not assigned any final character, the value is -1.
 REVERSE-CHARSET (integer) is the charset which differs only in
   LEFT-TO-RIGHT value from the charset.  If there's no such a
   charset, the value is -1.
@@ -253,16 +257,27 @@ See the function `charset-info' for more detail."
   "Set CHARSET's property list to PLIST, and return PLIST."
   (aset (charset-info  charset) 14 plist))
 
-(defun make-char (charset &optional c1 c2)
-  "Return a character of CHARSET and position codes CODE1 and CODE2.
+(defun make-char (charset &optional code1 code2)
+  "Return a character of CHARSET whose position codes are CODE1 and CODE2.
 CODE1 and CODE2 are optional, but if you don't supply
 sufficient position codes, return a generic character which stands for
 all characters or group of characters in the character set.
-A generic character can be used to index a char table (e.g. syntax-table)."
-  (make-char-internal (charset-id charset) c1 c2))
+A generic character can be used to index a char table (e.g. syntax-table).
+
+Such character sets as ascii, eight-bit-control, and eight-bit-graphic
+don't have corresponding generic characters.  If CHARSET is one of
+them and you don't supply CODE1, return the character of the smallest
+code in CHARSET.
+
+If CODE1 or CODE2 are invalid (out of range), this function signals an
+error.  However, the eighth bit of both CODE1 and CODE2 is zeroed
+before they are used to index CHARSET.  Thus you may use, say, the
+actual ISO 8859 character code rather than subtracting 128, as you
+would need to index the corresponding Emacs charset."
+  (make-char-internal (charset-id charset) code1 code2))
 
 (put 'make-char 'byte-compile
-     (function 
+     (function
       (lambda (form)
        (let ((charset (nth 1 form)))
          (if (charset-quoted-standard-p charset)
@@ -282,14 +297,96 @@ Now we have the variable `charset-list'."
 
 (defsubst generic-char-p (char)
   "Return t if and only if CHAR is a generic character.
-See also the documentation of make-char."
+See also the documentation of `make-char'."
   (and (>= char 0400)
        (let ((l (split-char char)))
         (and (or (= (nth 1 l) 0) (eq (nth 2 l) 0))
              (not (eq (car l) 'composition))))))
 
+(defun decode-char (ccs code-point &optional restriction)
+  "Return character specified by coded character set CCS and CODE-POINT in it.
+Return nil if such a character is not supported.
+Currently the only supported coded character set is `ucs' (ISO/IEC
+10646: Universal Multi-Octet Coded Character Set), and the result is
+translated through the translation-table named
+`utf-translation-table-for-decode' or the translation-hash-table named
+`utf-subst-table-for-decode'.
+
+Optional argument RESTRICTION specifies a way to map the pair of CCS
+and CODE-POINT to a character.  Currently not supported and just ignored."
+  (cond
+   ((eq ccs 'ucs)
+    (or (gethash code-point
+                (get 'utf-subst-table-for-decode 'translation-hash-table))
+       (let ((c (cond
+                 ((< code-point 160)
+                  code-point)
+                 ((< code-point 256)
+                  (make-char 'latin-iso8859-1 code-point))
+                 ((< code-point #x2500)
+                  (setq code-point (- code-point #x0100))
+                  (make-char 'mule-unicode-0100-24ff
+                             (+ (/ code-point 96) 32) (+ (% code-point 96) 32)))
+                 ((< code-point #x3400)
+                  (setq code-point (- code-point #x2500))
+                  (make-char 'mule-unicode-2500-33ff
+                             (+ (/ code-point 96) 32) (+ (% code-point 96) 32)))
+                 ((and (>= code-point #xe000) (< code-point #x10000))
+                  (setq code-point (- code-point #xe000))
+                  (make-char 'mule-unicode-e000-ffff
+                             (+ (/ code-point 96) 32)
+                             (+ (% code-point 96) 32))))))
+         (when c
+           (or (aref (get 'utf-translation-table-for-decode
+                          'translation-table) c)
+               c)))))))
+
+(defun encode-char (char ccs &optional restriction)
+  "Return code-point in coded character set CCS that corresponds to CHAR.
+Return nil if CHAR is not included in CCS.
+Currently the only supported coded character set is `ucs' (ISO/IEC
+10646: Universal Multi-Octet Coded Character Set), and CHAR is first
+translated through the translation-table named
+`utf-translation-table-for-encode' or the translation-hash-table named
+`utf-subst-table-for-encode'.
+
+CHAR should be in one of these charsets:
+  ascii, latin-iso8859-1, mule-unicode-0100-24ff, mule-unicode-2500-33ff,
+  mule-unicode-e000-ffff, eight-bit-control
+Otherwise, return nil.
+
+Optional argument RESTRICTION specifies a way to map CHAR to a
+code-point in CCS.  Currently not supported and just ignored."
+  (let* ((split (split-char char))
+        (charset (car split))
+        trans)
+    (cond ((eq ccs 'ucs)
+          (or (gethash char (get 'utf-subst-table-for-encode
+                                 'translation-hash-table))
+              (let ((table (get 'utf-translation-table-for-encode
+                                'translation-table)))
+                (setq trans (aref table char))
+                (if trans
+                    (setq split (split-char trans)
+                          charset (car split)))
+                (cond ((eq charset 'ascii)
+                       (or trans char))
+                      ((eq charset 'latin-iso8859-1)
+                       (+ (nth 1 split) 128))
+                      ((eq charset 'mule-unicode-0100-24ff)
+                       (+ #x0100 (+ (* (- (nth 1 split) 32) 96)
+                                    (- (nth 2 split) 32))))
+                      ((eq charset 'mule-unicode-2500-33ff)
+                       (+ #x2500 (+ (* (- (nth 1 split) 32) 96)
+                                    (- (nth 2 split) 32))))
+                      ((eq charset 'mule-unicode-e000-ffff)
+                       (+ #xe000 (+ (* (- (nth 1 split) 32) 96)
+                                    (- (nth 2 split) 32))))
+                      ((eq charset 'eight-bit-control)
+                       char))))))))
+
 \f
-;; Coding system staffs
+;; Coding system stuff
 
 ;; Coding system is a symbol that has the property `coding-system'.
 ;;
@@ -297,7 +394,7 @@ See also the documentation of make-char."
 ;; following format:
 ;;     [TYPE MNEMONIC DOC-STRING PLIST FLAGS]
 ;; We call this vector as coding-spec.  See comments in src/coding.c
-;; for more detail.  
+;; for more detail.
 
 (defconst coding-spec-type-idx 0)
 (defconst coding-spec-mnemonic-idx 1)
@@ -313,7 +410,7 @@ See also the documentation of make-char."
 ;; o coding-category
 ;;
 ;; The value is a coding category the coding system belongs to.  The
-;; function `make-coding-system' sets this value automatically 
+;; function `make-coding-system' sets this value automatically
 ;; unless its argument PROPERTIES specifies this property.
 ;;
 ;; o alias-coding-systems
@@ -323,69 +420,21 @@ See also the documentation of make-char."
 ;; `base coding system'.  The function `make-coding-system' sets this
 ;; value automatically and `define-coding-system-alias' updates it.
 ;;
-;; 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
+;; See the documentation of make-coding-system for the meanings of the
+;; following properties.
 ;;
+;; o post-read-conversion
 ;; 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
 ;; 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 charset-origin-alist
-;;
-;; The value is a list of this form:
-;;     (CHARSET EXTERNAL-CHARSET-NAME ENCODING-FUNCTION).
-;; ENCODING-FUNCTION is a function to encode a character in CHARSET
-;; to the code in EXTERNAL-CHARSET-NAME.  The command what-cursor-position
-;; uses this information of the buffer-file-coding-system.
-;; ENCODING-FUNCTION may be a translation table or a symbol whose
-;; property `translation-table' is a translation table.  In these case,
-;; the translation table is used to encode the character.
-;;
 ;; 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.
 
 
-;; Return coding-spec of CODING-SYSTEM
 (defsubst coding-system-spec (coding-system)
+  "Return coding-spec of CODING-SYSTEM."
   (get (check-coding-system coding-system) 'coding-system))
 
 (defun coding-system-type (coding-system)
@@ -429,7 +478,8 @@ for more detail."
            (list prop val)))))
 
 (defun coding-system-category (coding-system)
-  "Return the coding category of CODING-SYSTEM."
+  "Return the coding category of CODING-SYSTEM.
+See also `coding-category-list'."
   (coding-system-get coding-system 'coding-category))
 
 (defun coding-system-base (coding-system)
@@ -463,6 +513,17 @@ detected automatically.  Nth element of the vector is the subsidiary
 coding system whose eol-type is N."
   (get coding-system 'eol-type))
 
+(defun coding-system-eol-type-mnemonic (coding-system)
+  "Return the string indicating end-of-line format of CODING-SYSTEM."
+  (let* ((eol-type (coding-system-eol-type coding-system))
+        (val (cond ((eq eol-type 0) eol-mnemonic-unix)
+                   ((eq eol-type 1) eol-mnemonic-dos)
+                   ((eq eol-type 2) eol-mnemonic-mac)
+                   (t eol-mnemonic-undecided))))
+    (if (stringp val)
+       val
+      (char-to-string val))))
+
 (defun coding-system-lessp (x y)
   (cond ((eq x 'no-conversion) t)
        ((eq y 'no-conversion) nil)
@@ -476,8 +537,8 @@ coding system whose eol-type is N."
                 (and (not (> (downcase c1) (downcase c2)))
                      (< c1 c2)))))))
 
-;; Add CODING-SYSTEM to coding-system-list while keeping it sorted.
 (defun add-to-coding-system-list (coding-system)
+  "Add CODING-SYSTEM to `coding-system-list' while keeping it sorted."
   (if (or (null coding-system-list)
          (coding-system-lessp coding-system (car coding-system-list)))
       (setq coding-system-list (cons coding-system coding-system-list))
@@ -492,8 +553,11 @@ coding system whose eol-type is N."
       (setcdr tem (cons coding-system (cdr tem))))))
 
 (defun coding-system-list (&optional base-only)
-  "Return a list of all existing coding systems.
-If optional arg BASE-ONLY is non-nil, only base coding systems are listed."
+  "Return a list of all existing non-subsidiary coding systems.
+If optional arg BASE-ONLY is non-nil, only base coding systems are listed.
+The value doesn't include subsidiary coding systems which are what
+made from bases and aliases automatically for various end-of-line
+formats (e.g. iso-latin-1-unix, koi8-r-dos)."
   (let* ((codings (copy-sequence coding-system-list))
         (tail (cons nil codings)))
     ;; Remove subsidiary coding systems (eol variants) and alias
@@ -510,8 +574,37 @@ If optional arg BASE-ONLY is non-nil, only base coding systems are listed."
          (setq tail (cdr tail)))))
     codings))
 
-;; Make subsidiary coding systems (eol-type variants) of CODING-SYSTEM.
+(defun map-charset-chars (func charset)
+  "Use FUNC to map over all characters in CHARSET for side effects.
+FUNC is a function of two args, the start and end (inclusive) of a
+character code range.  Thus FUNC should iterate over [START, END]."
+  (let* ((dim (charset-dimension charset))
+        (chars (charset-chars charset))
+        (start (if (= chars 94)
+                   33
+                 32)))
+    (if (= dim 1)
+       (funcall func
+                (make-char charset start)
+                (make-char charset (+ start chars -1)))
+      (dotimes (i chars)
+       (funcall func
+                (make-char charset (+ i start) start)
+                (make-char charset (+ i start) (+ start chars -1)))))))
+
+(defun register-char-codings (coding-system safe-chars)
+  "This is an obsolete function.
+It exists just for backward compatibility, and it does nothing.")
+(make-obsolete 'register-char-codings
+              "Unnecessary function.  Calling it has no effect."
+              "21.3")
+
+(defconst char-coding-system-table nil
+  "This is an obsolete variable.
+It exists just for backward compatibility, and the value is always nil.")
+
 (defun make-subsidiary-coding-system (coding-system)
+  "Make subsidiary coding systems (eol-type variants) of CODING-SYSTEM."
   (let ((coding-spec (coding-system-spec coding-system))
        (subsidiaries (vector (intern (format "%s-unix" coding-system))
                              (intern (format "%s-dos" coding-system))
@@ -528,24 +621,105 @@ If optional arg BASE-ONLY is non-nil, only base coding systems are listed."
       (setq i (1+ i)))
     subsidiaries))
 
+(defun transform-make-coding-system-args (name type &optional doc-string props)
+  "For internal use only.
+Transform XEmacs style args for `make-coding-system' to Emacs style.
+Value is a list of transformed arguments."
+  (let ((mnemonic (string-to-char (or (plist-get props 'mnemonic) "?")))
+       (eol-type (plist-get props 'eol-type))
+       properties tmp)
+    (cond
+     ((eq eol-type 'lf) (setq eol-type 'unix))
+     ((eq eol-type 'crlf) (setq eol-type 'dos))
+     ((eq eol-type 'cr) (setq eol-type 'mac)))
+    (if (setq tmp (plist-get props 'post-read-conversion))
+       (setq properties (plist-put properties 'post-read-conversion tmp)))
+    (if (setq tmp (plist-get props 'pre-write-conversion))
+       (setq properties (plist-put properties 'pre-write-conversion tmp)))
+    (cond
+     ((eq type 'shift-jis)
+      `(,name 1 ,mnemonic ,doc-string () ,properties ,eol-type))
+     ((eq type 'iso2022) ; This is not perfect.
+      (if (plist-get props 'escape-quoted)
+         (error "escape-quoted is not supported: %S"
+                `(,name ,type ,doc-string ,props)))
+      (let ((g0 (plist-get props 'charset-g0))
+           (g1 (plist-get props 'charset-g1))
+           (g2 (plist-get props 'charset-g2))
+           (g3 (plist-get props 'charset-g3))
+           (use-roman
+             (and
+             (eq (cadr (assoc 'latin-jisx0201
+                              (plist-get props 'input-charset-conversion)))
+                 'ascii)
+             (eq (cadr (assoc 'ascii
+                              (plist-get props 'output-charset-conversion)))
+                 'latin-jisx0201)))
+            (use-oldjis
+             (and
+             (eq (cadr (assoc 'japanese-jisx0208-1978
+                              (plist-get props 'input-charset-conversion)))
+                 'japanese-jisx0208)
+             (eq (cadr (assoc 'japanese-jisx0208
+                              (plist-get props 'output-charset-conversion)))
+                 'japanese-jisx0208-1978))))
+       (if (charsetp g0)
+           (if (plist-get props 'force-g0-on-output)
+               (setq g0 `(nil ,g0))
+             (setq g0 `(,g0 t))))
+       (if (charsetp g1)
+           (if (plist-get props 'force-g1-on-output)
+               (setq g1 `(nil ,g1))
+             (setq g1 `(,g1 t))))
+       (if (charsetp g2)
+           (if (plist-get props 'force-g2-on-output)
+               (setq g2 `(nil ,g2))
+             (setq g2 `(,g2 t))))
+       (if (charsetp g3)
+           (if (plist-get props 'force-g3-on-output)
+               (setq g3 `(nil ,g3))
+             (setq g3 `(,g3 t))))
+       `(,name 2 ,mnemonic ,doc-string
+         (,g0 ,g1 ,g2 ,g3
+          ,(plist-get props 'short)
+          ,(not (plist-get props 'no-ascii-eol))
+          ,(not (plist-get props 'no-ascii-cntl))
+          ,(plist-get props 'seven)
+          t
+          ,(not (plist-get props 'lock-shift))
+          ,use-roman
+          ,use-oldjis
+          ,(plist-get props 'no-iso6429)
+          nil nil nil nil)
+       ,properties ,eol-type)))
+     ((eq type 'big5)
+      `(,name 3 ,mnemonic ,doc-string () ,properties ,eol-type))
+     ((eq type 'ccl)
+      `(,name 4 ,mnemonic ,doc-string
+             (,(plist-get props 'decode) . ,(plist-get props 'encode))
+             ,properties ,eol-type))
+     (t
+      (error "unsupported XEmacs style make-coding-style arguments: %S"
+            `(,name ,type ,doc-string ,props))))))
+
 (defun make-coding-system (coding-system type mnemonic doc-string
                                         &optional
                                         flags
                                         properties
                                         eol-type)
   "Define a new coding system CODING-SYSTEM (symbol).
-Remaining arguments are TYPE, MNEMONIC, DOC-STRING, FLAGS (optional), 
+Remaining arguments are TYPE, MNEMONIC, DOC-STRING, FLAGS (optional),
 and PROPERTIES (optional) which construct a coding-spec of CODING-SYSTEM
 in the following format:
        [TYPE MNEMONIC DOC-STRING PLIST FLAGS]
 
 TYPE is an integer value indicating the type of the coding system as follows:
   0: Emacs internal format,
-  1: Shift-JIS (or MS-Kanji) used mainly on Japanese PC,
+  1: Shift-JIS (or MS-Kanji) used mainly on Japanese PCs,
   2: ISO-2022 including many variants,
-  3: Big5 used mainly on Chinese PC,
+  3: Big5 used mainly on Chinese PCs,
   4: private, CCL programs provide encoding/decoding algorithm,
-  5: Raw-text, which means that text contains random 8-bit codes. 
+  5: Raw-text, which means that text contains random 8-bit codes.
 
 MNEMONIC is a character to be displayed on mode line for the coding system.
 
@@ -579,7 +753,8 @@ FLAGS specifies more detailed information of the coding system as follows:
     DESIGNATION-BOL non-nil means designation sequences should be placed
       at beginning of line on output.
     SAFE non-nil means convert unsafe characters to `?' on output.
-      Unsafe characters are what not specified in SAFE-CHARSET.
+      Characters not specified in the property `safe-charsets' nor
+      `safe-chars' are unsafe.
     ACCEPT-LATIN-EXTRA-CODE non-nil means code-detection routine accepts
       a code specified in `latin-extra-code-table' (which see) as a valid
       code of the coding system.
@@ -588,7 +763,75 @@ FLAGS specifies more detailed information of the coding system as follows:
     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 argument of this
+  function is the same as for a function in
+  `after-insert-file-functions', i.e. LENGTH of the text inserted,
+  with 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 are the same as those of a function
+  in `write-region-annotate-functions', i.e. FROM and TO, specifying
+  a region of 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.  This is not applicable to type 4 (CCL-based) coding systems.
+
+  o translation-table-for-encode
+
+  The value is a translation table to be applied on encoding.  This is
+  not applicable to type 4 (CCL-based) coding systems.
+
+  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;
+  it just means that some other receiver of text encoded
+  in the coding system won't be able to handle that charset.
+
+  o mime-charset
+
+  The value is a symbol whose name is the `MIME-charset' parameter of
+  the coding system.
+
+  o mime-text-unsuitable
+
+  A non-nil value means the `mime-charset' property names a charset
+  which is unsuitable for the top-level media type \"text\".
+
+  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 specify the range of valid byte codes.
+
+  o composition (meaningful only when TYPE is 0 or 2)
+
+  If the value is non-nil, the coding system preserves composition
+  information.
+
 These properties are set in PLIST, a property list.  This function
 also sets properties `coding-category' and `alias-coding-systems'
 automatically.
@@ -611,7 +854,7 @@ following formats:
        The EOL type is detected automatically for the coding system.
        And, according to the detected EOL type, one of the coding
        systems in the vector is selected.  Elements of the vector
-       corresponds to Unix-liek EOL, DOS-like EOL, and Mac-like EOL
+       corresponds to Unix-like EOL, DOS-like EOL, and Mac-like EOL
        in this order.
 
 Kludgy features for backward compatibility:
@@ -621,18 +864,32 @@ treated as a compiled CCL code.
 
 2. If PROPERTIES is just a list of character sets, the list is set as
 a value of `safe-charsets' in PLIST."
-  (if (memq coding-system coding-system-list)
-      (error "Coding system %s already exists" coding-system))
+
+  ;; For compatiblity with XEmacs, we check the type of TYPE.  If it
+  ;; is a symbol, perhaps, this function is called with XEmacs-style
+  ;; arguments.  Here, try to transform that kind of arguments to
+  ;; Emacs style.
+  (if (symbolp type)
+      (let ((args (transform-make-coding-system-args coding-system type
+                                                    mnemonic doc-string)))
+       (setq coding-system (car args)
+             type (nth 1 args)
+             mnemonic (nth 2 args)
+             doc-string (nth 3 args)
+             flags (nth 4 args)
+             properties (nth 5 args)
+             eol-type (nth 6 args))))
 
   ;; Set a value of `coding-system' property.
   (let ((coding-spec (make-vector 5 nil))
        (no-initial-designation t)
        (no-alternative-designation t)
+       (accept-latin-extra-code nil)
        coding-category)
     (if (or (not (integerp type)) (< type 0) (> type 5))
        (error "TYPE argument must be 0..5"))
     (if (or (not (integerp mnemonic)) (<= mnemonic ? ) (> mnemonic 127))
-       (error "MNEMONIC argument must be an ASCII printable character."))
+       (error "MNEMONIC argument must be an ASCII printable character"))
     (aset coding-spec coding-spec-type-idx type)
     (aset coding-spec coding-spec-mnemonic-idx mnemonic)
     (aset coding-spec coding-spec-doc-string-idx
@@ -675,6 +932,9 @@ a value of `safe-charsets' in PLIST."
               (setq fl (cdr fl) i (1+ i)))
             (while (and (< i 32) fl)
               (aset vec i (car fl))
+              (if (and (= i 16)        ; ACCEPT-LATIN-EXTRA-CODE
+                       (car fl))
+                  (setq accept-latin-extra-code t))
               (setq fl (cdr fl) i (1+ i)))
             (aset coding-spec 4 vec)
             (setq coding-category
@@ -721,13 +981,53 @@ a value of `safe-charsets' in PLIST."
                   (not (consp (car properties)))))
          ;; In the old version, the arg PROPERTIES is a list to be
          ;; set in PLIST as a value of property `safe-charsets'.
-         (plist-put plist 'safe-charsets properties)
-       ;; In the current version PROPERTIES is a property list.
-       ;; Reflect it into PLIST one by one.
-       (let ((l properties))
-         (while l
-           (plist-put plist (car (car l)) (cdr (car l)))
-           (setq l (cdr l)))))
+         (setq properties (list (cons 'safe-charsets properties))))
+      ;; In the current version PROPERTIES is a property list.
+      ;; Reflect it into PLIST one by one while handling safe-chars
+      ;; specially.
+      (let ((safe-charsets (cdr (assq 'safe-charsets properties)))
+           (safe-chars (cdr (assq 'safe-chars properties)))
+           (l properties)
+           prop val)
+       ;; If only safe-charsets is specified, make a char-table from
+       ;; it, and store that char-table as the value of `safe-chars'.
+       (if (and (not safe-chars) safe-charsets)
+           (let (charset)
+             (if (eq safe-charsets t)
+                 (setq safe-chars t)
+               (setq safe-chars (make-char-table 'safe-chars))
+               (while safe-charsets
+                 (setq charset (car safe-charsets)
+                       safe-charsets (cdr safe-charsets))
+                 (cond ((eq charset 'ascii)) ; just ignore
+                       ((eq charset 'eight-bit-control)
+                        (let ((i 128))
+                          (while (< i 160)
+                            (aset safe-chars i t)
+                            (setq i (1+ i)))))
+                       ((eq charset 'eight-bit-graphic)
+                        (let ((i 160))
+                          (while (< i 256)
+                            (aset safe-chars i t)
+                            (setq i (1+ i)))))
+                       (t
+                        (aset safe-chars (make-char charset) t))))
+               (if accept-latin-extra-code
+                   (let ((i 128))
+                     (while (< i 160)
+                       (if (aref latin-extra-code-table i)
+                           (aset safe-chars i t))
+                       (setq i (1+ i))))))
+             (setq l (cons (cons 'safe-chars safe-chars) l))))
+       (while l
+         (setq prop (car (car l)) val (cdr (car l)) l (cdr l))
+         (if (eq prop 'safe-chars)
+             (progn
+               (if (and (symbolp val)
+                        (get val 'translation-table))
+                   (setq safe-chars (get val 'translation-table)))
+               (setq val safe-chars)))
+         (plist-put plist prop val)))
       ;; The property `coding-category' may have been set differently
       ;; through PROPERTIES.
       (setq coding-category (plist-get plist 'coding-category))
@@ -737,8 +1037,7 @@ a value of `safe-charsets' in PLIST."
         (cons coding-system (get coding-category 'coding-systems))))
 
   ;; Next, set a value of `eol-type' property.
-  (if (and (not eol-type)
-          (or (<= type 3) (= type 5)))
+  (if (not eol-type)
       ;; If EOL-TYPE is nil, set a vector of subsidiary coding
       ;; systems, each corresponds to a coding system for the detected
       ;; EOL format.
@@ -760,6 +1059,8 @@ a value of `safe-charsets' in PLIST."
               (error "Invalid EOL-TYPE spec:%S" eol-type))))
   (put coding-system 'eol-type eol-type)
 
+  (define-coding-system-internal coding-system)
+
   ;; At last, register CODING-SYSTEM in `coding-system-list' and
   ;; `coding-system-alist'.
   (add-to-coding-system-list coding-system)
@@ -772,56 +1073,107 @@ a value of `safe-charsets' in PLIST."
     (if (or (eq coding-category 'coding-category-iso-8-1)
            (eq coding-category 'coding-category-iso-8-2))
        (let ((esc (intern (concat (symbol-name coding-system) "-with-esc")))
-             (doc (format "Same as %s but can handle any charsets by ISO's escape sequences." coding-system)))
+             (doc (format "Same as %s but can handle any charsets by ISO's escape sequences." coding-system))
+             (safe-charsets (assq 'safe-charsets properties))
+             (mime-charset (assq 'mime-charset properties)))
+         (if safe-charsets
+             (setcdr safe-charsets t)
+           (setq properties (cons (cons 'safe-charsets t) properties)))
+         (if mime-charset
+             (setcdr mime-charset nil))
          (make-coding-system esc type mnemonic doc
                              (if (listp (car flags))
                                  (cons (append (car flags) '(t)) (cdr flags))
                                (cons (list (car flags) t) (cdr flags)))
-                             properties)
-         (coding-system-put esc 'mime-charset nil)
-         (coding-system-put esc 'safe-charsets t))))
+                             properties))))
 
   coding-system)
 
+(put 'safe-chars 'char-table-extra-slots 0)
+
 (defun define-coding-system-alias (alias coding-system)
   "Define ALIAS as an alias for coding system CODING-SYSTEM."
   (put alias 'coding-system (coding-system-spec coding-system))
-  (nconc (coding-system-get alias 'alias-coding-systems) (list alias))
   (add-to-coding-system-list alias)
   (setq coding-system-alist (cons (list (symbol-name alias))
                                  coding-system-alist))
   (let ((eol-type (coding-system-eol-type coding-system)))
     (if (vectorp eol-type)
-       (put alias 'eol-type (make-subsidiary-coding-system alias))
+       (progn
+         (nconc (coding-system-get alias 'alias-coding-systems) (list alias))
+         (put alias 'eol-type (make-subsidiary-coding-system alias)))
       (put alias 'eol-type eol-type))))
 
+(defun merge-coding-systems (first second)
+  "Fill in any unspecified aspects of coding system FIRST from SECOND.
+Return the resulting coding system."
+  (let ((base (coding-system-base second))
+       (eol (coding-system-eol-type second)))
+    ;; If FIRST doesn't specify text conversion, merge with that of SECOND.
+    (if (eq (coding-system-base first) 'undecided)
+       (setq first (coding-system-change-text-conversion first base)))
+    ;; If FIRST doesn't specify eol conversion, merge with that of SECOND.
+    (if (and (vectorp (coding-system-eol-type first))
+            (numberp eol) (>= eol 0) (<= eol 2))
+       (setq first (coding-system-change-eol-conversion
+                    first eol)))
+    first))
+
 (defun set-buffer-file-coding-system (coding-system &optional force)
   "Set the file coding-system of the current buffer to CODING-SYSTEM.
 This means that when you save the buffer, it will be converted
 according to CODING-SYSTEM.  For a list of possible values of CODING-SYSTEM,
 use \\[list-coding-systems].
 
-If the buffer's previous file coding-system value specifies end-of-line
-conversion, and CODING-SYSTEM does not specify one, CODING-SYSTEM is
-merged with the already-specified end-of-line conversion.
-However, if the optional prefix argument FORCE is non-nil,
-then CODING-SYSTEM is used exactly as specified.
+If CODING-SYSTEM leaves the text conversion unspecified, or if it
+leaves the end-of-line conversion unspecified, FORCE controls what to
+do.  If FORCE is nil, get the unspecified aspect (or aspects) from the
+buffer's previous `buffer-file-coding-system' value (if it is
+specified there).  Otherwise, leave it unspecified.
 
 This marks the buffer modified so that the succeeding \\[save-buffer]
 surely saves the buffer with CODING-SYSTEM.  From a program, if you
 don't want to mark the buffer modified, just set the variable
 `buffer-file-coding-system' directly."
-  (interactive "zCoding system for visited file (default, nil): \nP")
+  (interactive "zCoding system for saving file (default, nil): \nP")
   (check-coding-system coding-system)
-  (if (null force)
-      (let ((x (coding-system-eol-type buffer-file-coding-system))
-           (y (coding-system-eol-type coding-system)))
-       (if (and (numberp x) (>= x 0) (<= x 2) (vectorp y))
-           (setq coding-system (aref y x)))))
+  (if (and coding-system buffer-file-coding-system (null force))
+      (setq coding-system
+           (merge-coding-systems coding-system buffer-file-coding-system)))
   (setq buffer-file-coding-system coding-system)
+  ;; This is in case of an explicit call.  Normally, `normal-mode' and
+  ;; `set-buffer-major-mode-hook' take care of setting the table.
+  (if (fboundp 'ucs-set-table-for-input) ; don't lose when building
+      (ucs-set-table-for-input))
   (set-buffer-modified-p t)
   (force-mode-line-update))
 
+(defun revert-buffer-with-coding-system (coding-system &optional force)
+  "Visit the current buffer's file again using coding system CODING-SYSTEM.
+For a list of possible values of CODING-SYSTEM, use \\[list-coding-systems].
+
+If CODING-SYSTEM leaves the text conversion unspecified, or if it
+leaves the end-of-line conversion unspecified, FORCE controls what to
+do.  If FORCE is nil, get the unspecified aspect (or aspects) from the
+buffer's previous `buffer-file-coding-system' value (if it is
+specified there).  Otherwise, determine it from the file contents as
+usual for visiting a file."
+  (interactive "zCoding system for visited file (default, nil): \nP")
+  (check-coding-system coding-system)
+  (if (and coding-system buffer-file-coding-system (null force))
+      (setq coding-system
+           (merge-coding-systems coding-system buffer-file-coding-system)))
+  (let ((coding-system-for-read coding-system))
+    (revert-buffer)))
+
+(defun set-file-name-coding-system (coding-system)
+  "Set coding system for decoding and encoding file names to CODING-SYSTEM.
+It actually just set the variable `file-name-coding-system' (which
+see) to CODING-SYSTEM."
+  (interactive "zCoding system for file names (default, nil): ")
+  (check-coding-system coding-system)
+  (setq file-name-coding-system coding-system))
+
 (defvar default-terminal-coding-system nil
   "Default value for the terminal coding system.
 This is normally set according to the selected language environment.
@@ -846,7 +1198,7 @@ or by the previous use of this command."
           (not (terminal-coding-system)))
       (setq coding-system default-terminal-coding-system))
   (if coding-system
-      (setq default-terminal-coding-system coding-system))      
+      (setq default-terminal-coding-system coding-system))
   (set-terminal-coding-system-internal coding-system)
   (redraw-frame (selected-frame)))
 
@@ -858,7 +1210,8 @@ See also the command `set-keyboard-coding-system'.")
 (defun set-keyboard-coding-system (coding-system)
   "Set coding system for keyboard input to CODING-SYSTEM.
 In addition, this command enables Encoded-kbd minor mode.
-\(If CODING-SYSTEM is nil, Encoded-kbd mode is turned off.)
+\(If CODING-SYSTEM is nil, Encoded-kbd mode is turned off -- see
+`encoded-kbd-mode'.)
 For a list of possible values of CODING-SYSTEM, use \\[list-coding-systems].
 The default is determined by the selected language environment
 or by the previous use of this command."
@@ -876,8 +1229,31 @@ or by the previous use of this command."
   (if coding-system
       (setq default-keyboard-coding-system coding-system))
   (set-keyboard-coding-system-internal coding-system)
+  (setq keyboard-coding-system coding-system)
   (encoded-kbd-mode (if coding-system 1 0)))
 
+(defcustom keyboard-coding-system nil
+  "Specify coding system for keyboard input.
+If you set this on a terminal which can't distinguish Meta keys from
+8-bit characters, you will have to use ESC to type Meta characters.
+See Info node `Specify Coding' and Info node `Single-Byte Character Support'.
+
+On non-windowing terminals, this is set from the locale by default.
+
+Setting this variable directly does not take effect;
+use either M-x customize or \\[set-keyboard-coding-system]."
+  :type '(coding-system :tag "Coding system")
+  :link '(info-link "(emacs)Specify Coding")
+  :link '(info-link "(emacs)Single-Byte Character Support")
+  :set (lambda (symbol value)
+        ;; Don't load encoded-kbd-mode unnecessarily.
+        (if (or value (boundp 'encoded-kbd-mode))
+            (set-keyboard-coding-system value)
+          (set-default 'keyboard-coding-system nil))) ; must initialize
+  :version "21.4"
+  :group 'keyboard
+  :group 'mule)
+
 (defun set-buffer-process-coding-system (decoding encoding)
   "Set coding systems for the process associated with the current buffer.
 DECODING is the coding system to be used to decode input from the process,
@@ -885,10 +1261,10 @@ ENCODING is the coding system to be used to encode output to the process.
 
 For a list of possible values of CODING-SYSTEM, use \\[list-coding-systems]."
   (interactive
-   "zCoding-system for process input: \nzCoding-system for process output: ")
+   "zCoding-system for output from the process: \nzCoding-system for input to the process: ")
   (let ((proc (get-buffer-process (current-buffer))))
     (if (null proc)
-       (error "no process")
+       (error "No process")
       (check-coding-system decoding)
       (check-coding-system encoding)
       (set-process-coding-system proc decoding encoding)))
@@ -897,7 +1273,7 @@ For a list of possible values of CODING-SYSTEM, use \\[list-coding-systems]."
 (defalias 'set-clipboard-coding-system 'set-selection-coding-system)
 
 (defun set-selection-coding-system (coding-system)
-  "Make CODING-SYSTEM used for communicating with other X clients .
+  "Make CODING-SYSTEM used for communicating with other X clients.
 When sending or receiving text via cut_buffer, selection, and clipboard,
 the text is encoded or decoded by CODING-SYSTEM."
   (interactive "zCoding system for X selection: ")
@@ -926,8 +1302,8 @@ This setting is effective for the next communication only."
   (setq next-selection-coding-system coding-system))
 
 (defun set-coding-priority (arg)
-  "Set priority of coding categories according to LIST.
-LIST is a list of coding categories ordered by priority."
+  "Set priority of coding categories according to ARG.
+ARG is a list of coding categories ordered by priority."
   (let ((l arg)
        (current-list (copy-sequence coding-category-list)))
     ;; Check the validity of ARG while deleting coding categories in
@@ -943,18 +1319,246 @@ LIST is a list of coding categories ordered by priority."
     (setq coding-category-list (append arg current-list))
     (set-coding-priority-internal)))
 
+;;; X selections
+
+(defvar ctext-non-standard-encodings-alist
+  '(("ISO8859-15" . latin-iso8859-15)
+    ("ISO8859-14" . latin-iso8859-14)
+    ("KOI8-R" . koi8-r)
+    ("BIG5-0" . big5))
+  "Alist of non-standard encoding names vs Emacs coding systems.
+This alist is used to decode an extened segment of a compound text.")
+
+(defvar ctext-non-standard-encodings-regexp
+  (string-to-multibyte
+   (concat
+    ;; For non-standard encodings.
+    "\\(\e%/[0-4][\200-\377][\200-\377]\\([^\002]+\\)\002\\)"
+    "\\|"
+    ;; For UTF-8 encoding.
+    "\\(\e%G[^\e]*\e%@\\)")))
+
+;; Functions to support "Non-Standard Character Set Encodings" defined
+;; by the COMPOUND-TEXT spec.
+;; We support that by decoding the whole data by `ctext' which just
+;; pertains byte sequences belonging to ``extended segment'', then
+;; decoding those byte sequences one by one in Lisp.
+;; This function also supports "The UTF-8 encoding" described in the
+;; section 7 of the documentation fo COMPOUND-TEXT distributed with
+;; XFree86.
+
+(defun ctext-post-read-conversion (len)
+  "Decode LEN characters encoded as Compound Text with Extended Segments."
+  (save-match-data
+    (save-restriction
+      (let ((case-fold-search nil)
+           (in-workbuf (string= (buffer-name) " *code-converting-work*"))
+           last-coding-system-used
+           pos bytes)
+       (or in-workbuf
+           (narrow-to-region (point) (+ (point) len)))
+       (decode-coding-region (point-min) (point-max) 'ctext)
+       (if in-workbuf
+           (set-buffer-multibyte t))
+       (while (re-search-forward ctext-non-standard-encodings-regexp
+                                 nil 'move)
+         (setq pos (match-beginning 0))
+         (if (match-beginning 1)
+             ;; ESC % / [0-4] M L --ENCODING-NAME-- \002 --BYTES--
+             (let* ((M (char-after (+ pos 4)))
+                    (L (char-after (+ pos 5)))
+                    (encoding (match-string 2))
+                    (coding (or (cdr (assoc-ignore-case 
+                                      encoding
+                                      ctext-non-standard-encodings-alist))
+                                (coding-system-p
+                                 (intern (downcase encoding))))))
+               (setq bytes (- (+ (* (- M 128) 128) (- L 128))
+                              (- (point) (+ pos 6))))
+               (when coding
+                 (delete-region pos (point))
+                 (forward-char bytes)
+                 (decode-coding-region (- (point) bytes) (point) coding)))
+           ;; ESC % G --UTF-8-BYTES-- ESC % @
+           (setq bytes (- (point) pos))
+           (decode-coding-region (- (point) bytes) (point) 'utf-8))))
+      (goto-char (point-min))
+      (- (point-max) (point)))))
+
+;; From X registry 2001/06/01
+;; 20. NON-STANDARD CHARACTER SET ENCODINGS
+
+;; See Section 6 of the Compound Text standard.
+
+;; Name                                                Reference
+;; ----                                                ---------
+;; "DEC.CNS11643.1986-2"                               [53]
+;;     CNS11643 2-plane using the recommended
+;;     internal representation scheme
+;; "DEC.DTSCS.1990-2"                          [54]
+;;     DEC Taiwan Supplemental Character Set
+;; "fujitsu.u90x03"                            [87]
+;; "ILA"                                               [62]
+;;     registry prefix
+;; "IPSYS"                                             [59]
+;;     registry prefix
+;; "omron_UDC"                                 [45]
+;;         omron User Defined Charset
+;; "omron_UDC_ja"                                      [45]
+;;         omron User Defined Charset for Japanese
+;; "omron_UDC_zh"                                      [45]
+;;         omron User Defined Charset for Chinese(Main land)
+;; "omron_UDC_tw"                                      [45]
+;;         omron User Defined Charset for Chinese(Taiwan)
+
+;; If you add charsets here, be sure to modify the regexp used by
+;; ctext-pre-write-conversion to look up non-standard charsets.
+(defvar ctext-non-standard-designations-alist
+  '(("$(0" . (big5 "big5-0" 2))
+    ("$(1" . (big5 "big5-0" 2))
+    ;; The following are actually standard; generating extended
+    ;; segments for them is wrong and screws e.g. Latin-9 users.
+    ;; 8859-{10,13,16} aren't Emacs charsets anyhow.  -- fx
+;;     ("-V"  . (t "iso8859-10" 1))
+;;     ("-Y"  . (t "iso8859-13" 1))
+;;     ("-_"  . (t "iso8859-14" 1))
+;;     ("-b"  . (t "iso8859-15" 1))
+;;     ("-f"  . (t "iso8859-16" 1))
+    )
+  "Alist of ctext control sequences that introduce character sets which
+are not in the list of approved encodings, and the corresponding
+coding system, identifier string, and number of octets per encoded
+character.
+
+Each element has the form (CTLSEQ . (ENCODING CHARSET NOCTETS)).  CTLSEQ
+is the control sequence (sans the leading ESC) that introduces the character
+set in the text encoded by compound-text.  ENCODING is a coding system
+symbol; if it is t, it means that the ctext coding system already encodes
+the text correctly, and only the leading control sequence needs to be altered.
+If ENCODING is a coding system, we need to re-encode the text with that
+coding system.  CHARSET is the name of the charset we need to put into
+the leading control sequence.  NOCTETS is the number of octets (bytes) that
+encode each character in this charset.  NOCTETS can be 0 (meaning the number
+of octets per character is variable), 1, 2, 3, or 4.")
+
+(defun ctext-pre-write-conversion (from to)
+  "Encode characters between FROM and TO as Compound Text w/Extended Segments.
+
+If FROM is a string, or if the current buffer is not the one set up for us
+by encode-coding-string, generate a new temp buffer, insert the
+text, and convert it in the temporary buffer.  Otherwise, convert in-place."
+  (save-match-data
+    ;; Setup a working buffer if necessary.
+    (cond ((stringp from)
+          (let ((buf (current-buffer)))
+            (set-buffer (generate-new-buffer " *temp"))
+            (set-buffer-multibyte (multibyte-string-p from))
+            (insert from)))
+         ((not (string= (buffer-name) " *code-converting-work*"))
+          (let ((buf (current-buffer))
+                (multibyte enable-multibyte-characters))
+            (set-buffer (generate-new-buffer " *temp"))
+            (set-buffer-multibyte multibyte)
+            (insert-buffer-substring buf from to))))
+
+    ;; Now we can encode the whole buffer.
+    (let ((case-fold-search nil)
+         last-coding-system-used
+         pos posend desig encode-info encoding chset noctets textlen)
+      (goto-char (point-min))
+      ;; At first encode the whole buffer.
+      (encode-coding-region (point-min) (point-max) 'ctext-no-compositions)
+      ;; Then replace ISO-2022 charset designations with extended
+      ;; segments, for those charsets that are not part of the
+      ;; official X registry.  The regexp below finds the leading
+      ;; sequences for big5.
+      (while (re-search-forward "\e\\(\$([01]\\)" nil 'move)
+       (setq pos (match-beginning 0)
+             posend (point)
+             desig (match-string 1)
+             encode-info (cdr (assoc desig
+                                     ctext-non-standard-designations-alist))
+             encoding (car encode-info)
+             chset (cadr encode-info)
+             noctets (car (cddr encode-info)))
+       (skip-chars-forward "^\e")
+       (cond
+        ((eq encoding t)  ; only the leading sequence needs to be changed
+         (setq textlen (+ (- (point) posend) (length chset) 1))
+         ;; Generate the control sequence for an extended segment.
+         (replace-match (format "\e%%/%d%c%c%s\ 2"
+                                noctets
+                                (+ (/ textlen 128) 128)
+                                (+ (% textlen 128) 128)
+                                chset)
+                        t t))
+        ((coding-system-p encoding) ; need to recode the entire segment...
+         (decode-coding-region pos (point) 'ctext-no-compositions)
+         (encode-coding-region pos (point) encoding)
+         (setq textlen (+ (- (point) pos) (length chset) 1))
+         (save-excursion
+           (goto-char pos)
+           (insert (format "\e%%/%d%c%c%s\ 2"
+                           noctets
+                           (+ (/ textlen 128) 128)
+                           (+ (% textlen 128) 128)
+                           chset))))))
+      (goto-char (point-min))))
+  ;; Must return nil, as build_annotations_2 expects that.
+  nil)
+
 ;;; FILE I/O
 
-(defvar auto-coding-alist
-  '(("\\.\\(arc\\|zip\\|lzh\\|zoo\\|jar\\|tar\\|tgz\\)\\'" . no-conversion)
-    ("\\.\\(ARC\\|ZIP\\|LZH\\|ZOO\\|JAR\\|TAR\\|TGZ\\)\\'" . no-conversion))
+(defcustom auto-coding-alist
+  '(("\\.\\(arc\\|zip\\|lzh\\|zoo\\|jar\\|sx[dmicw]\\|tar\\|tgz\\)\\'" . no-conversion)
+    ("\\.\\(gz\\|Z\\|bz\\|bz2\\|gpg\\)\\'" . no-conversion)
+    ("/#[^/]+#\\'" . emacs-mule))
   "Alist of filename patterns vs corresponding coding systems.
 Each element looks like (REGEXP . CODING-SYSTEM).
 A file whose name matches REGEXP is decoded by CODING-SYSTEM on reading.
 
 The settings in this alist take priority over `coding:' tags
 in the file (see the function `set-auto-coding')
-and the contents of `file-coding-system-alist'.")
+and the contents of `file-coding-system-alist'."
+  :group 'files
+  :group 'mule
+  :type '(repeat (cons (regexp :tag "File name regexp")
+                      (symbol :tag "Coding system"))))
+
+(defcustom auto-coding-regexp-alist
+  '(("^BABYL OPTIONS:[ \t]*-\\*-[ \t]*rmail[ \t]*-\\*-" . no-conversion))
+  "Alist of patterns vs corresponding coding systems.
+Each element looks like (REGEXP . CODING-SYSTEM).
+A file whose first bytes match REGEXP is decoded by CODING-SYSTEM on reading.
+
+The settings in this alist take priority over `coding:' tags
+in the file (see the function `set-auto-coding')
+and the contents of `file-coding-system-alist'."
+  :group 'files
+  :group 'mule
+  :type '(repeat (cons (regexp :tag "Regexp")
+                      (symbol :tag "Coding system"))))
+
+;; See the bottom of this file for built-in auto coding functions.
+(defcustom auto-coding-functions '(sgml-xml-auto-coding-function
+                                  sgml-html-meta-auto-coding-function)
+  "A list of functions which attempt to determine a coding system.
+
+Each function in this list should be written to operate on the
+current buffer, but should not modify it in any way.  The buffer
+will contain undecoded text of parts of the file.  Each function
+should take one argument, SIZE, which says how many
+characters (starting from point) it should look at.
+
+If one of these functions succeeds in determining a coding
+system, it should return that coding system.  Otherwise, it
+should return nil.
+
+If a file has a `coding:' tag, that takes precedence over these
+functions, so they won't be called at all."
+  :group 'files
+  :group 'mule
+  :type '(repeat function))
 
 (defvar set-auto-coding-for-load nil
   "Non-nil means look for `load-coding' property instead of `coding'.
@@ -963,7 +1567,7 @@ This is used for loading and byte-compiling Emacs Lisp files.")
 (defun auto-coding-alist-lookup (filename)
   "Return the coding system specified by `auto-coding-alist' for FILENAME."
   (let ((alist auto-coding-alist)
-       (case-fold-search (memq system-type '(vax-vms windows-nt ms-dos)))
+       (case-fold-search (memq system-type '(vax-vms windows-nt ms-dos cygwin)))
        coding-system)
     (while (and alist (not coding-system))
       (if (string-match (car (car alist)) filename)
@@ -976,129 +1580,147 @@ This is used for loading and byte-compiling Emacs Lisp files.")
 These bytes should include at least the first 1k of the file
 and the last 3k of the file, but the middle may be omitted.
 
-It checks FILENAME against the variable `auto-coding-alist'.
-If FILENAME doesn't match any entries in the variable,
-it checks for a `coding:' tag in the first one or two lines following
-point.  If no `coding:' tag is found, it checks for local variables
-list in the last 3K bytes out of the SIZE bytes.
+The function checks FILENAME against the variable `auto-coding-alist'.
+If FILENAME doesn't match any entries in the variable, it checks the
+contents of the current buffer following point against
+`auto-coding-regexp-alist'.  If no match is found, it checks for a
+`coding:' tag in the first one or two lines following point.  If no
+`coding:' tag is found, it checks any local variables list in the last
+3K bytes out of the SIZE bytes.  Finally, if none of these methods
+succeed, it checks to see if any function in `auto-coding-functions'
+gives a match.
 
-The return value is the specified coding system,
-or nil if nothing specified.
+The return value is the specified coding system, or nil if nothing is
+specified.
 
 The variable `set-auto-coding-function' (which see) is set to this
 function by default."
-  (let ((coding-system (auto-coding-alist-lookup filename)))
-
-    (or coding-system
-       (let* ((case-fold-search t)
-              (head-start (point))
-              (head-end (+ head-start (min size 1024)))
-              (tail-start (+ head-start (max (- size 3072) 0)))
-              (tail-end (+ head-start size))
-              coding-system head-found tail-found pos)
-         ;; Try a short cut by searching for the string "coding:"
-         ;; and for "unibyte:" at the head and tail of SIZE bytes.
-         (setq head-found (or (search-forward "coding:" head-end t)
-                              (search-forward "unibyte:" head-end t)))
-         (if (and head-found (> head-found tail-start))
-             ;; Head and tail are overlapped.
-             (setq tail-found head-found)
-           (goto-char tail-start)
-           (setq tail-found (or (search-forward "coding:" tail-end t)
-                                (search-forward "unibyte:" tail-end t))))
-
-         ;; At first check the head.
-         (when head-found
+  (or (auto-coding-alist-lookup filename)
+      ;; Try using `auto-coding-regexp-alist'.
+      (save-excursion
+       (let ((alist auto-coding-regexp-alist)
+             coding-system)
+         (while (and alist (not coding-system))
+           (let ((regexp (car (car alist))))
+             (when (re-search-forward regexp (+ (point) size) t)
+               (setq coding-system (cdr (car alist)))))
+           (setq alist (cdr alist)))
+         coding-system))
+      (let* ((case-fold-search t)
+            (head-start (point))
+            (head-end (+ head-start (min size 1024)))
+            (tail-start (+ head-start (max (- size 3072) 0)))
+            (tail-end (+ head-start size))
+            coding-system head-found tail-found pos)
+       ;; Try a short cut by searching for the string "coding:"
+       ;; and for "unibyte:" at the head and tail of SIZE bytes.
+       (setq head-found (or (search-forward "coding:" head-end t)
+                            (search-forward "unibyte:" head-end t)))
+       (if (and head-found (> head-found tail-start))
+           ;; Head and tail are overlapped.
+           (setq tail-found head-found)
+         (goto-char tail-start)
+         (setq tail-found (or (search-forward "coding:" tail-end t)
+                              (search-forward "unibyte:" tail-end t))))
+
+       ;; At first check the head.
+       (when head-found
+         (goto-char head-start)
+         (setq head-end (set-auto-mode-1))
+         (setq head-start (point))
+         (when (and head-end (< head-found head-end))
            (goto-char head-start)
-           (setq pos (re-search-forward "[\n\r]" head-end t))
-           (if (and pos
-                    (= (char-after head-start) ?#)
-                    (= (char-after (1+ head-start)) ?!))
-               ;; If the file begins with "#!" (exec interpreter magic),
-               ;; look for coding frobs in the first two lines.  You cannot
-               ;; necessarily put them in the first line of such a file
-               ;; without screwing up the interpreter invocation.
-               (setq pos (search-forward "\n" head-end t)))
-           (if pos (setq head-end pos))
-           (when (< head-found head-end)
-             (goto-char head-start)
-             (when (and set-auto-coding-for-load
-                        (re-search-forward
-                         "-\\*-\\(.*;\\)?[ \t]*unibyte:[ \t]*\\([^ ;]+\\)"
-                         head-end t))
-               (setq coding-system 'raw-text))
-             (when (and (not coding-system)
-                        (re-search-forward
-                         "-\\*-\\(.*;\\)?[ \t]*coding:[ \t]*\\([^ ;]+\\)"
-                         head-end t))
-               (setq coding-system (intern (match-string 2)))
-               (or (coding-system-p coding-system)
-                   (setq coding-system nil)))))
-
-         ;; If no coding: tag in the head, check the tail.
-         (when (and tail-found (not coding-system))
-           (goto-char tail-start)
-           (search-forward "\n\^L" nil t)
-           (if (re-search-forward
-                "^\\(.*\\)[ \t]*Local Variables:[ \t]*\\(.*\\)$" tail-end t)
-               ;; The prefix is what comes before "local variables:" in its
-               ;; line.  The suffix is what comes after "local variables:"
-               ;; in its line.
-               (let* ((prefix (regexp-quote (match-string 1)))
-                      (suffix (regexp-quote (match-string 2)))
-                      (re-coding
-                       (concat
-                        "^" prefix
-                        "[ \t]*coding[ \t]*:[ \t]*\\([^ \t]+\\)[ \t]*"
-                        suffix "$"))
-                      (re-unibyte
-                       (concat
-                        "^" prefix
-                        "[ \t]*unibyte[ \t]*:[ \t]*\\([^ \t]+\\)[ \t]*"
-                        suffix "$"))
-                      (re-end
-                       (concat "^" prefix "[ \t]*end *:[ \t]*" suffix "$"))
-                      (pos (point)))
-                 (re-search-forward re-end tail-end 'move)
-                 (setq tail-end (point))
-                 (goto-char pos)
-                 (when (and set-auto-coding-for-load
-                            (re-search-forward re-unibyte tail-end t))
-                   (setq coding-system 'raw-text))
-                 (when (and (not coding-system)
-                            (re-search-forward re-coding tail-end t))
-                   (setq coding-system (intern (match-string 1)))
-                   (or (coding-system-p coding-system)
-                       (setq coding-system nil))))))
-         coding-system))))
+           (when (and set-auto-coding-for-load
+                      (re-search-forward
+                       "\\(.*;\\)?[ \t]*unibyte:[ \t]*\\([^ ;]+\\)"
+                       head-end t))
+             (setq coding-system 'raw-text))
+           (when (and (not coding-system)
+                      (re-search-forward
+                       "\\(.*;\\)?[ \t]*coding:[ \t]*\\([^ ;]+\\)"
+                       head-end t))
+             (setq coding-system (intern (match-string 2)))
+             (or (coding-system-p coding-system)
+                 (setq coding-system nil)))))
+
+       ;; If no coding: tag in the head, check the tail.
+       (when (and tail-found (not coding-system))
+         (goto-char tail-start)
+         (search-forward "\n\^L" nil t)
+         (if (re-search-forward
+              "^\\(.*\\)[ \t]*Local Variables:[ \t]*\\(.*\\)$" tail-end t)
+         ;; The prefix is what comes before "local variables:" in its
+          ;; line.  The suffix is what comes after "local variables:"
+             ;; in its line.
+             (let* ((prefix (regexp-quote (match-string 1)))
+                    (suffix (regexp-quote (match-string 2)))
+                    (re-coding
+                     (concat
+                      "^" prefix
+                      ;; N.B. without the \n below, the regexp can
+                      ;; eat newlines.
+                      "[ \t]*coding[ \t]*:[ \t]*\\([^ \t\n]+\\)[ \t]*"
+                      suffix "$"))
+                    (re-unibyte
+                     (concat
+                      "^" prefix
+                      "[ \t]*unibyte[ \t]*:[ \t]*\\([^ \t\n]+\\)[ \t]*"
+                      suffix "$"))
+                    (re-end
+                     (concat "^" prefix "[ \t]*End *:[ \t]*" suffix "$"))
+                    (pos (point)))
+               (re-search-forward re-end tail-end 'move)
+               (setq tail-end (point))
+               (goto-char pos)
+               (when (and set-auto-coding-for-load
+                          (re-search-forward re-unibyte tail-end t))
+                 (setq coding-system 'raw-text))
+               (when (and (not coding-system)
+                          (re-search-forward re-coding tail-end t))
+                 (setq coding-system (intern (match-string 1)))
+                 (or (coding-system-p coding-system)
+                     (setq coding-system nil))))))
+       coding-system)
+      ;; Finally, try all the `auto-coding-functions'.
+      (let ((funcs auto-coding-functions)
+           (coding-system nil))
+       (while (and funcs (not coding-system))
+         (setq coding-system (condition-case e
+                                 (save-excursion
+                                   (goto-char (point-min))
+                                   (funcall (pop funcs) size))
+                               (error nil))))
+       coding-system)))
 
 (setq set-auto-coding-function 'set-auto-coding)
 
-;; Set buffer-file-coding-system of the current buffer after some text
-;; is inserted.
-(defun after-insert-file-set-buffer-file-coding-system (inserted)
+(defun after-insert-file-set-coding (inserted)
+  "Set `buffer-file-coding-system' of current buffer after text is inserted.
+INSERTED is the number of characters that were inserted, as figured
+in the situation before this function.  Return the number of characters
+inserted, as figured in the situation after.  The two numbers can be
+different if the buffer has become unibyte."
   (if last-coding-system-used
       (let ((coding-system
             (find-new-buffer-file-coding-system last-coding-system-used))
            (modified-p (buffer-modified-p)))
        (when coding-system
-         (set-buffer-file-coding-system coding-system)
+         (set-buffer-file-coding-system coding-system t)
          (if (and enable-multibyte-characters
                   (or (eq coding-system 'no-conversion)
                       (eq (coding-system-type coding-system) 5))
-                  ;; If buffer was unmodified, we must be visiting it.
-                  (not modified-p))
+                  ;; If buffer was unmodified and the size is the
+                  ;; same as INSERTED, we must be visiting it.
+                  (not modified-p)
+                  (= (buffer-size) inserted))
              ;; For coding systems no-conversion and raw-text...,
              ;; edit the buffer as unibyte.
-             (let ((pos-byte (position-bytes (+ (point) inserted))))
+             (let ((pos-marker (copy-marker (+ (point) inserted))))
                (set-buffer-multibyte nil)
-               (setq inserted (- pos-byte (position-bytes (point))))))
+               (setq inserted (- pos-marker (point)))))
          (set-buffer-modified-p modified-p))))
   inserted)
 
-(add-hook 'after-insert-file-functions
-         'after-insert-file-set-buffer-file-coding-system)
-
 ;; The coding-spec and eol-type of coding-system returned is decided
 ;; independently in the following order.
 ;;     1. That of buffer-file-coding-system locally bound.
@@ -1214,16 +1836,49 @@ or a function symbol which, when called, returns such a cons cell."
                   (cons (cons regexp coding-system)
                         network-coding-system-alist)))))))
 
+(defun decode-coding-inserted-region (from to filename
+                                          &optional visit beg end replace)
+  "Decode the region between FROM and TO as if it is read from file FILENAME.
+Optional arguments VISIT, BEG, END, and REPLACE are the same as those
+of the function `insert-file-contents'."
+  (save-excursion
+    (save-restriction
+      (narrow-to-region from to)
+      (goto-char (point-min))
+      (let ((coding coding-system-for-read))
+       (or coding
+           (setq coding (funcall set-auto-coding-function
+                                 filename (- (point-max) (point-min)))))
+       (or coding
+           (setq coding (find-operation-coding-system
+                         'insert-file-contents
+                         filename visit beg end replace)))
+       (if (coding-system-p coding)
+           (or enable-multibyte-characters
+               (setq coding
+                     (coding-system-change-text-conversion coding 'raw-text)))
+         (setq coding nil))
+       (if coding
+           (decode-coding-region (point-min) (point-max) coding))
+       (setq last-coding-system-used coding)))))
+
 (defun make-translation-table (&rest args)
-  "Make a translation table (char table) from arguments.
-Each argument is a list of the form (FROM . TO),
-where FROM is a character to be translated to TO.
+  "Make a translation table from arguments.
+A translation table is a char table intended for character
+translation in CCL programs.
+
+Each argument is a list of elements of the form (FROM . TO), where FROM
+is a character to be translated to TO.
 
 FROM can be a generic character (see `make-char').  In this case, TO is
-a generic character containing the same number of characters, or a
+a generic character containing the same number of characters, or an
 ordinary character.  If FROM and TO are both generic characters, all
 characters belonging to FROM are translated to characters belonging to TO
-without changing their position code(s)."
+without changing their position code(s).
+
+The arguments and forms in each argument are processed in the given
+order, and if a previous form already translates TO to some other
+character, say TO-ALT, FROM is also translated to TO-ALT."
   (let ((table (make-char-table 'translation-table))
        revlist)
     (while args
@@ -1275,33 +1930,37 @@ without changing their position code(s)."
 
 (defun make-translation-table-from-vector (vec)
   "Make translation table from decoding vector VEC.
-VEC is an array of 256 elements to map unibyte codes to multibyte characters.
+VEC is an array of 256 elements to map unibyte codes to multibyte
+characters.  Elements may be nil for undefined code points.
 See also the variable `nonascii-translation-table'."
   (let ((table (make-char-table 'translation-table))
        (rev-table (make-char-table 'translation-table))
-       (i 0)
        ch)
-    (while (< i 256)
+    (dotimes (i 256)
       (setq ch (aref vec i))
-      (aset table i ch)
-      (if (>= ch 256)
-         (aset rev-table ch i))
-      (setq i (1+ i)))
+      (when ch
+       (aset table i ch)
+       (if (>= ch 256)
+           (aset rev-table ch i))))
     (set-char-table-extra-slot table 0 rev-table)
     table))
 
 (defun define-translation-table (symbol &rest args)
-  "Define SYMBOL as a name of translation table made by ARGS.
+  "Define SYMBOL as the name of translation table made by ARGS.
+This sets up information so that the table can be used for
+translations in a CCL program.
 
-If the first element of ARGS is a char-table of which purpose is
-translation-table, just define SYMBOL as the name of it.
+If the first element of ARGS is a char-table whose purpose is
+`translation-table', just define SYMBOL to name it.  (Note that this
+function does not bind SYMBOL.)
 
-In the other case, ARGS are the same as arguments to the function
+Any other ARGS should be suitable as arguments of the function
 `make-translation-table' (which see).
 
 This function sets properties `translation-table' and
-`translation-table-id' of SYMBOL to the created table itself and
-identification number of the table respectively."
+`translation-table-id' of SYMBOL to the created table itself and the
+identification number of the table respectively.  It also registers
+the table in `translation-table-vector'."
   (let ((table (if (and (char-table-p (car args))
                        (eq (char-table-subtype (car args))
                            'translation-table))
@@ -1327,12 +1986,49 @@ identification number of the table respectively."
 
 (put 'with-category-table 'lisp-indent-function 1)
 
-(defmacro with-category-table (category-table &rest body)
-  `(let ((current-category-table (category-table)))
-     (set-category-table ,category-table)
-     (unwind-protect
-        (progn ,@body)
-       (set-category-table current-category-table))))
+(defmacro with-category-table (table &rest body)
+  "Evaluate BODY with category table of current buffer set to TABLE.
+The category table of the current buffer is saved, BODY is evaluated,
+then the saved table is restored, even in case of an abnormal exit.
+Value is what BODY returns."
+  (let ((old-table (make-symbol "old-table"))
+       (old-buffer (make-symbol "old-buffer")))
+    `(let ((,old-table (category-table))
+          (,old-buffer (current-buffer)))
+       (unwind-protect
+          (progn
+            (set-category-table ,table)
+            ,@body)
+        (save-current-buffer
+          (set-buffer ,old-buffer)
+          (set-category-table ,old-table))))))
+
+(defun define-translation-hash-table (symbol table)
+  "Define SYMBOL as the name of the hash translation TABLE for use in CCL.
+
+Analogous to `define-translation-table', but updates
+`translation-hash-table-vector' and the table is for use in the CCL
+`lookup-integer' and `lookup-character' functions."
+  (unless (and (symbolp symbol)
+              (hash-table-p table))
+    (error "Bad args to define-translation-hash-table"))
+  (let ((len (length translation-hash-table-vector))
+       (id 0)
+       done)
+    (put symbol 'translation-hash-table table)
+    (while (not done)
+      (if (>= id len)
+         (setq translation-hash-table-vector
+               (vconcat translation-hash-table-vector [nil])))
+      (let ((slot (aref translation-hash-table-vector id)))
+       (if (or (not slot)
+               (eq (car slot) symbol))
+           (progn
+             (aset translation-hash-table-vector id (cons symbol table))
+             (setq done t))
+         (setq id (1+ id)))))
+    (put symbol 'translation-hash-table-id id)
+    id))
 
 ;;; Initialize some variables.
 
@@ -1342,7 +2038,46 @@ identification number of the table respectively."
 (setq ignore-relative-composition
       (make-char-table 'ignore-relative-composition))
 
+
+;;; Built-in auto-coding-functions:
+
+(defun sgml-xml-auto-coding-function (size)
+  "Determine whether the buffer is XML, and if so, its encoding.
+This function is intended to be added to `auto-coding-functions'."
+  (setq size (+ (point) size))
+  (when (re-search-forward "\\`[[:space:]\n]*<\\?xml" size t)
+    (let ((end (save-excursion
+                ;; This is a hack.
+                (re-search-forward "\"\\s-*\\?>" size t))))
+      (when end
+       (if (re-search-forward "encoding=\"\\(.+?\\)\"" end t)
+           (let* ((match (match-string 1))
+                  (sym (intern (downcase match))))
+             (if (coding-system-p sym)
+                 sym
+               (message "Warning: unknown coding system \"%s\"" match)
+               nil))
+         'utf-8)))))
+
+(defun sgml-html-meta-auto-coding-function (size)
+  "If the buffer has an HTML meta tag, use it to determine encoding.
+This function is intended to be added to `auto-coding-functions'."
+  (setq size (min (+ (point) size)
+                 ;; Only search forward 10 lines
+                 (save-excursion
+                   (forward-line 10)
+                   (point))))
+  (when (and (search-forward "<html>" size t)
+            (re-search-forward "<meta\\s-+http-equiv=\"content-type\"\\s-+content=\"text/\\sw+;\\s-*charset=\\(.+?\\)\"" size t))
+      (let* ((match (match-string 1))
+            (sym (intern (downcase match))))
+       (if (coding-system-p sym)
+           sym
+         (message "Warning: unknown coding system \"%s\"" match)
+         nil))))
+
 ;;;
 (provide 'mule)
 
+;;; arch-tag: 9aebaa6e-0e8a-40a9-b857-cb5d04a39e7c
 ;;; mule.el ends here