No description, website, or topics provided.
Emacs Lisp
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


[README for BITMAP-MULE (English Version)]
by MORIOKA Tomohiko
   and Katsumi YAMAOKA

IMPORTANT notice to Mule-UCS on Emacs 20 users !!
If you are using Emacs 20 and Mule-UCS version 0.84 or later, you have
to set the value of the variable `bitmap-alterable-charset' explicitly,
and furthermore, you have to load un-define.elc before bitmap.elc.
The valid values for the variable `bitmap-alterable-charset' are
`indian-1-column' and `tibetan-1-column'.  Here is an example for the
startup (normally .emacs) file:

   (require 'un-define)
   (setq bitmap-alterable-charset 'tibetan-1-column)
   (require 'bitmap)

Otherwise, you can load "bitmap" before "un-define" by setting the
variable `bitmap-use-alterable-charset-anyway' to non-nil as follows:

   (setq bitmap-alterable-charset 'indian-1-column)
   (setq bitmap-use-alterable-charset-anyway t)
   (require 'bitmap)
   (require 'un-define)

In addition, you also need to change the font database for the ps-print
utility if you would like to use it.  The following form is for the use
of `tibetan-1-column', you should change it to `indian-1-column' if you
have specified `bitmap-alterable-charset' to it.

   (eval-after-load "ps-mule"
     '(let ((elem (assq 'tibetan-1-column
	(if elem
	    (setcar (cdr (cdr (car (cdr elem))))
		    '("bmp16-etl.bdf" "bitmap16.bdf")))))

Note that the variable `bitmap-alterable-charset' did not exist in
BITMAP-MULE versions earlier than 8.4, and the variable
`bitmap-use-alterable-charset-anyway' did not exist in BITMAP-MULE
versions prior to 8.5.

Notice to Emacs 21.1 users
The released version of Emacs 21.1 has a bug in decoding composite
chars.  It might come out when reading a file which contains composite
chars (encoded with `iso-2022-7bit', etc.).  You can fix this by
applying the patch and rebuilding Emacs.  The patch is included in the
BITMAP-MULE distribution.


  BITMAP-MULE is a package to use bitmap in MULE or Emacs/mule.

  BITMAP-MULE has following modules:

    - bitmap.el:	kernel of BITMAP-MULE
    - bitmap-bi.el:	functions for Emacs 20.2 or earlier
    - bitmap-ci.el:	functions for Emacs 20.3 or later
    - bm-utils.el:	utility functions.
    - po.el:		tiny BDF font editor
    - smiley-mule.el:	smiley faces encoder/decoder
    - x-face-mule.el:	inline X-Face decoder
    - x-face-18.el:	X-Face decoder for Emacs 18
    - gnus-bitmap.el:	Gnus/gnus related functions
    - vm-bitmap.el:	VM related functions

  The following image files will be integrated into gnus-bitmap.el at
  the complile time.

    - gnus.xbm:		big gnu for splashing the startup screen
    - gnus-pointer.xbm:	small gnu for the modeline identification


(0) Before installing it, please install APEL (9.22 or later) package,
    font for BITMAP 8x16 and uncompface program.  If you would like to
    use 6x12, 7x14, 10x20 or 12x24 size fonts, please install them as
    well.  They can be generated with running `make' in the font/
    directory, or you can get the ready-made fonts from the same place
    of the BITMAP-MULE distribution.  See font/README.{en,ja} for more

  APEL package is available from:

  uncompface program is included in compface package which is available

(1-a) Run in expanded place

  If you don't want to install other directories, please do only

	% make

  You can specify the emacs command name, for example

	% make EMACS=emacs-20.7

  If `EMACS=...' is omitted, EMACS=emacs is used.

(1-b) Install

  If you want to install other directories, please do following:

	% make install

  You can specify the emacs command name, for example

	% make install EMACS=emacs-20.7

  If `EMACS=...' is omitted, EMACS=emacs is used.

  You can specify the prefix of the directory tree for Emacs Lisp
  programs and shell scripts, for example:

	% make install PREFIX=~/

  If `PREFIX=...' is omitted, the prefix of the directory tree of the
  specified emacs command is used (perhaps /usr/local).

  For example, if PREFIX=/usr/local is specified, it will create the
  following directory:

	/usr/local/share/emacs/site-lisp/bitmap/ --- BITMAP-MULE

  You can specify site-lisp directory, for example

	% make install LISPDIR=~/share/emacs/lisp

  If `LISPDIR=...' is omitted, site-lisp directory of the specified
  emacs command is used (perhaps /usr/local/share/emacs/site-lisp).

  If the emu modules (included in APEL package) have been installed in
  the non-standard directory, you should specify where they will be
  found, for example:

	% make install VERSION_SPECIFIC_LISPDIR=~/elisp

  You can specify other optional settings by editing the file
  bitmap-mule/BITMAP-CFG.  Please read comments in

(2) More useful informations can be found at the following web sites:

Bug reports

  If you write bug-reports and/or suggestions for improvement, please
  send them to Elips Mailing List:

  Elips mailing list is for discussing all sorts of Emacsen, mainly in
  Japanese.  To join Elips ML, please introduce yourself briefly in an
  e-mail to

  Via Elips ML, you can report BITMAP-MULE related bugs, obtain the
  latest release of BITMAP-MULE, and discuss future enhancements to

CVS based development

  If you would like to join CVS based development, please send mail to

  with your account name and your public key for ssh.  cvsroot is

  If you cannot use ssh, please send UNIX /etc/passwd style crypted
  password.  you can commit with the cvsroot

  We hope you will join the open development.