Does your neck hurt from turning between previewer windows and the
source too often? This Elisp/LaTeX package will render your displayed
LaTeX equations right into the editing window where they belong.

   The purpose of preview-latex is to embed LaTeX environments such as
display math or figures into the source buffers.  By mouse-clicking, you
can open the original text.  After editing, another click will just run
the region in question through LaTeX and redisplay the new results.

   For installation instructions, see the `INSTALL' file (*Note
Installation::).  The LaTeX style used is documented in `preview.dvi'
as produced by the installation process.

Prerequisites
=============

   Most importantly, you need to get access to a version of Emacs 21.
The public release 21.1 is known to work.  Pretest versions before that
have problems.  You also need LaTeX, of course, but most installs that
includes dvips should work.  A fairly recent AUC TeX is also needed.
You also need a recent Ghostscript, and this is the most common source
of problems.  Version 6.51 is known to work well, whereas earlier
versions have problems.

   *Please note:* At the current point of time, the port to XEmacs is
progressing, but neither finished nor documented yet.  With the Emacs
port, a lot of work had to be invested for the final polish, making
things work smooth and naturally.  The same is to be expected for
XEmacs.  If you are interested in contributing to this or any other
area, please contact the developers' list mentioned below.

   For some known issues with various software, see the file `PROBLEMS'
(*Note Known problems::).

Availability
============

   The preview-latex project is available at Sourceforge.  In addition
to the main source tarball, we provide prebuilt documentation files
there for those lacking a recent enough version of makeinfo, and source
and binary `.rpm' files suitable for a recent RedHat system.  See
`http://sourceforge.net/projects/preview-latex'.

   Anonymous CVS is available as well.  See the Sourceforge web pages
for more information, but here are the basic instructions (when
prompted for a password for anonymous, simply press the <RET> key).

     cvs -d:pserver:anonymous@cvs.preview-latex.sourceforge.net:/cvsroot/preview-latex login
     cvs -z3 -d:pserver:anonymous@cvs.preview-latex.sourceforge.net:/cvsroot/preview-latex co preview

   Updates from within the preview directory do not need the `-d'
parameter.  A simple `cvs update' from within that directory will make
your CVS mirror up to date again.  For developer access, ask on
<preview-latex-devel@lists.sourceforge.net> (see below).

Contacts
========

   Bug reports should be sent by using `M-x preview-report-bug <RET>',
as this will fill in a lot of information interesting to us.  There is
a mailing list for developers, look at
`http://lists.sourceforge.net/lists/listinfo/preview-latex-devel'.  For
more information, send a message with just the word `help' as subject
or body to <preview-latex-devel-request@lists.sourceforge.net>.
Suggestions for new features, and pleas for help should go to
<preview-latex-devel@lists.sourceforge.net> (the preview-latex devel
team).  Please use the command `M-x preview-report-bug <RET>' to report
bugs if possible.

Offers to support further development will be appreciated.

David Kastrup, <dakas@users.sourceforge.net>

