summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/preview/README
blob: 54eda0d17a1e5cccbf1bea090ce31624ed68d53d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
The preview.sty style file:

This style file is part of the AUCTeX project with home page
<URL:http://www.gnu.org/software/auctex>.  The project page at
<URL:http://savannah.gnu.org/projects/auctex> offers downloads and
anonymous CVS access for cutting edge versions.  It is part of
AUCTeX's preview-latex module: since AUCTeX's download area at
<URL:ftp://ftp.gnu.org/pub/gnu/auctex> is mirrored at
CTAN:support/auctex, you can find preview-latex tarballs there, with
separate README and INSTALL files.  Older versions can be found at
CTAN:support/preview-latex.  Starting with AUCTeX 11.81, preview-latex
will also be distributed as an integral part of AUCTeX, requiring no
separate download.  The unbundled preview.sty can be downloaded from
CTAN:macros/latex/contrib/preview if required.

While the primary focus of the package has been the support of editing
in Emacs buffers augmented with preview images, its possible uses are
not limited to that.  The package extracts indicated pieces from a
source file (typically displayed equations, figures and graphics) and
typesets with their base point at the (1in,1in) magic location,
shipping out the individual pieces on separate pages without any page
markup.  You can produce either DVI or PDF files, and options exist
that will set the page size separately for each page.  In that manner,
further processing (as with Ghostscript or dvipng) will be able to
work in a single pass.

A flexible and convenient interface allows it to specify what commands
and constructs should be extracted.

Note: as opposed to previous versions, the \nofiles command is no
longer called automatically except in AUCTeX mode.  If you are working
on original files and don't want to clobber the auxiliary files,
you'll need to call \nofiles yourself.

To install the preview style file on its own without fetching the
entire preview-latex package, run
tex preview.ins
If preview.ins happens to be missing, you can regenerate it by running
tex docstrip
on preview.dtx with the option `installer'.

Running TeX on preview.ins will then extract further files:
preview.drv which you can run through LaTeX in order to get the
documentation for preview.sty, preview.sty itself, a bunch of option
files with extension .def and a few configuration files with extension
.cfg.  In case your docstrip configuration has not already taken care
of that, install the files with extension .sty, .def and .cfg to a
location where LaTeX will be able to find them, generate the
documentation and have fun.

The license of the original file is the GPL which you'll find a copy
of in the complete preview-latex distribution.  The complete
preview-latex distribution will also unpack and install the respective
LaTeX files with an autoconf-supported mechanism, so you might
consider using that.

Please report problems to <URL:mailto:bug-auctex@gnu.org>, including a
small example file which uses the \listfiles statement, and the
resulting log file.

David Kastrup