summaryrefslogtreecommitdiff
path: root/support/latexmk/README
blob: 1fa9affc15faa2f68c68ff1227fcb63f2b2748b2 (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
62
63
Latexmk, version 4.78, 18 Nov 2022
----------------------------------

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, including repeated running
of the programs until cross references etc are resolved.  Latexmk 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 the LaTeX .fls,
.log, and .aux files.  It features: a fully reliable algorithm for deciding
how many times to run latex and related programs, automatic detection of
dependent files, the ability to generate pdf files using pdflatex or via
dvi or postscript files, and the continuous-preview mode.  For
bibliographies, the current version supports biber as well as the
traditional bibtex.  Which of bibtex or biber to use is determined
automatically. 

Please read the man page (or the corresponding text or pdf file) for
details of what latexmk does and what all the features are.  A list of
available command-line options is available by running 'latexmk --help'.

Latexmk is a perl script.  It is licensed under the GNU General Public
License v. 2.

It 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.personal.psu.edu/jcc8/
            username jcc8 at node psu.edu

The start of the script file has copyright notices and disclaimers.  

NOTES:-

1) See the INSTALL file for installation instructions

2) The main portability/non-portability issues: The various commands to
   process LaTeX files may often need to be changed for particular
   installations.  See the INSTALL file and the documentation for
   information on customization.

3) Availability:

   a. In the TeXLive and MiKTeX distributions.

   b. On the CTAN tex archive --- see http://www.ctan.org/pkg/latexmk

   c. From the author's site at http://www.personal.psu.edu/jcc8/latexmk/
   This site also includes previous versions, and sometimes newer versions
   under development.

John Collins