Merge r21-4-11-chise-0_20-=ucs.
[chise/xemacs-chise.git.1] / lisp / mule / mule-cmds.el
index 832bf97..2059483 100644 (file)
@@ -1,6 +1,6 @@
 ;;; mule-cmds.el --- Commands for multilingual environment
 
-;; Copyright (C) 1995 Electrotechnical Laboratory, JAPAN.
+;; Copyright (C) 1995,1999 Electrotechnical Laboratory, JAPAN.
 ;; Licensed to the Free Software Foundation.
 ;; Copyright (C) 1997 MORIOKA Tomohiko
 
 ;; Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 ;; 02111-1307, USA.
 
+;; Note: Some of the code here is now in code-cmds.el
+
 ;;; Code:
 
 ;;; MULE related key bindings and menus.
 
-(defvar mule-keymap (make-sparse-keymap "MULE")
-  "Keymap for MULE (Multilingual environment) specific commands.")
+(require 'code-cmds)
 
-;; Keep "C-x C-m ..." for mule specific commands.
-(define-key ctl-x-map "\C-m" mule-keymap)
+;; Preserve the old name
+(defvaralias 'mule-keymap 'coding-keymap)
 
-(define-key mule-keymap "f" 'set-buffer-file-coding-system)
-(define-key mule-keymap "F" 'set-default-buffer-file-coding-system) ; XEmacs
-(define-key mule-keymap "t" 'set-terminal-coding-system)
-(define-key mule-keymap "k" 'set-keyboard-coding-system)
-(define-key mule-keymap "p" 'set-buffer-process-coding-system)
-(define-key mule-keymap "\C-\\" 'select-input-method)
-(define-key mule-keymap "c" 'universal-coding-system-argument)
+(define-key mule-keymap "x" 'set-selection-coding-system)
+(define-key mule-keymap "X" 'set-next-selection-coding-system)
+(define-key mule-keymap "\C-\\" 'set-input-method)
 ;;(define-key mule-keymap "c" 'list-coding-system-briefly) ; XEmacs
-(define-key mule-keymap "C" 'list-coding-system)        ; XEmacs
+(define-key mule-keymap "C" 'describe-coding-system)    ; XEmacs
 (define-key mule-keymap "r" 'toggle-display-direction)  ; XEmacs
 (define-key mule-keymap "l" 'set-language-environment)
 
-(define-key help-map "\C-L" 'describe-language-support)
 (define-key help-map "L" 'describe-language-environment)
 (define-key help-map "\C-\\" 'describe-input-method)
 (define-key help-map "I" 'describe-input-method)
-(define-key help-map "C" 'describe-coding-system)
 (define-key help-map "h" 'view-hello-file)
 
 ;; Menu for XEmacs were moved to menubar-items.el.
 ;; but it won't be used that frequently.
 (define-key global-map "\C-\\" 'toggle-input-method)
 
+;;; This is no good because people often type Shift-SPC
+;;; meaning to type SPC.  -- rms.
+;;; ;; Here's an alternative key binding for X users (Shift-SPACE).
+;;; (define-key global-map [?\S- ] 'toggle-input-method)
+
+(defun coding-system-change-eol-conversion (coding-system eol-type)
+  "Return a coding system which differs from CODING-SYSTEM in eol conversion.
+The returned coding system converts end-of-line by EOL-TYPE
+but text as the same way as CODING-SYSTEM.
+EOL-TYPE should be `lf', `crlf', `cr' or nil.
+If EOL-TYPE is nil, the returned coding system detects
+how end-of-line is formatted automatically while decoding.
+
+EOL-TYPE can be specified by an symbol `unix', `dos' or `mac'.
+They means `lf', `crlf', and `cr' respectively."
+  (if (symbolp eol-type)
+      (setq eol-type (cond ((or (eq eol-type 'unix)
+                               (eq eol-type 'lf))
+                           'eol-lf)
+                           ((or (eq eol-type 'dos)
+                               (eq eol-type 'crlf))
+                           'eol-crlf)
+                           ((or (eq eol-type 'mac)
+                               (eq eol-type 'cr))
+                           'eol-cr)
+                           (t eol-type))))
+  (let ((orig-eol-type (coding-system-eol-type coding-system)))
+    (if (null orig-eol-type)
+        (if (not eol-type)
+            coding-system
+          (coding-system-property coding-system eol-type))
+      (let ((base (coding-system-base coding-system)))
+        (if (not eol-type)
+            base
+          (if (eq eol-type orig-eol-type)
+              coding-system
+            (setq orig-eol-type (coding-system-eol-type base))
+            (if (null orig-eol-type)
+                (coding-system-property base eol-type))))))))
+
+;; (defun coding-system-change-text-conversion (coding-system coding)
+;;   "Return a coding system which differs from CODING-SYSTEM in text conversion.
+;; The returned coding system converts text by CODING
+;; but end-of-line as the same way as CODING-SYSTEM.
+;; If CODING is nil, the returned coding system detects
+;; how text is formatted automatically while decoding."
+;;   (if (not coding)
+;;       (coding-system-base coding-system)
+;;     (let ((eol-type (coding-system-eol-type coding-system)))
+;;       (coding-system-change-eol-conversion
+;;        coding
+;;        (if (numberp eol-type) (aref [unix dos mac] eol-type))))))
+
 (defun view-hello-file ()
   "Display the HELLO file which list up many languages and characters."
   (interactive)
   ;; We have to decode the file in any environment.
-  (let ((coding-system-for-read 'iso-2022-7))
+  (let ((coding-system-for-read 'iso-2022-7bit))
     (find-file-read-only (expand-file-name "HELLO" data-directory))))
 
-(defun universal-coding-system-argument ()
-  "Execute an I/O command using the specified coding system."
-  (interactive)
-  (let* ((coding-system
-         (read-coding-system "Coding system for following command: "))
-        (keyseq (read-key-sequence
-                 (format "Command to execute with %s:" coding-system)))
-        (cmd (key-binding keyseq)))
-    (let ((coding-system-for-read coding-system)
-         (coding-system-for-write coding-system))
-      (message "")
-      (call-interactively cmd))))
-
-(defun set-default-coding-systems (coding-system)
-  "Set default value of various coding systems to CODING-SYSTEM.
-The follwing coding systems are set:
-  o coding system of a newly created buffer
-  o default coding system for terminal output
-  o default coding system for keyboard input
-  o default coding system for subprocess I/O"
-  (check-coding-system coding-system)
-  ;;(setq-default buffer-file-coding-system coding-system)
-  (set-default-buffer-file-coding-system coding-system)
-  ;;(setq default-terminal-coding-system coding-system)
-  (setq terminal-coding-system coding-system)
-  ;;(setq default-keyboard-coding-system coding-system)
-  (setq keyboard-coding-system coding-system)
-  ;;(setq default-process-coding-system (cons coding-system coding-system))
-  (add-hook 'comint-exec-hook
-           `(lambda ()
-              (let ((proc (get-buffer-process (current-buffer))))
-                (set-process-input-coding-system  proc ',coding-system)
-                (set-process-output-coding-system proc ',coding-system)))
-           'append)
-  (setq file-name-coding-system coding-system))
-
-(defun prefer-coding-system (coding-system)
-  "Add CODING-SYSTEM at the front of the priority list for automatic detection.
-This also sets the following coding systems to CODING-SYSTEM:
-  o coding system of a newly created buffer
-  o default coding system for terminal output
-  o default coding system for keyboard input
-  o default coding system for subprocess I/O"
-  (interactive "zPrefer coding system: ")
-  (if (not (and coding-system (coding-system-p coding-system)))
-      (error "Invalid coding system `%s'" coding-system))
-  (let ((coding-category (coding-system-category coding-system))
-       (parent (coding-system-parent coding-system)))
-    (if (not coding-category)
-       ;; CODING-SYSTEM is no-conversion or undecided.
-       (error "Can't prefer the coding system `%s'" coding-system))
-    (set coding-category (or parent coding-system))
-    (if (not (eq coding-category (car coding-category-list)))
-       ;; We must change the order.
-       (setq coding-category-list
-             (cons coding-category
-                   (delq coding-category coding-category-list))))
-    (if (and parent (interactive-p))
-       (message "Highest priority is set to %s (parent of %s)"
-                parent coding-system))
-    (set-default-coding-systems (or parent coding-system))))
-
 \f
-;;; Language support staffs.
+;;; Language support stuff.
 
 (defvar language-info-alist nil
-  "Alist of language names vs the corresponding information of various kind.
+  "Alist of language environment definitions.
 Each element looks like:
        (LANGUAGE-NAME . ((KEY . INFO) ...))
-where LANGUAGE-NAME is a string,
-KEY is a symbol denoting the kind of information,
-INFO is any Lisp object which contains the actual information related
-to KEY.")
-
-(defun get-language-info (language-name key)
-  "Return the information for LANGUAGE-NAME of the kind KEY.
-KEY is a symbol denoting the kind of required information."
-  (if (symbolp language-name)
-      (setq language-name (symbol-name language-name)))
-  (let ((lang-slot (assoc-ignore-case language-name language-info-alist)))
+where LANGUAGE-NAME is a string, the name of the language environment,
+KEY is a symbol denoting the kind of information, and
+INFO is the data associated with KEY.
+Meaningful values for KEY include
+
+  documentation      value is documentation of what this language environment
+                       is meant for, and how to use it.
+  charset           value is a list of the character sets used by this
+                       language environment.
+  sample-text       value is one line of text,
+                       written using those character sets,
+                       appropriate for this language environment.
+  setup-function     value is a function to call to switch to this
+                       language environment.
+  exit-function      value is a function to call to leave this
+                       language environment.
+  coding-system      value is a list of coding systems that are good
+                       for saving text written in this language environment.
+                       This list serves as suggestions to the user;
+                       in effect, as a kind of documentation.
+  coding-priority    value is a list of coding systems for this language
+                       environment, in order of decreasing priority.
+                       This is used to set up the coding system priority
+                       list when you switch to this language environment.
+  input-method       value is a default input method for this language
+                       environment.
+  features           value is a list of features requested in this
+                       language environment.
+  tutorial           value is a tutorial file name written in the language.")
+
+(defun get-language-info (lang-env key)
+  "Return information listed under KEY for language environment LANG-ENV.
+KEY is a symbol denoting the kind of information.
+For a list of useful values for KEY and their meanings,
+see `language-info-alist'."
+  (if (symbolp lang-env)
+      (setq lang-env (symbol-name lang-env)))
+  (let ((lang-slot (assoc-ignore-case lang-env language-info-alist)))
     (if lang-slot
        (cdr (assq key (cdr lang-slot))))))
 
-(defun set-language-info (language-name key info)
-  "Set for LANGUAGE-NAME the information INFO under KEY.
+(defun set-language-info (lang-env key info)
+  "Modify part of the definition of language environment LANG-ENV.
+Specifically, this stores the information INFO under KEY
+in the definition of this language environment.
 KEY is a symbol denoting the kind of information.
-INFO is any Lisp object which contains the actual information.
-
-Currently, the following KEYs are used by Emacs:
-
-charset: list of symbols whose values are charsets specific to the language.
-
-coding-system: list of coding systems specific to the language.
-
-tutorial: a tutorial file name written in the language.
-
-sample-text: one line short text containing characters of the language.
-
-documentation: t or a string describing how Emacs supports the language.
-      If a string is specified, it is shown before any other information
-      of the language by the command `describe-language-environment'.
-
-setup-function: a function to call for setting up environment
-       convenient for a user of the language.
-
-If KEY is documentation or setup-function, you can also specify
-a cons cell as INFO, in which case, the car part should be
-a normal value as INFO for KEY (as described above),
-and the cdr part should be a symbol whose value is a menu keymap
-in which an entry for the language is defined.  But, only the car part
-is actually set as the information.
+INFO is the value for that information.
 
-We will define more KEYs in the future.  To avoid conflict,
-if you want to use your own KEY values, make them start with `user-'."
-  (if (symbolp language-name)
-      (setq language-name (symbol-name language-name)))
+For a list of useful values for KEY and their meanings,
+see `language-info-alist'."
+  (if (symbolp lang-env)
+      (setq lang-env (symbol-name lang-env)))
   (let (lang-slot key-slot)
-    (setq lang-slot (assoc language-name language-info-alist))
+    (setq lang-slot (assoc lang-env language-info-alist))
     (if (null lang-slot)               ; If no slot for the language, add it.
-       (setq lang-slot (list language-name)
+       (setq lang-slot (list lang-env)
              language-info-alist (cons lang-slot language-info-alist)))
     (setq key-slot (assq key lang-slot))
     (if (null key-slot)                        ; If no slot for the key, add it.
        (progn
          (setq key-slot (list key))
          (setcdr lang-slot (cons key-slot (cdr lang-slot)))))
-    ;; Setup menu.
-    (cond ((eq key 'documentation)
-           ;; (define-key-after
-           ;;   (if (consp info)
-           ;;       (prog1 (symbol-value (cdr info))
-           ;;         (setq info (car info)))
-           ;;     describe-language-environment-map)
-           ;;   (vector (intern language-name))
-           ;;   (cons language-name 'describe-specified-language-support)
-           ;;   t)
-          (if (consp info)
-              (setq info (car info)))
-          (when (featurep 'menubar)
-            (eval-after-load
-             "menubar-items.elc"
-             `(add-menu-button
-               '("Mule" "Describe Language Support")
-               (vector ,language-name
-                       '(describe-language-environment ,language-name)
-                       t))))
-          )
-         ((eq key 'setup-function)
-           ;; (define-key-after
-           ;;   (if (consp info)
-           ;;       (prog1 (symbol-value (cdr info))
-           ;;         (setq info (car info)))
-           ;;     setup-language-environment-map)
-           ;;   (vector (intern language-name))
-           ;;   (cons language-name 'setup-specified-language-environment)
-           ;;   t)
-          (if (consp info)
-              (setq info (car info)))
-          (when (featurep 'menubar)
-            (eval-after-load
-             "menubar-items.elc"
-             `(add-menu-button
-               '("Mule" "Set Language Environment")
-               (vector ,language-name
-                       '(set-language-environment ,language-name)
-                       t))))
-           ))
-
-    (setcdr key-slot info)
-    ))
-
-(defun set-language-info-alist (language-name alist)
-  "Set for LANGUAGE-NAME the information in ALIST.
-ALIST is an alist of KEY and INFO.  See the documentation of
+    (setcdr key-slot info)))
+
+(defun set-language-info-alist (lang-env alist &optional parents)
+  "Store ALIST as the definition of language environment LANG-ENV.
+ALIST is an alist of KEY and INFO values.  See the documentation of
 `set-language-info' for the meanings of KEY and INFO."
-  (if (symbolp language-name)
-      (setq language-name (symbol-name language-name)))
-  (while alist
-    (set-language-info language-name (car (car alist)) (cdr (car alist)))
-    (setq alist (cdr alist))))
+  (if (symbolp lang-env)
+      (setq lang-env (symbol-name lang-env)))
+  (let (; (describe-map describe-language-environment-map)
+       ; (setup-map setup-language-environment-map)
+       )
+    ;; (if parents
+    ;;     (let ((l parents)
+    ;;           map parent-symbol parent)
+    ;;       (while l
+    ;;         (if (symbolp (setq parent-symbol (car l)))
+    ;;             (setq parent (symbol-name parent))
+    ;;           (setq parent parent-symbol parent-symbol (intern parent)))
+    ;;         (setq map (lookup-key describe-map (vector parent-symbol)))
+    ;;         (if (not map)
+    ;;             (progn
+    ;;               (setq map (intern (format "describe-%s-environment-map"
+    ;;                                         (downcase parent))))
+    ;;               (define-prefix-command map)
+    ;;               (define-key-after describe-map (vector parent-symbol)
+    ;;                 (cons parent map) t)))
+    ;;         (setq describe-map (symbol-value map))
+    ;;         (setq map (lookup-key setup-map (vector parent-symbol)))
+    ;;         (if (not map)
+    ;;             (progn
+    ;;               (setq map (intern (format "setup-%s-environment-map"
+    ;;                                         (downcase parent))))
+    ;;               (define-prefix-command map)
+    ;;               (define-key-after setup-map (vector parent-symbol)
+    ;;                 (cons parent map) t)))
+    ;;         (setq setup-map (symbol-value map))
+    ;;         (setq l (cdr l)))))
+
+    ;; Set up menu items for this language env.
+    (let ((doc (assq 'documentation alist)))
+      (when doc
+        ;; (define-key-after describe-map (vector (intern lang-env))
+        ;;   (cons lang-env 'describe-specified-language-support) t)
+       (when (featurep 'menubar)
+         (eval-after-load
+             "menubar-items.elc"
+           `(add-menu-button
+             '("%_Edit" "%_Multilingual (\"Mule\")"
+               "%_Describe Language Support")
+             (vector ,lang-env
+                     '(describe-language-environment ,lang-env)
+                     t))))
+       ))
+    ;; (define-key-after setup-map (vector (intern lang-env))
+    ;;   (cons lang-env 'setup-specified-language-environment) t)
+    (when (featurep 'menubar)
+      (eval-after-load
+         "menubar-items.elc"
+       `(add-menu-button
+         '("%_Edit" "%_Multilingual (\"Mule\")"
+           "%_Set Language Environment")
+         (vector ,lang-env
+                 '(set-language-environment ,lang-env)
+                 t))))
+    
+    (while alist
+      (set-language-info lang-env (car (car alist)) (cdr (car alist)))
+      (setq alist (cdr alist)))))
 
 (defun read-language-name (key prompt &optional default)
-  "Read language name which has information for KEY, prompting with PROMPT.
-DEFAULT is the default choice of language.
-This returns a language name as a string."
+  "Read a language environment name which has information for KEY.
+If KEY is nil, read any language environment.
+Prompt with PROMPT.  DEFAULT is the default choice of language environment.
+This returns a language environment name as a string."
   (let* ((completion-ignore-case t)
         (name (completing-read prompt
                                language-info-alist
-                               (function (lambda (elm) (assq key elm)))
-                               t nil default)))
+                               (and key
+                                    (function (lambda (elm) (assq key elm))))
+                               t nil nil default)))
     (if (and (> (length name) 0)
-            (get-language-info name key))
+            (or (not key)
+                (get-language-info name key)))
        name)))
 \f
 ;;; Multilingual input methods.
@@ -276,7 +284,7 @@ Emacs loads this file at startup time.")
 ";;; %s -- list of LEIM (Library of Emacs Input Method)
 ;;
 ;; This file contains a list of LEIM (Library of Emacs Input Method)
-;; in the same directory as this file.  Loading this file registeres
+;; in the same directory as this file.  Loading this file registers
 ;; the whole input methods in Emacs.
 ;;
 ;; Each entry has the form:
@@ -321,10 +329,13 @@ If nil, that means no input method is activated now.")
 (put 'current-input-method-title 'permanent-local t)
 
 (defcustom default-input-method nil
-  "*Default input method for multilingual text.
+  "*Default input method for multilingual text (a string).
 This is the input method activated automatically by the command
 `toggle-input-method' (\\[toggle-input-method])."
-  :group 'mule)
+  :group 'mule
+  :type '(choice (const nil) string))
+
+(put 'input-method-function 'permanent-local t)
 
 (defvar input-method-history nil
   "History list for some commands that read input methods.")
@@ -348,26 +359,40 @@ This function is called with no argument.")
 (put 'describe-current-input-method-function 'permanent-local t)
 
 (defvar input-method-alist nil
-  "Alist of input method names vs the corresponding information to use it.
+  "Alist of input method names vs how to use them.
 Each element has the form:
-       (INPUT-METHOD LANGUAGE-NAME ACTIVATE-FUNC TITLE DESCRIPTION ...)
-See the function `register-input-method' for the meanings of each elements.")
+   (INPUT-METHOD LANGUAGE-ENV ACTIVATE-FUNC TITLE DESCRIPTION ARGS...)
+See the function `register-input-method' for the meanings of the elements.")
+
+(defun register-input-method (input-method lang-env &rest args)
+  "Register INPUT-METHOD as an input method for language environment ENV.
+INPUT-METHOD and LANG-ENV are symbols or strings.
 
-(defun register-input-method (input-method language-name &rest args)
-  "Register INPUT-METHOD as an input method for LANGUAGE-NAME.
-INPUT-METHOD and LANGUAGE-NAME are symbols or strings.
 The remaining arguments are:
-       ACTIVATE-FUNC, TITLE, DESCRIPTION, and ARG ...
- where,
-ACTIVATE-FUNC is a function to call for activating this method.
-TITLE is a string shown in mode-line while this method is active,
-DESCRIPTION is a string describing about this method,
-Arguments to ACTIVATE-FUNC are INPUT-METHOD and ARGs."
-  (if (symbolp language-name)
-      (setq language-name (symbol-name language-name)))
+       ACTIVATE-FUNC, TITLE, DESCRIPTION, and ARGS...
+ACTIVATE-FUNC is a function to call to activate this method.
+TITLE is a string to show in the mode line when this method is active.
+DESCRIPTION is a string describing this method and what it is good for.
+The ARGS, if any, are passed as arguments to ACTIVATE-FUNC.
+All told, the arguments to ACTIVATE-FUNC are INPUT-METHOD and the ARGS.
+
+This function is mainly used in the file \"leim-list.el\" which is
+created at building time of emacs, registering all quail input methods
+contained in the emacs distribution.
+
+In case you want to register a new quail input method by yourself, be
+careful to use the same input method title as given in the third
+parameter of `quail-define-package' (if the values are different, the
+string specified in this function takes precedence).
+
+The commands `describe-input-method' and `list-input-methods' need
+this duplicated values to show some information about input methods
+without loading the affected quail packages."
+  (if (symbolp lang-env)
+      (setq lang-env (symbol-name lang-env)))
   (if (symbolp input-method)
       (setq input-method (symbol-name input-method)))
-  (let ((info (cons language-name args))
+  (let ((info (cons lang-env args))
        (slot (assoc input-method input-method-alist)))
     (if slot
        (setcdr slot info)
@@ -387,30 +412,41 @@ The return value is a string."
         ;; This binding is necessary because input-method-history is
         ;; buffer local.
         (input-method (completing-read prompt input-method-alist
-                                       nil t nil 'input-method-history)
-                      ;;default)
-                      ))
+                                       nil t nil 'input-method-history
+                                       default)))
+    (if (and input-method (symbolp input-method))
+       (setq input-method (symbol-name input-method)))
     (if (> (length input-method) 0)
        input-method
       (if inhibit-null
          (error "No valid input method is specified")))))
 
 (defun activate-input-method (input-method)
-  "Turn INPUT-METHOD on.
-If some input method is already on, turn it off at first."
-  (if (symbolp input-method)
+  "Switch to input method INPUT-METHOD for the current buffer.
+If some other input method is already active, turn it off first.
+If INPUT-METHOD is nil, deactivate any current input method."
+  (if (and input-method (symbolp input-method))
       (setq input-method (symbol-name input-method)))
   (if (and current-input-method
           (not (string= current-input-method input-method)))
-    (inactivate-input-method))
-  (unless current-input-method
+      (inactivate-input-method))
+  (unless (or current-input-method (null input-method))
     (let ((slot (assoc input-method input-method-alist)))
       (if (null slot)
          (error "Can't activate input method `%s'" input-method))
-      (apply (nth 2 slot) input-method (nthcdr 5 slot))
+      (let ((func (nth 2 slot)))
+       (if (functionp func)
+           (apply (nth 2 slot) input-method (nthcdr 5 slot))
+         (if (and (consp func) (symbolp (car func)) (symbolp (cdr func)))
+             (progn
+               (require (cdr func))
+               (apply (car func) input-method (nthcdr 5 slot)))
+           (error "Can't activate input method `%s'" input-method))))
       (setq current-input-method input-method)
       (setq current-input-method-title (nth 3 slot))
-      (run-hooks 'input-method-activate-hook))))
+      (unwind-protect
+         (run-hooks 'input-method-activate-hook)
+       (force-mode-line-update)))))
 
 (defun inactivate-input-method ()
   "Turn off the current input method."
@@ -426,12 +462,12 @@ If some input method is already on, turn it off at first."
       (unwind-protect
          (run-hooks 'input-method-inactivate-hook)
        (setq current-input-method nil
-             current-input-method-title nil)))))
+             current-input-method-title nil)
+       (force-mode-line-update)))))
 
-(defun select-input-method (input-method)
-  "Select and turn on INPUT-METHOD.
-This sets the default input method to what you specify,
-and turn it on for the current buffer."
+(defun set-input-method (input-method)
+  "Select and activate input method INPUT-METHOD for the current buffer.
+This also sets the default input method to the one you specify."
   (interactive
    (let* ((default (or (car input-method-history) default-input-method)))
      (list (read-input-method-name
@@ -443,28 +479,35 @@ and turn it on for the current buffer."
 (defun toggle-input-method (&optional arg)
   "Turn on or off a multilingual text input method for the current buffer.
 
-With arg, read an input method from minibuffer and turn it on.
+With no prefix argument, if an input method is currently activated,
+turn it off.  Otherwise, activate an input method -- the one most
+recently used, or the one specified in `default-input-method', or
+the one read from the minibuffer.
 
-Without arg, if some input method is currently activated, turn it off,
-else turn on an input method selected last time
-or the default input method (see `default-input-method').
+With a prefix argument, read an input method from the minibuffer and
+turn it on.
 
-When there's no input method to turn on, turn on what read from minibuffer."
+The default is to use the most recent input method specified
+\(not including the currently active input method, if any)."
   (interactive "P")
-  (let* ((default (or (car input-method-history) default-input-method)))
-    (if (and current-input-method (not arg))
-       (inactivate-input-method)
+  (if (and current-input-method (not arg))
+      (inactivate-input-method)
+    (let ((default (or (car input-method-history) default-input-method)))
+      (if (and arg default (equal current-input-method default)
+              (> (length input-method-history) 1))
+         (setq default (nth 1 input-method-history)))
       (activate-input-method
        (if (or arg (not default))
-          (read-input-method-name
-           (if default "Input method (default %s): " "Input method: " )
-           default t)  
+          (progn
+            (read-input-method-name
+             (if default "Input method (default %s): " "Input method: " )
+             default t))
         default))
       (or default-input-method
          (setq default-input-method current-input-method)))))
 
 (defun describe-input-method (input-method)
-  "Describe  input method INPUT-METHOD."
+  "Describe input method INPUT-METHOD."
   (interactive
    (list (read-input-method-name
          "Describe input method (default, current choice): ")))
@@ -484,12 +527,11 @@ When there's no input method to turn on, turn on what read from minibuffer."
               (fboundp describe-current-input-method-function))
          (funcall describe-current-input-method-function)
        (message "No way to describe the current input method `%s'"
-                (cdr current-input-method))
+                current-input-method)
        (ding))
     (error "No input method is activated now")))
 
-(defun read-multilingual-string (prompt &optional initial-input
-                                       input-method)
+(defun read-multilingual-string (prompt &optional initial-input input-method)
   "Read a multilingual string from minibuffer, prompting with string PROMPT.
 The input method selected last time is activated in minibuffer.
 If optional second arg INITIAL-INPUT is non-nil, insert it in the minibuffer
@@ -499,37 +541,51 @@ to be activated instead of the one selected last time.  It is a symbol
 or a string."
   (setq input-method
        (or input-method
+           current-input-method
            default-input-method
            (read-input-method-name "Input method: " nil t)))
   (if (and input-method (symbolp input-method))
       (setq input-method (symbol-name input-method)))
-  (let ((current-input-method input-method))
-    ;; FSFmacs
-    ;; (read-string prompt initial-input nil nil t)))
-    (read-string prompt initial-input nil)))
+  (let ((prev-input-method current-input-method))
+    (unwind-protect
+       (progn
+         (activate-input-method input-method)
+         ;; FSF Emacs
+         ;; (read-string prompt initial-input nil nil t)
+         (read-string prompt initial-input nil))
+      (activate-input-method prev-input-method))))
 
 ;; Variables to control behavior of input methods.  All input methods
 ;; should react to these variables.
 
-(defcustom input-method-verbose-flag t
-  "*If this flag is non-nil, input methods give extra guidance.
+(defcustom input-method-verbose-flag 'default
+  "*A flag to control extra guidance given by input methods.
+The value should be nil, t, `complex-only', or `default'.
 
 The extra guidance is done by showing list of available keys in echo
-area.
+area.  When you use the input method in the minibuffer, the guidance
+is shown at the bottom short window (split from the existing window).
 
-For complex input methods such as `chinese-py' and `japanese',
-when you use the input method in the minibuffer, the guidance is
-shown at the bottom short window (split from the existing window).
-For simple input methods, guidance is not shown
-when you are in the minibuffer."
-  :type 'boolean
+If the value is t, extra guidance is always given, if the value is
+nil, extra guidance is always suppressed.
+
+If the value is `complex-only', only complex input methods such as
+`chinese-py' and `japanese' give extra guidance.
+
+If the value is `default', complex input methods always give extra
+guidance, but simple input methods give it only when you are not in
+the minibuffer.
+
+See also the variable `input-method-highlight-flag'."
+  :type '(choice (const t) (const nil) (const complex-only) (const default))
   :group 'mule)
 
 (defcustom input-method-highlight-flag t
   "*If this flag is non-nil, input methods highlight partially-entered text.
 For instance, while you are in the middle of a Quail input method sequence,
 the text inserted so far is temporarily underlined.
-The underlining goes away when you finish or abort the input method sequence."
+The underlining goes away when you finish or abort the input method sequence.
+See also the variable `input-method-verbose-flag'."
   :type 'boolean
   :group 'mule)
 
@@ -543,22 +599,53 @@ just activated.")
   "Normal hook run just after an input method is inactivated.
 
 The variable `current-input-method' still keeps the input method name
-just inacitvated.")
+just inactivated.")
 
 (defvar input-method-after-insert-chunk-hook nil
   "Normal hook run just after an input method insert some chunk of text.")
 
+(defvar input-method-exit-on-first-char nil
+  "This flag controls a timing when an input method returns.
+Usually, the input method does not return while there's a possibility
+that it may find a different translation if a user types another key.
+But, it this flag is non-nil, the input method returns as soon as
+the current key sequence gets long enough to have some valid translation.")
+
+(defvar input-method-use-echo-area nil
+  "This flag controls how an input method shows an intermediate key sequence.
+Usually, the input method inserts the intermediate key sequence,
+or candidate translations corresponding to the sequence,
+at point in the current buffer.
+But, if this flag is non-nil, it displays them in echo area instead.")
+
 (defvar input-method-exit-on-invalid-key nil
-  "This flag controls the behaviour of an input method on invalid key input.
+  "This flag controls the behavior of an input method on invalid key input.
 Usually, when a user types a key which doesn't start any character
 handled by the input method, the key is handled by turning off the
-input method temporalily.  After the key is handled, the input method is 
-back on.
+input method temporarily.  After that key, the input method is re-enabled.
 But, if this flag is non-nil, the input method is never back on.")
 
 \f
+(defvar set-language-environment-hook nil
+  "Normal hook run after some language environment is set.
+
+When you set some hook function here, that effect usually should not
+be inherited to another language environment.  So, you had better set
+another function in `exit-language-environment-hook' (which see) to
+cancel the effect.")
+
+(defvar exit-language-environment-hook nil
+  "Normal hook run after exiting from some language environment.
+When this hook is run, the variable `current-language-environment'
+is still bound to the language environment being exited.
+
+This hook is mainly used for canceling the effect of
+`set-language-environment-hook' (which-see).")
+
+(put 'setup-specified-language-environment 'apropos-inhibit t)
+
 (defun setup-specified-language-environment ()
-  "Set up multi-lingual environment convenient for the specified language."
+  "Switch to a specified language environment."
   (interactive)
   (let (language-name)
     (if (and (symbolp last-command-event)
@@ -568,30 +655,287 @@ But, if this flag is non-nil, the input method is never back on.")
        (set-language-environment language-name)
       (error "Bogus calling sequence"))))
 
-(defvar current-language-environment "English"
-  "The last language environment specified with `set-language-environment'.")
+(defcustom current-language-environment "English"
+  "The last language environment specified with `set-language-environment'.
+This variable should be set only with \\[customize], which is equivalent
+to using the function `set-language-environment'."
+  :link '(custom-manual "(emacs)Language Environments")
+  :set (lambda (symbol value) (set-language-environment value))
+  :get (lambda (x)
+        (or (car-safe (assoc-ignore-case
+                       (if (symbolp current-language-environment)
+                           (symbol-name current-language-environment)
+                         current-language-environment)
+                       language-info-alist))
+            "English"))
+  :type (cons 'choice (mapcar (lambda (lang)
+                               (list 'const (car lang)))
+                             language-info-alist))
+  :initialize 'custom-initialize-default
+  :group 'mule
+  :type 'string)
+
+(defun reset-language-environment ()
+  "Reset multilingual environment of Emacs to the default status.
+
+The default status is as follows:
+
+  The default value of `buffer-file-coding-system' is nil.
+  The default coding system for process I/O is nil.
+  The default value for the command `set-terminal-coding-system' is nil.
+  The default value for the command `set-keyboard-coding-system' is nil.
+
+  The order of priorities of coding categories and the coding system
+  bound to each category are as follows
+       coding category         coding system
+       --------------------------------------------------
+       iso-7                   iso-2022-7bit
+       no-conversion           raw-text
+       utf-8                   utf-8
+       iso-8-1                 iso-8859-1
+       iso-8-2                 ctext (iso-8859-1 alias)
+       iso-8-designate         ctext (iso-8859-1 alias)
+       iso-lock-shift          iso-2022-lock
+       shift-jis               shift_jis
+       big5                    big5
+       ucs-4                   iso-10646-ucs-4
+"
+;; The old table (from FSF synch?) was not what we use (cf mule-coding.el),
+;; and as documented iso-8-designate is inconsistent with iso-2022-8bit-ss2.
+;;  The order of priorities of coding categories and the coding system
+;;  bound to each category are as follows
+;;     coding category         coding system
+;;     --------------------------------------------------
+;;     iso-8-2                 iso-8859-1
+;;     iso-8-1                 iso-8859-1
+;;     iso-7                   iso-2022-7bit
+;;     iso-lock-shift          iso-2022-lock
+;;     iso-8-designate         iso-2022-8bit-ss2
+;;     no-conversion           raw-text
+;;     shift-jis               shift_jis
+;;     big5                    big5
+;;     ucs-4                   ----
+;;     utf-8                   ----
+  (interactive)
+
+  (set-coding-category-system 'iso-7           'iso-2022-7)
+  (set-coding-category-system 'iso-8-1         'iso-8859-1)
+  (set-coding-category-system 'iso-8-2         'ctext)
+  (set-coding-category-system 'iso-lock-shift  'iso-2022-lock)
+  (set-coding-category-system 'iso-8-designate 'ctext)
+  (set-coding-category-system 'no-conversion   'raw-text)
+  (set-coding-category-system 'shift-jis       'shift_jis)
+  (set-coding-category-system 'big5            'big5)
+  ;; #### Can we now assume the existence of the 10646 coding systems?
+  ;; #### These lists need to be synched with the ones in mule-coding.el.
+  (cond ((eq (coding-system-type (coding-category-system 'utf-8)) 'utf-8)
+        (set-coding-category-system 'utf-8 'utf-8)
+        (cond ((eq (coding-system-type (coding-category-system 'ucs-4))
+                   'iso-10646-ucs-4)
+               (set-coding-category-system 'ucs-4 'iso-10646-ucs-4)
+               (set-coding-priority-list
+                '(iso-7
+                  no-conversion
+                  utf-8
+                  iso-8-1
+                  iso-8-2
+                  iso-8-designate
+                  iso-lock-shift
+                  shift-jis
+                  big5
+                  ucs-4))
+               )
+              (t
+               (set-coding-priority-list
+                '(iso-7
+                  no-conversion
+                  utf-8
+                  iso-8-1
+                  iso-8-2
+                  iso-8-designate
+                  iso-lock-shift
+                  shift-jis
+                  big5))
+               ))
+        )
+       (t
+        (set-coding-priority-list
+         '(iso-7
+           no-conversion
+           iso-8-1
+           iso-8-2
+           iso-8-designate
+           iso-lock-shift
+           shift-jis
+           big5))
+        ))
+
+  ;; (update-coding-systems-internal)
+
+  (set-default-coding-systems nil)
+  ;; Don't alter the terminal and keyboard coding systems here.
+  ;; The terminal still supports the same coding system
+  ;; that it supported a minute ago.
+;;;  (set-terminal-coding-system-internal nil)
+;;;  (set-keyboard-coding-system-internal nil)
+
+  ;; (setq nonascii-translation-table nil
+  ;;       nonascii-insert-offset 0)
+  )
 
 (defun set-language-environment (language-name)
   "Set up multi-lingual environment for using LANGUAGE-NAME.
 This sets the coding system priority and the default input method
-and sometimes other things."
-  (interactive (list (read-language-name 'setup-function
-                                        "Set language environment: ")))
+and sometimes other things.  LANGUAGE-NAME should be a string
+which is the name of a language environment.  For example, \"Latin-1\"
+specifies the character set for the major languages of Western Europe."
+  (interactive (list (read-language-name
+                     nil
+                     "Set language environment (default, English): ")))
   (if language-name
       (if (symbolp language-name)
          (setq language-name (symbol-name language-name)))
     (setq language-name "English"))
-  (if (null (get-language-info language-name 'setup-function))
+  (or (assoc-ignore-case language-name language-info-alist)
       (error "Language environment not defined: %S" language-name))
-  (funcall (get-language-info language-name 'setup-function))
-  (setq current-language-environment language-name)
+  (if current-language-environment
+      (let ((func (get-language-info current-language-environment
+                                    'exit-function)))
+       (run-hooks 'exit-language-environment-hook)
+       (if (fboundp func) (funcall func))))
+  (let ((default-eol-type (coding-system-eol-type
+                          default-buffer-file-coding-system)))
+    (reset-language-environment)
+
+    (setq current-language-environment language-name)
+    (set-language-environment-coding-systems language-name default-eol-type))
+  (let ((input-method (get-language-info language-name 'input-method)))
+    (when input-method
+      (setq default-input-method input-method)
+      (if input-method-history
+         (setq input-method-history
+               (cons input-method
+                     (delete input-method input-method-history))))))
+  ;; (let ((nonascii (get-language-info language-name 'nonascii-translation))
+  ;;       (dos-table
+  ;;        (if (eq window-system 'pc)
+  ;;            (intern
+  ;;             (concat "cp" dos-codepage "-nonascii-translation-table")))))
+  ;;   (cond
+  ;;    ((char-table-p nonascii)
+  ;;     (setq nonascii-translation-table nonascii))
+  ;;    ((and (eq window-system 'pc) (boundp dos-table))
+  ;;     ;; DOS terminals' default is to use a special non-ASCII translation
+  ;;     ;; table as appropriate for the installed codepage.
+  ;;     (setq nonascii-translation-table (symbol-value dos-table)))
+  ;;    ((charsetp nonascii)
+  ;;     (setq nonascii-insert-offset (- (make-char nonascii) 128)))))
+
+  ;; (setq charset-origin-alist
+  ;;       (get-language-info language-name 'charset-origin-alist))
+
+  ;; Unibyte setups if necessary.
+  ;; (unless default-enable-multibyte-characters
+  ;;   ;; Syntax and case table.
+  ;;   (let ((syntax (get-language-info language-name 'unibyte-syntax)))
+  ;;     (if syntax
+  ;;         (let ((set-case-syntax-set-multibyte nil))
+  ;;           (load syntax nil t))
+  ;;       ;; No information for syntax and case.  Reset to the defaults.
+  ;;       (let ((syntax-table (standard-syntax-table))
+  ;;             (case-table (standard-case-table))
+  ;;             (ch (if (eq window-system 'pc) 128 160)))
+  ;;         (while (< ch 256)
+  ;;           (modify-syntax-entry ch " " syntax-table)
+  ;;           (aset case-table ch ch)
+  ;;           (setq ch (1+ ch)))
+  ;;         (set-char-table-extra-slot case-table 0 nil)
+  ;;         (set-char-table-extra-slot case-table 1 nil)
+  ;;         (set-char-table-extra-slot case-table 2 nil))
+  ;;       (set-standard-case-table (standard-case-table))
+  ;;       (let ((list (buffer-list)))
+  ;;         (while list
+  ;;           (with-current-buffer (car list)
+  ;;             (set-case-table (standard-case-table)))
+  ;;           (setq list (cdr list))))))
+  ;;   ;; Display table and coding system for terminal.
+  ;;   (let ((coding (get-language-info language-name 'unibyte-display)))
+  ;;     (if coding
+  ;;         (standard-display-european-internal)
+  ;;       (standard-display-default (if (eq window-system 'pc) 128 160) 255)
+  ;;       (aset standard-display-table 146 nil))
+  ;;     (or (eq window-system 'pc)
+  ;;         (set-terminal-coding-system coding))))
+
+  (let ((required-features (get-language-info language-name 'features)))
+    (while required-features
+      (require (car required-features))
+      (setq required-features (cdr required-features))))
+  (let ((func (get-language-info language-name 'setup-function)))
+    (if (fboundp func)
+       (funcall func)))
+  (run-hooks 'set-language-environment-hook)
   (force-mode-line-update t))
 
+;; (defun standard-display-european-internal ()
+;;   ;; Actually set up direct output of non-ASCII characters.
+;;   (standard-display-8bit (if (eq window-system 'pc) 128 160) 255)
+;;   ;; Unibyte Emacs on MS-DOS wants to display all 8-bit characters with
+;;   ;; the native font, and codes 160 and 146 stand for something very
+;;   ;; different there.
+;;   (or (and (eq window-system 'pc) (not default-enable-multibyte-characters))
+;;       (progn
+;;         ;; Make non-line-break space display as a plain space.
+;;         ;; Most X fonts do the wrong thing for code 160.
+;;         (aset standard-display-table 160 [32])
+;;         ;; Most Windows programs send out apostrophe's as \222.  Most X fonts
+;;         ;; don't contain a character at that position.  Map it to the ASCII
+;;         ;; apostrophe.
+;;         (aset standard-display-table 146 [39]))))
+
+(defun set-language-environment-coding-systems (language-name
+                                               &optional eol-type)
+  "Do various coding system setups for language environment LANGUAGE-NAME.
+
+The optional arg EOL-TYPE specifies the eol-type of the default value
+of buffer-file-coding-system set by this function.
+
+Note that `coding-priority-list' is not reset first; thus changing language
+environment allows recognition of coding systems from previously set language
+environments.  (This will not work if the desired coding systems are from the
+same category.  E.g., starting with a Hebrew language environment, ISO 8859-8
+will be recognized.  If you shift to Russian, ISO 8859-8 will be shadowed by
+ISO 8859-5, and cannot be automatically recognized without resetting the
+language environment to Hebrew.  However, if you shift from Japanese to
+Russian, ISO-2022-JP will continue to be automatically recognized, since
+ISO-8859-5 and ISO-2022-JP are different coding categories.)"
+  (let* ((priority (get-language-info language-name 'coding-priority))
+        (default-coding (car priority)))
+    (if priority
+       (let ((categories (mapcar 'coding-system-category priority))
+             category checked-categories)
+         (set-default-coding-systems
+          (if (memq eol-type '(lf crlf cr unix dos mac))
+              (coding-system-change-eol-conversion default-coding eol-type)
+            default-coding))
+          ;; (setq default-sendmail-coding-system default-coding)
+         (while priority
+           (unless (memq (setq category (car categories)) checked-categories)
+             (set-coding-category-system category (car priority))
+             (setq checked-categories (cons category checked-categories)))
+           (setq priority (cdr priority)
+                 categories (cdr categories)))
+         (set-coding-priority-list (nreverse checked-categories))
+          ;; (update-coding-systems-internal)
+         ))))
+
 ;; Print all arguments with `princ', then print "\n".
 (defsubst princ-list (&rest args)
   (while args (princ (car args)) (setq args (cdr args)))
   (princ "\n"))
 
+(put 'describe-specified-language-support 'apropos-inhibit t)
+
 ;; Print a language specific information such as input methods,
 ;; charsets, and coding systems.  This function is intended to be
 ;; called from the menu:
@@ -611,7 +955,7 @@ and sometimes other things."
   (interactive
    (list (read-language-name
          'documentation
-         "Describe language environment (default, current choise): ")))
+         "Describe language environment (default, current choice): ")))
   (if (null language-name)
       (setq language-name current-language-environment))
   (if (or (null language-name)
@@ -621,8 +965,9 @@ and sometimes other things."
       (setq language-name (symbol-name language-name)))
   (let ((doc (get-language-info language-name 'documentation)))
     (with-output-to-temp-buffer "*Help*"
+      (princ-list language-name " language environment" "\n")
       (if (stringp doc)
-         (progn
+         (progn
            (princ-list doc)
            (terpri)))
       (let ((str (get-language-info language-name 'sample-text)))
@@ -631,9 +976,15 @@ and sometimes other things."
              (princ "Sample text:\n")
              (princ-list "  " str)
              (terpri))))
-      (princ "Input methods:\n")
-      (let ((l input-method-alist))
-       (while l
+      (let ((input-method (get-language-info language-name 'input-method))
+           (l (copy-sequence input-method-alist)))
+       (princ "Input methods")
+       (when input-method
+         (princ (format " (default, %s)" input-method))
+         (setq input-method (assoc input-method input-method-alist))
+         (setq l (cons input-method (delete input-method l))))
+       (princ ":\n")
+       (while l
          (if (string= language-name (nth 1 (car l)))
              (princ-list "  " (car (car l))
                          (format " (`%s' in mode line)" (nth 3 (car l)))))
@@ -656,9 +1007,14 @@ and sometimes other things."
            (princ ; (format "  %s (`%c' in mode line):\n\t%s\n"
             ;; In XEmacs, `coding-system-mnemonic' returns string.
             (format "  %s (`%s' in mode line):\n\t%s\n"
-                    (car l)
-                    (coding-system-mnemonic (car l))
-                    (coding-system-doc-string (car l))))
+                          (car l)
+                          (coding-system-mnemonic (car l))
+                          (coding-system-doc-string (car l))))
+            ;; (let ((aliases (coding-system-get (car l) 'alias-coding-systems)))
+            ;;   (when aliases
+            ;;     (princ "\t")
+            ;;     (princ (cons 'alias: (cdr aliases)))
+            ;;     (terpri)))
            (setq l (cdr l))))))))
 \f
 ;;; Charset property
@@ -678,7 +1034,7 @@ and sometimes other things."
 (defvar char-code-property-table
   (make-char-table 'generic)
   "Char-table containing a property list of each character code.
-;; 
+
 See also the documentation of `get-char-code-property' and
 `put-char-code-property'")
 ;;   (let ((plist (aref char-code-property-table char)))
@@ -699,8 +1055,70 @@ It can be retrieved with `(get-char-code-property CHAR PROPNAME)'."
            (nconc plist (list propname value))))
       (put-char-table char (list propname value) char-code-property-table)
       )))
-;;               (setcar (cdr slot) value)
-;;             (nconc plist (list propname value))))
-;;       (aset char-code-property-table char (list propname value)))))
+
+\f
+;; Pretty description of encoded string
+
+;; Alist of ISO 2022 control code vs the corresponding mnemonic string.
+;; (defvar iso-2022-control-alist
+;;   '((?\x1b . "ESC")
+;;     (?\x0e . "SO")
+;;     (?\x0f . "SI")
+;;     (?\x8e . "SS2")
+;;     (?\x8f . "SS3")
+;;     (?\x9b . "CSI")))
+
+;; (defun encoded-string-description (str coding-system)
+;;   "Return a pretty description of STR that is encoded by CODING-SYSTEM."
+;;   (setq str (string-as-unibyte str))
+;;   (let ((char (aref str 0))
+;;         desc)
+;;     (when (< char 128)
+;;       (setq desc (or (cdr (assq char iso-2022-control-alist))
+;;                      (char-to-string char)))
+;;       (let ((i 1)
+;;             (len (length str))) 
+;;         (while (< i len)
+;;           (setq char (aref str i))
+;;           (if (>= char 128)
+;;               (setq desc nil i len)
+;;             (setq desc (concat desc " "
+;;                                (or (cdr (assq char iso-2022-control-alist))
+;;                                    (char-to-string char)))
+;;                   i (1+ i))))))
+;;     (or desc
+;;         (mapconcat (function (lambda (x) (format "0x%02x" x))) str " "))))
+
+;; (defun encode-coding-char (char coding-system)
+;;   "Encode CHAR by CODING-SYSTEM and return the resulting string.
+;; If CODING-SYSTEM can't safely encode CHAR, return nil."
+;;   (if (cmpcharp char)
+;;       (setq char (car (decompose-composite-char char 'list))))
+;;   (let ((str1 (char-to-string char))
+;;         (str2 (make-string 2 char))
+;;         (safe-charsets (and coding-system
+;;                             (coding-system-get coding-system 'safe-charsets)))
+;;         enc1 enc2 i1 i2)
+;;     (when (or (eq safe-charsets t)
+;;               (memq (char-charset char) safe-charsets))
+;;       ;; We must find the encoded string of CHAR.  But, just encoding
+;;       ;; CHAR will put extra control sequences (usually to designate
+;;       ;; ASCII charset) at the tail if type of CODING is ISO 2022.
+;;       ;; To exclude such tailing bytes, we at first encode one-char
+;;       ;; string and two-char string, then check how many bytes at the
+;;       ;; tail of both encoded strings are the same.
+;; 
+;;       (setq enc1 (string-as-unibyte (encode-coding-string str1 coding-system))
+;;             i1 (length enc1)
+;;             enc2 (string-as-unibyte (encode-coding-string str2 coding-system))
+;;             i2 (length enc2))
+;;       (while (and (> i1 0) (= (aref enc1 (1- i1)) (aref enc2 (1- i2))))
+;;         (setq i1 (1- i1) i2 (1- i2)))
+;; 
+;;       ;; Now (substring enc1 i1) and (substring enc2 i2) are the same,
+;;       ;; and they are the extra control sequences at the tail to
+;;       ;; exclude.
+;;       (substring enc2 0 i2))))
+
 
 ;;; mule-cmds.el ends here