2.2 Configure
The first step is to configure the source code, telling it where
various files will be. To do so, run
./configure options
(Note: if you have fetched preview-latex from CVS rather than
a regular release, you will have to first generate ./configure by
running autogen.sh in the preview directory.)
On many machines, you will not need to specify any options, but if
configure cannot determine something on its own, you'll need to
help it out with one of these options:
--prefix=/usr/local- All automatic placements for package components will be chosen from
sensible existing hierarchies below this. /usr/local is the
default setting for site-wide installation. If you are packaging this
as an operating system component for distribution, the setting
/usr will probably be the right choice. If you are planning to
install the package as a single non-priviledged user, you will typically
set prefix to your home directory. And if you have installed an
alternative version of Emacs for testing purposes, the prefix (something
like /usr/local/emacs-22) will be the same you used when
installing Emacs.
--with-emacs[=/path/to/emacs]- If you are using a pretest which isn't in your
$PATH, or
configure is not finding the right Emacs executable, you can
specify it with this option.
--with-xemacs[=/path/to/xemacs]- Configure for generation under XEmacs (Emacs is the default). Again,
the name of the right XEmacs executable can be specified, complete with
path if necessary.
--with-packagedir=/dir- is an XEmacs-only option giving the location of the package directory.
This will install and activate the package. Emacs uses a different
installation scheme:
--with-lispdir=/dir- This specifies the location of the startup file preview-latex.el
which should be somewhere in the load-path. configure
should figure this out by itself. However, some Emacs installations
have a directory commonly called site-start.d/ where files get
automatically loaded. If you want preview-latex to be activated
automatically, you can specify such a startup directory here. If you do
this, you'll also need
--with-packagelispdir=../preview- This is the directory where the bulk of the package gets located. Since
preview-latex.el already adds this into load-path, you
don't need to place it in the search path. You might want to place an
empty file called .nosearch in this directory to speed up
searches. If this directory is given with a relative path, it is
considered relative to the lispdir variable. The proposed
setting would be typical if you set lispdir to some
site-lisp/site-start.d/ directory.
--with-tex-site=/dir- If AUCTeX is installed in a non-standard location, use this option to
specify the location of its tex-site.el file so that it can be
found during compilation.
--with-texmf-dir=/dir
--with-tex-dir=- Both of these options can be used to specify the location to install the
preview TeX files. They are not necessary for most TeX installs,
but may be used if you don't like the directory that configure is
suggesting. Using
--with-texmf-dir=/dir you can specify
where the TeX TDS directory hierarchy resides, and the
TeX files will be installed in /dir/tex/latex/preview/.
If you want to specify an exact directory for the preview TeX files,
use --with-tex-dir=/dir. In this case, the files will be
placed in /dir.
--with-doc-dir=/dir- This option may be used to specify where the TeX documentation goes.
It is to be used when you are using
--with-tex-dir=/dir,
but is normally not necessary otherwise.
--help- This is not an option specific to preview-latex. A number of standard
options to configure exist, and we do not have the room to
describe them here; a short description of each is available, using
--help.