emu-20.el

   1 ;;; emu-20.el --- emu API implementation for Emacs 20 and XEmacs/mule
   2
   3 ;; Copyright (C) 1997,1998 Free Software Foundation, Inc.
   4
   5 ;; Author: MORIOKA Tomohiko <morioka@jaist.ac.jp>
   6 ;; Keywords: emulation, compatibility, Mule
   7
   8 ;; This file is part of emu.
   9
  10 ;; This program is free software; you can redistribute it and/or
  11 ;; modify it under the terms of the GNU General Public License as
  12 ;; published by the Free Software Foundation; either version 2, or (at
  13 ;; your option) any later version.
  14
  15 ;; This program is distributed in the hope that it will be useful, but
  16 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
  17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  18 ;; General Public License for more details.
  19
  20 ;; You should have received a copy of the GNU General Public License
  21 ;; along with GNU Emacs; see the file COPYING.  If not, write to the
  22 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  23 ;; Boston, MA 02111-1307, USA.
  24
  25 ;;; Commentary:
  26
  27 ;;    This module requires Emacs 20.0.93, XEmacs 20.3-b5 (with mule)
  28 ;;    or later.
  29
  30 ;;; Code:
  31
  32 (require 'custom)
  33 (eval-when-compile (require 'wid-edit))
  34
  35
  36 ;;; @ without code-conversion
  37 ;;;
  38
  39 (defmacro as-binary-process (&rest body)
  40   `(let (selective-display      ; Disable ^M to nl translation.
  41          (coding-system-for-read  'binary)
  42          (coding-system-for-write 'binary))
  43      ,@body))
  44
  45 (defmacro as-binary-input-file (&rest body)
  46   `(let ((coding-system-for-read 'binary))
  47      ,@body))
  48
  49 (defmacro as-binary-output-file (&rest body)
  50   `(let ((coding-system-for-write 'binary))
  51      ,@body))
  52
  53 (defun write-region-as-binary (start end filename
  54                                      &optional append visit lockname)
  55   "Like `write-region', q.v., but don't encode."
  56   (let ((coding-system-for-write 'binary))
  57     (write-region start end filename append visit lockname)))
  58
  59 (defun insert-file-contents-as-binary (filename
  60                                        &optional visit beg end replace)
  61   "Like `insert-file-contents', q.v., but don't code and format conversion.
  62 Like `insert-file-contents-literary', but it allows find-file-hooks,
  63 automatic uncompression, etc.
  64
  65 Namely this function ensures that only format decoding and character
  66 code conversion will not take place."
  67   (let ((coding-system-for-read 'binary)
  68         format-alist)
  69     ;; Returns list of absolute file name and length of data inserted.
  70     (insert-file-contents filename visit beg end replace)))
  71
  72 (defun insert-file-contents-as-raw-text (filename
  73                                          &optional visit beg end replace)
  74   "Like `insert-file-contents', q.v., but don't code and format conversion.
  75 Like `insert-file-contents-literary', but it allows find-file-hooks,
  76 automatic uncompression, etc.
  77 Like `insert-file-contents-as-binary', but it converts line-break
  78 code."
  79   (let ((coding-system-for-read 'raw-text)
  80         format-alist)
  81     ;; Returns list of absolute file name and length of data inserted.
  82     (insert-file-contents filename visit beg end replace)))
  83
  84 (defun write-region-as-raw-text-CRLF (start end filename
  85                                             &optional append visit lockname)
  86   "Like `write-region', q.v., but write as network representation."
  87   (let ((coding-system-for-write 'raw-text-dos))
  88     (write-region start end filename append visit lockname)))
  89
  90
  91 ;;; @@ Mule emulating aliases
  92 ;;;
  93 ;;; You should not use it.
  94
  95 (defconst *noconv* 'binary
  96   "Coding-system for binary.
  97 This constant is defined to emulate old MULE anything older than MULE
  98 2.3.  It is obsolete, so don't use it.")
  99
 100
 101 ;;; @ MIME charset
 102 ;;;
 103
 104 (defcustom mime-charset-coding-system-alist
 105   `,(let ((rest
 106            '((us-ascii      . raw-text)
 107              (gb2312        . cn-gb-2312)
 108              (iso-2022-jp-2 . iso-2022-7bit-ss2)
 109              (x-ctext       . ctext)
 110              (unknown       . undecided)
 111              (x-unknown     . undecided)
 112              ))
 113           dest)
 114       (while rest
 115         (let ((pair (car rest)))
 116           (or (find-coding-system (car pair))
 117               (setq dest (cons pair dest))
 118               ))
 119         (setq rest (cdr rest))
 120         )
 121       dest)
 122   "Alist MIME CHARSET vs CODING-SYSTEM.
 123 MIME CHARSET and CODING-SYSTEM must be symbol."
 124   :group 'i18n
 125   :type '(repeat (cons symbol coding-system)))
 126
 127 (defsubst mime-charset-to-coding-system (charset &optional lbt)
 128   "Return coding-system corresponding with CHARSET.
 129 CHARSET is a symbol whose name is MIME charset.
 130 If optional argument LBT (`CRLF', `LF', `CR', `unix', `dos' or `mac')
 131 is specified, it is used as line break code type of coding-system."
 132   (if (stringp charset)
 133       (setq charset (intern (downcase charset)))
 134     )
 135   (let ((ret (assq charset mime-charset-coding-system-alist)))
 136     (if ret
 137         (setq charset (cdr ret))
 138       ))
 139   (if lbt
 140       (setq charset (intern (format "%s-%s" charset
 141                                     (cond ((eq lbt 'CRLF) 'dos)
 142                                           ((eq lbt 'LF) 'unix)
 143                                           ((eq lbt 'CR) 'mac)
 144                                           (t lbt)))))
 145     )
 146   (if (find-coding-system charset)
 147       charset
 148     ))
 149
 150 (defsubst mime-charset-list ()
 151   "Return a list of all existing MIME-charset."
 152   (nconc (mapcar (function car) mime-charset-coding-system-alist)
 153          (coding-system-list)))
 154
 155
 156 (defvar widget-mime-charset-prompt-value-history nil
 157   "History of input to `widget-mime-charset-prompt-value'.")
 158
 159 (define-widget 'mime-charset 'coding-system
 160   "A mime-charset."
 161   :format "%{%t%}: %v"
 162   :tag "MIME-charset"
 163   :prompt-history 'widget-mime-charset-prompt-value-history
 164   :prompt-value 'widget-mime-charset-prompt-value
 165   :action 'widget-mime-charset-action)
 166
 167 (defun widget-mime-charset-prompt-value (widget prompt value unbound)
 168   ;; Read mime-charset from minibuffer.
 169   (intern
 170    (completing-read (format "%s (default %s) " prompt value)
 171                     (mapcar (function
 172                              (lambda (sym)
 173                                (list (symbol-name sym))))
 174                             (mime-charset-list)))))
 175
 176 (defun widget-mime-charset-action (widget &optional event)
 177   ;; Read a mime-charset from the minibuffer.
 178   (let ((answer
 179          (widget-mime-charset-prompt-value
 180           widget
 181           (widget-apply widget :menu-tag-get)
 182           (widget-value widget)
 183           t)))
 184     (widget-value-set widget answer)
 185     (widget-apply widget :notify widget event)
 186     (widget-setup)))
 187
 188 (defcustom default-mime-charset 'x-ctext
 189   "Default value of MIME-charset.
 190 It is used when MIME-charset is not specified.
 191 It must be symbol."
 192   :group 'i18n
 193   :type 'mime-charset)
 194
 195 (defsubst detect-mime-charset-region (start end)
 196   "Return MIME charset for region between START and END."
 197   (charsets-to-mime-charset (find-charset-region start end)))
 198
 199 (defun write-region-as-mime-charset (charset start end filename
 200                                              &optional append visit lockname)
 201   "Like `write-region', q.v., but encode by MIME CHARSET."
 202   (let ((coding-system-for-write
 203          (or (mime-charset-to-coding-system charset)
 204              'binary)))
 205     (write-region start end filename append visit lockname)))
 206
 207
 208 ;;; @ end
 209 ;;;
 210
 211 (provide 'emu-20)
 212
 213 ;;; emu-20.el ends here