2.4 Installing emacs-w3m

See the official page http://emacs-w3m.namazu.org/ for instructions on how to get the latest emacs-w3m. Is everything ready? Now, let's begin.

In order to install emacs-w3m on non-UNIX-like systems (or any system lacking the ability to execute the `configure' script or has no `make' command), skip this section and go to the next section See section 2.5 Installing on non-UNIX-like systems.

1. First, extract a tarball of the emacs-w3m distribution and enter the top directory as follows:

   % tar zxf emacs-w3m-1.4.4.tar.gz % cd emacs-w3m-1.4.4

   If you've checked out emacs-w3m from CVS, you have to run `autoconf' with no argument to generate the `configure' script.

2. Run the `configure' script.

   % ./configure

   Important notice to Gnus users:

   If multiple versions of Gnus are installed on your system (it is likely that there are the released version and the development version of Gnus), make sure that the load-path contains the directory where the version you use is installed (check for the `gnus.elc' file). You can ensure that with the `--with-addpath' option as follows:

   % ./configure --with-addpath=/usr/local/share/emacs/site-lisp/gnus

   If you've installed APEL, FLIM or something in non-standard directories other than the default load-path, you must specify them using the `--with-addpath' option as follows (you may also include the Gnus directory in it separated with `:'):

   % ./configure --with-addpath=/opt/share/apel:/opt/share/flim

3. Just run `make' and `make install'. See also the next step if you are using XEmacs.

   % make % make install

   All Lisp and info files will be installed in the appropriate directories. Now, how do you know what files will go where? To know it beforehand, use this:

   % make what-where

   If you are using Emacs 21, 22 or XEmacs, you had better install icon image files. To do this:

   % make install-icons

   or

   % make install-icons30

   The later is for using the slightly larger icon images.

4. You can also install emacs-w3m as an XEmacs package using `make install-package' instead of `make install' as follows:

   % make % make install-package

   In this case, you don't have to execute `make install-icons' nor `make install-icons30'.

   If you need to specify the package directory, there are two ways to do that:

   • Use the `configure' option `--with-packagedir='. For example:

     % ./configure --with-packagedir=/opt/xemacs/xemacs-packages % make what-where % make % make install-package

   • Use the `PACKAGEDIR' variable. For example:

     % ./configure % make what-where PACKAGEDIR=/opt/xemacs/xemacs-packages % make % make install-package PACKAGEDIR=/opt/xemacs/xemacs-packages