diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/preview/README')
-rw-r--r-- | Master/texmf-dist/doc/latex/preview/README | 61 |
1 files changed, 61 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/preview/README b/Master/texmf-dist/doc/latex/preview/README new file mode 100644 index 00000000000..54eda0d17a1 --- /dev/null +++ b/Master/texmf-dist/doc/latex/preview/README @@ -0,0 +1,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 |