Hi, and thanks for checking out latexmk. (Version 3.04, 24 November 2001) Latexmk completely automates the process of generating a LaTeX document. Essentially, it is a highly specialized cousin of the general make utility. Given the source files for a document, latexmk issues the appropriate sequence of commands to generate a .dvi, .ps, .pdf or hardcopy version of the document. It can also be set to run continuously with a previewer; the latex program, etc, are rerun whenever one of the source files is modified. Latexmk automatically determines file dependencies from either the LaTeX .log file or the source .tex file. Compared with previous versions, the current version features: a fully reliable algorithm for deciding how many times to run latex, greatly improved automatic detection of dependent files, the ability to generate pdf files using pdflatex, and a continuous preview mode that actually works. Please read the man page (or the corresponding text or postscript file) for a run down on what latexmk does and what all the features are. A copy of the fast help that can be seen by doing "latexmk -h" is at the end of this file. The latexmk perl script was modified by Evan McLean from the original script called "go" written by David J. Musliner. Now it is supported by John Collins Physics Department Penn State University 104 Davey Lab, Box 208 University Park PA 16802 U.S.A. http://www.phys.psu.edu/~collins/ collins@phys.psu.edu The start of the script file has copyright notices and disclaimers. It also has a modification history for those who are interested. NOTES:- 1) See the INSTALL file for installation instructions 2) Portability under various UNIX-type systems (including Linux): A special hack is used at the beginning of the latexmk script to ensure that it correctly runs without the need to adjust a #! line. All that is necessary is that the script has execute permission. 3) Portability under non-UNIX systems: Under other operating systems some other arrangement needs to be made to run the file. For example under MS-Windows, the supplied batch file latexmk.bat will do this. You may also find it necessary to convert files to the correct local format for text files. As downloaded, the files are in UNIX format (line-ending is '\n'). On MS-Windows systems, the conversion to MSDOS format (with line-ending '\r\n') is normally UNnecessary, since much current software handles the UNIX format correctly. (The known software for which this statement applies includes MikTeX, fpTeX, emacs.) 4) Portability: The various commands to process LaTeX files made need to be changed for particular installations. See the INSTALL file and the documentation for information on customization. 5) Portability: Users of different UNIX-like systems may have to change the "$pscmd" variable in their RC file if the -pvc option is to work perfectly. Refer to $pscmd in the man page. 6) Latexmk can be downloaded from the author's site at http://www.phys.psu.edu/~collins/software/latexmk/ 7) Latexmk is planned to be archived on the CTAN tex archive --- http://www.tug.org/ctan.html. When archived, it will be found in /tex-archive/support/latexmk on the following hosts (as well as on many other mirror sites): ftp://ftp.dante.de, ftp://ftp.tex.ac.uk, ftp://ctan.tug.org. I hope you find this useful. John Collins collins@phys.psu.edu ---------------------------- "latexmk -h" ---------------------------- Latexmk 3.04: Automatic LaTeX document generation routine Usage: latexmk [latexmk_options] [filename ...] Latexmk_options: -bm - Print message across the page when converting to postscript -bi - Set contrast or intensity of banner -bs - Set scale for banner --commands - list commands used by latexmk for processing files -c - clean up (remove) all nonessential files, except dvi, ps and pdf files -C - clean up (remove) all nonessential files including aux, dep, dvi, postscript and pdf files -c1 - clean up (remove) all nonessential files, including dvi, pdf and ps files, but excluding aux and dep files -d - Print `DRAFT' across the page when converting to postscript -dF - Filter to apply to dvi file -dvi - generate dvi -dvi- - turn off required dvi -f - force continued processing past errors -F - Ignore non-existent files when making dependencies -g - process regardless of file timestamps -h - print help --help - print help -i - rescan for includes if dependency file older than tex file -il - make list of included files by parsing log file -it - make list of included files by parsing tex file -I - force rescan for includes -l - force landscape mode -pdf - generate pdf -pdf- - turn off required pdf -ps - generate postscript -ps- - turn off required postscript -pF - Filter to apply to postscript file -p - print document after generating postscript -pv - preview document -pvc - preview document and continuously update -r - Read custom RC file --silent - silence progress messages from called programs -v - display program version --verbose - display usual progress messages from called programs --version - display program version --view=default - viewer is default (dvi, ps, pdf) --view=dvi - viewer is for dvi --view=ps - viewer is for ps --view=pdf - viewer is for pdf filename = the root filename of LaTeX document -p, -pv and -pvc are mutually exclusive -h, -c and -C overides all other options. -pv and -pvc require one and only one filename specified Contents of RC file specified by -r overrides options specified before the -r option on the command line