2.3 Things required to run emacs-w3m

Depending on the version of Emacs, third party packages may be required. This section provides resources to help you find and install them.

`APEL'

Indispensable to XEmacs, Emacs 19.34 or Mule 2.3. You should install APEL before building emacs-w3m. APEL is available at:

ftp://ftp.m17n.org/pub/mule/apel/apel-10.6.tar.gz

Note that you must not use the APEL XEmacs package (which is contained in SUMO). If you have already installed the APEL XEmacs package, use the following directives to replace it with APEL which is linked above (you can also use the same directives in order to newly install APEL):

% rm -fr /usr/local/lib/xemacs/xemacs-packages/lisp/apel % cd apel-10.6 % make install-package XEMACS=xemacs-21.4.x\ PACKAGEDIR=/usr/local/lib/xemacs/xemacs-packages

`gifsicle'

Indispensable to XEmacs. There is a known bug in all XEmacs 21.x series that won't let it display optimized animated gifs correctly or may make it crash when some kind of an interlaced gif image is displayed. Emacs-w3m uses the `gifsicle' program to convert gif data in order to make it possible to be handled by XEmacs 21.x. It is available at:

http://www.lcdf.org/gifsicle/

`ImageMagick'

If the `convert' program bundled with the ImageMagick package is available on your system, emacs-w3m will use it to resize images or to convert `favicon' images into a format Emacs can handle. Emacs-w3m will work without ImageMagick, but installing it will improve your surfing experience. You can get the ImageMagick package from:

ftp://ftp.imagemagick.org/pub/ImageMagick/

To manipulate `favicon' images, we recommend version 5.4.0-5 and later, previous versions may work but we didn't check them thoroughly.

`BITMAP-MULE'

Used to display monochrome bitmap images inline in Emacs 20.x or Mule 2.3 based on Emacs 19.34. It isn't necessary if you aren't interested in images. It is available at:

ftp://ftp.jpl.org/pub/elisp/bitmap/

`new custom'

Indispensable to Emacs 19.34 (including Mule 2.3). The `custom' library bundled with Emacs 19.34 is too old, its API is incompatible with the `new custom' bundled with recent Emacsen. The `new custom' for Emacs 19.34 is available at:

ftp://ftp.dina.kvl.dk/pub/Staff/Per.Abrahamsen/custom/custom-1.9962.tar.gz

Note that Mule 2.3 users should slightly modify it by applying the following patch:

----8<------8<------8<------8<------8<------8<------8<------8<---- --- custom-1.9962/cus-face.el~ Wed Mar 4 19:52:39 1998 +++ custom-1.9962/cus-face.el Mon Mar 9 08:05:33 1998 @@ -96,7 +96,7 @@ "Define a new FACE on all frames, ignoring X resources." (interactive "SMake face: ") (or (internal-find-face name) - (let ((face (make-vector 8 nil))) + (let ((face (make-vector face-vector-length nil))) (aset face 0 'face) (aset face 1 name) (let* ((frames (frame-list)) ----8<------8<------8<------8<------8<------8<------8<------8<----

`regexp-opt.el'

Indispensable to Emacs 19.34 (including Mule 2.3). The `regexp-opt.el' file is included in the `attic/' directory of the emacs-w3m distribution. You may simply copy it somewhere (e.g. `site-lisp/' directory) and perform byte-compilation as follows:

# cp -p attic/regexp-opt.el /usr/local/share/emacs/19.34/site-lisp # cd /usr/local/share/emacs/19.34/site-lisp # emacs -batch -q -no-site-file -f batch-byte-compile regexp-opt.el

`FLIM'

The FLIM package is required to use the `shimbun' library. The `shimbun' library is a collection of tools for reading web newspapers, you can use it with Gnus, Mew, Nana-gnus, T-gnus, Wanderlust, etc. See section 9. A tool for reading a newspaper.

Note that the FLIM package requires the APEL package even if you are using Emacs 20.x, Emacs 21.x or Emacs 22.x. Therefore, you must install both APEL and FLIM if you would like to use the `shimbun' library. The FLIM package is available at:

ftp://ftp.m17n.org/pub/mule/flim/flim-1.14/

`xml.el'

This file is required to use `shimbun' modules designed for sites which provide update information with RSS format. Because it is distributed with Emacs 21 and later, you do not need to install it if you use Emacs 21 or later. Otherwise, you may simply copy it somewhere (e.g. the Emacs `site-lisp/' directory) and perform byte-compilation as follows:

# cp -p attic/xml.el /usr/local/share/emacs/20.7/site-lisp # cd /usr/local/share/emacs/20.7/site-lisp # emacs -batch -q -no-site-file -f batch-byte-compile xml.el

If you use Emacs 19.34 (including Mule 2.3), additional options are required for byte-compilation as follows:

# emacs -batch -eval '(put (quote char-after) (quote byte-compile) nil)' -f batch-byte-compile xml.el

`Mule-UCS'

The Mule-UCS Emacs Lisp package makes your Emacs handle the Unicode system. We recommend you install this package so that emacs-w3m can display pages written in UTF-8, etc. It is available at:

ftp://ftp.m17n.org/pub/mule/Mule-UCS/Mule-UCS-0.84.tar.gz

When Mule-UCS is installed for Emacs-21.2, it is necessary to apply this patch before installation.

If you are an XEmacs user, the compiled package is here:

ftp://ftp.xemacs.org/packages/mule-ucs-1.04-pkg.tar.gz