[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
The following are brief installation instructions for the impatient. In case you don't understand some of this, run into trouble of some sort, or need more elaborate information, refer to the detailed instructions further below.
For GNU Emacs: Many people like to install AUCTeX into the pseudo file system hierarchy set up by the Emacs installation. Assuming Emacs is installed in `C:/Program Files/Emacs' and the directory for local additions of your TeX system, e.g. MiKTeX, is `C:/localtexmf', you can do this by typing the following statement at the shell prompt:
./configure --prefix='C:/Program Files/Emacs' \ --with-texmf-dir='C:/localtexmf' |
For XEmacs: You can install AUCTeX as an XEmacs package. Assuming XEmacs is installed in `C:/Program Files/XEmacs' and the directory for local additions of your TeX system, e.g. MiKTeX, is `C:/localtexmf', you can do this by typing the following command at the shell prompt:
./configure --with-xemacs='C:/Program Files/XEmacs/bin/xemacs' \ --with-texmf-dir='C:/localtexmf' |
The commands above are examples for common usage. More on configuration options can be found in the detailed installation instructions below.
If the configuration script failed to find all required programs, make
sure that these programs are in your system path and add directories
containing the programs to the PATH
environment variable if
necessary. Here is how to do that in W2000/XP:
make |
In case there were, please refer to the detailed description below.
make install |
Installation of AUCTeX under Windows is in itself not more complicated than on other platforms. However, meeting the prerequisites might require more work than on some other platforms, and feel less natural.
If you are experiencing any problems, even if you think they are of your own making, be sure to report them to auctex-devel@gnu.org so that we can explain things better in future.
Windows is a problematic platform for installation scripts. The main problem is that the installation procedure requires consistent file names in order to find its way in the directory hierarchy, and Windows path names are a mess.
The installation procedure tries finding stuff in system search paths
and in Emacs paths. For that to succeed, you have to use the same
syntax and spelling and case of paths everywhere: in your system search
paths, in Emacs' load-path
variable, as argument to the scripts.
If your path names contain spaces or other `shell-unfriendly'
characters, most notably backslashes for directory separators, place the
whole path in `"double quote marks"' whenever you specify it on a
command line.
Avoid `helpful' magic file names like `/cygdrive/c' and `C:\PROGRA~1\' like the plague. It is quite unlikely that the scripts will be able to identify the actual file names involved. Use the full paths, making use of normal Windows drive letters like ` 'C:/Program Files/Emacs' ' where required, and using the same combination of upper- and lowercase letters as in the actual files. File names containing shell-special characters like spaces or backslashes (if you prefer that syntax) need to get properly quoted to the shell: the above example used single quotes for that.
Ok, now here are the steps to perform:
Line endings are a problem under Windows. The distribution contains only text files, and theoretically most of the involved tools should get along with that. However, the files are processed by various utilities, and it is conceivable that not all of them will use the same line ending conventions. If you encounter problems, it might help if you try unpacking (or checking out) the files in binary mode, if your tools allow that.
If you don't have a suitable unpacking tool, skip to the next step: this should provide you with a working `unzip' command.
If Cygwin specific paths like `/cygdrive/c' crop up in the course of the installation, using a non-Cygwin Emacs could conceivably cause trouble. Using Cygwin either for everything or nothing might save headaches, if things don't work out.
If you don't want to use a developer version and Emacs 22 has not yet been released, it is also possible to use an Emacs 21 binary from http://ftp.gnu.org/pub/gnu/windows/emacs/, but then you should disable the installation of preview-latex (it will not work). Since the developer version has seen quite a few improvements relevant also for other features of AUCTeX, we really recommend you give it a try.
gswin32c -h |
on a Windows command line should tell you whether your Ghostscript
supports the png16m
device needed for PNG support.
MiKTeX apparently comes with its own Ghostscript called `mgs.exe'.
\n
when reading text files,
you'll run into trouble.
bash
) capable of
running configure
, change into the installation directory and
call ./configure
with appropriate options.
Typical options you'll want to specify will be
--prefix=drive:/path/to/emacs-hierarchy
which tells `configure' where to perform the installation. It may also make `configure' find Emacs or XEmacs automatically; if this doesn't happen, try one of `--with-emacs' or `--with-xemacs' as described below. All automatic detection of files and directories restricts itself to directories below the prefix or in the same hierarchy as the program accessing the files. Usually, directories like `man', `share' and `bin' will be situated right under prefix.
This option also affects the defaults for placing the Texinfo documentation files and automatically generated style hooks.
If you have a central directory hierarchy (not untypical with Cygwin) for such stuff, you might want to specify its root here. You stand a good chance that this will be the only option you need to supply, as long as your TeX-related executables are in your system path, which they better be for AUCTeX's operation, anyway.
--with-emacs
if you are installing for a version of Emacs. You can use
`--with-emacs=drive:/path/to/emacs' to specify the name of the
installed Emacs executable, complete with its path if necessary (if
Emacs is not within a directory specified in your PATH
environment
setting).
--with-xemacs
if you are installing for a version of XEmacs. Again, you can use
`--with-xemacs=drive:/path/to/xemacs' to specify the name of the
installed XEmacs executable complete with its path if necessary. It may
also be necessary to specify this option if a copy of Emacs is found in
your PATH
environment setting, but you still would like to install
a copy of AUCTeX for XEmacs.
--with-packagedir=drive:/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=drive:/path/to/site-lisp
This Emacs-only option tells a place in load-path
below which the
files are situated. The startup files `auctex.el' and
`preview-latex.el' will get installed here unless a subdirectory
`site-start.d' exists which will then be used instead. The other
files from AUCTeX will be installed in a subdirectory called
`auctex'.
If you think that you need a different setup, please refer to the full installation instructions in Configure.
--with-auto-dir=drive:/dir
Directory containing automatically generated information. You should not normally need to set this, as `--prefix' should take care of this.
--disable-preview
Use this option if your Emacs version is unable to support image display. This will be the case if you are using a native variant of Emacs 21.
--with-texmf-dir=drive:/dir
This will specify the directory where your TeX installation sits. If your TeX installation does not conform to the TDS (TeX directory standard), you may need to specify more options to get everything in place:
For more information about any of the above and additional options, see Configure.
Calling `./configure --help=recursive' will tell about other options, but those are almost never required.
Some executables might not be found in your path. That is not a good idea, but you can get around by specifying environment variables to `configure':
GS="drive:/path/to/gswin32c.exe" ./configure … |
should work for this purpose. `gswin32c.exe' is the usual name for the required command line executable under Windows; in contrast, `gswin32.exe' is likely to fail.
As an alternative to specifying variables for the `configure' call
you can add directories containing the required executables to the
PATH
variable of your Windows system. This is especially a good
idea if Emacs has trouble finding the respective programs later during
normal operation.
make
in the installation directory.
make install
in the installation directory.
(load "auctex.el" nil t t) (load "preview-latex.el" nil t t) |
in either a site-wide `site-start.el' or your personal startup file (usually accessible as `~/.emacs' from within Emacs and `~/.xemacs/init.el' from within XEmacs).
The default configuration of AUCTeX is probably not the best fit for Windows systems. You might want to additionally use
(require 'tex-mik) |
or
(require 'tex-fptex) |
in order to get more appropriate values for MiKTeX and fpTeX, respectively.
You can always use
M-x customize-group RET AUCTeX RET |
in order to customize more stuff, or use the `Customize' menu.
If this barfs and tells you that image type `png' is not supported, try adding the line
(setq preview-image-type 'pnm) |
at the end of your installed version of `preview-latex.el'. If this helps, complain to wherever you got your Emacs from: all current Emacs/XEmacs versions capable of running preview-latex by now can be compiled to support PNG images. Which is important, because PNM files take away vast amounts of disk space, and thus also of load/save time.
Well, that about is all. Have fun!
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] |
This document was generated on August, 12 2007 using texi2html 1.76.