CVSROOT: /cvsroot/auctex Module name: auctex Changes by: Ralf Angeli <angeli> 06/06/12 05:57:13
Index: README =================================================================== RCS file: /cvsroot/auctex/auctex/preview/latex/README,v retrieving revision 1.11 retrieving revision 1.12 diff -u -b -r1.11 -r1.12 --- README 8 Jun 2006 20:18:31 -0000 1.11 +++ README 12 Jun 2006 05:57:13 -0000 1.12 @@ -1,34 +1,45 @@ -The preview.sty style file: +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 AUCTeX tarballs there, with separate -README and INSTALL files. Versions under CTAN:support/preview-latex -are outdated. Starting with AUCTeX 11.81, preview-latex is -distributed as an integral part of AUCTeX, requiring no separate -download. The unbundled preview.dtx 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. +Purpose +------- -A flexible and convenient interface allows it to specify what commands -and constructs should be extracted. +The main purpose of the preview package is the extraction of selected +elements from a LaTeX source, like formulas or graphics, into separate +pages of a DVI file. A flexible and convenient interface allows it to +specify what commands and constructs should be extracted. This works +with DVI files postprocessed by either Dvips and Ghostscript or +dvipng, but it also works when you are using PDFTeX for generating PDF +files. + +Current uses of the package include the preview-latex package for +WYSIWYG functionality in the AUCTeX editing environment, generation of +previews in LyX, as part of the operation of the ps4pdf and pst-pdf +packages, the tbook XML system and some other tools. + +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. + +Availability +------------ + +The preview package is being developed along and distributed with +AUCTeX. It can therefore be obtained as part of AUCTeX distribution +files available at <URL:ftp://ftp.gnu.org/pub/gnu/auctex/> or its +mirror at <CTAN:support/auctex>. CTAN also provides a standalone +version at <CTAN:macros/latex/contrib/preview>. The project page at +<URL:http://savannah.gnu.org/projects/auctex/> offers downloads and +anonymous CVS access for cutting edge versions. For more information +about the preview package please refer to the home page of AUCTeX at +<URL:http://www.gnu.org/software/auctex/>. -To install the preview style file on its own without fetching the -entire preview-latex package, run +Installation +------------ + +To install the preview style file on its own without the entire AUCTeX +package, run tex preview.ins If preview.ins happens to be missing, you can regenerate it by running tex docstrip @@ -44,7 +55,12 @@ documentation and have fun. The license of the original file is the GPL which you'll find a copy -of in the complete AUCTeX distribution. +of in the complete AUCTeX distribution. The distribution will also +unpack and install the respective LaTeX files with an +autoconf-supported mechanism, so you might consider using that. + +Bug reporting +------------- Please report problems to <URL:mailto:[email protected]>, including a small example file which uses the \listfiles statement, and the _______________________________________________ auctex-diffs mailing list [EMAIL PROTECTED] http://lists.gnu.org/mailman/listinfo/auctex-diffs
