LATEXMK(1L) 
LATEXMK(1L)
NAME
latexmk − generate LaTeX document
SYNOPSIS
latexmk [options] [file ...]
DESCRIPTION
Latexmkcompletely automates the process of compiling a LaTeX document. . Essentially,itislikeaspe-
cialized relative of the generalmakeutility, but one which determines dependencies automatically and has
some other very useful features. In its basic mode of operationlatexmk is given the name of the primary
source file for a document, and it issues the appropriate sequence of commands to generate a .dvi, .ps, .pdf
and/or hardcopyversion of the document.
By defaultlatexmk will run the commands necessary to generate a .dvi file.
Latexmkcan also be set to run continuously with a suitable previewer. . Inthat case the latexprogram (or
one of its relatives), etc, are rerun whenever one of the source files is modified, and the pre viewer automati-
cally updates the on-screen view ofthe compiled document.
Latexmkdetermines which are the source files by examining the log file.
(Optionally, it also examines the
list of input and output files generated by the -recorder option of modern versions oflatex (andpdflatex ,
xelatex, lualatex,etc). Seethe documentation for the-recorderoption oflatexmkbelow.) Whenlatexmkis
run, it examines properties of the source files, and if an yhav ebeen changed since the last document genera-
tion,latexmk will run the various LaTeX processing programs as necessary. In particular, it will repeat the
run oflatex (or a related program)) often enough to resolve all cross references; depending on the macro
packages used. With some macro packages and document classes, four, or even more, runs may be needed.
If necessary,latexmk will also runbibtex,biber, and/ormakeindex. In addition,latexmk can be configured
to generate other necessary files. For example, from an updated figure file it can automatically generate a
file in encapsulated postscript or another suitable format for reading by LaTeX.
Latexmkhas twodifferent previewing options. . In the simple-pvoption, a dvi, postscript or pdf previewer
is automatically run after generating the dvi, postscript or pdf version of the document. The type of file to
view isselected according to configuration settings and command line options.
The second previewing option is the powerful-pvc option (mnemonic: "preview continuously").  In this
case,latexmk runs continuously, regularly monitoring all the source files to see if an yhav e changed.  Every
time a change is detected,latexmk runs all the programs necessary to generate a new version of the docu-
ment.  A good previewer (likegv) will then automatically update its display. Thus the user can simply edit
afi le and, when the changes are written to disk,latexmk completely automates the cycle of updating the
.dvi (and possibly the .ps and .pdf) file, and refreshing the pre viewer's display. It's not quite WYSIWYG,
butusefully close.
For other previewers, the user may have to manually make the previewer update its display, which can be
(some versions ofxdviandgsview) assimple as forcing a redraw ofits display.
Latexmkhas the ability to print a banner in gray diagonally across each page when making the postscript
file.  It can also, if needed, call an external program to do other postprocessing on generated dvi and
postscript files. (See the options -dF and-pF , and the documentation for the$dvi_filter and$ps_filter con-
figuration v ariables.) These capabilities are leftover from older versions oflatexmk. More flexibility can be
obtained in current versions, since the command strings for running latex, pdflatex, etc can no w be config-
ured to run multiple commands. This also extends the possibility of postprocessing generated files to pdf
files.  files.
Latexmk is highly configurable, both from the command line and in configuration files, so that it can
accommodate a wide variety of user needs and system configurations. Default values are set according to
the operating system,  so latexmk often  works without special configuration on MS-W indows,  cygwin,
Linux, OS-X, and other UNIX systems (notably Solaris).
Avery annoying complication handled very reliably bylatexmk, is that LaTeX is a multiple pass system.
On each run, LaTeX reads in information generated on a previous run, for things likecross referencing and
indexing.  In the simplest cases, a second run of LaTeX suffices, and often the log file contains a message
24 February 2016
1
Convert pdf into html file - Library application class:C# PDF Convert to HTML SDK: Convert PDF to html files in C#.net, ASP.NET MVC, WinForms, WPF application
How to Convert PDF to HTML Webpage with C# PDF Conversion SDK
www.rasteredge.com
Convert pdf into html file - Library application class:VB.NET PDF Convert to HTML SDK: Convert PDF to html files in vb.net, ASP.NET MVC, WinForms, WPF application
PDF to HTML Webpage Converter SDK for VB.NET PDF to HTML Conversion
www.rasteredge.com
LATEXMK(1L) 
LATEXMK(1L)
about the need for another pass. However, there is a wide variety of add-on macro packages to LaTeX, with
avariety of behaviors.  The result is to break simple-minded determinations of how many runs are needed
and of which programs. In its new version, latexmk has a highly general and efficient solution to these
issues.  The solution involves retaining between runs information on the source files, and a symptom is that
latexmkgenerates an extra file (with e e xtension .fdb_latexmk,bydefault) that contains the source file infor r -
mation.
LATEXMK OPTIONS AND ARGUMENTS ON COMMAND LINE
In general the command line to invokelatexmk has the form
latexmk [options] [file]
All options can be introduced by single or double "-" characters, e.g., "latexmk -help" or "latexmk --help".
Note 1: In addition to the options in the list below,latexmkrecognizes almost all the options recognized
by thelatex,pdflatex programs (and their relatives) in their current TeXLive and MiKTeX implementations.
Some of the options for these programs also trigger special action or behavior bylatexmk, in which case
they hav e specific e xplanations in this document. Otherwise, theyare just passed through to a calledlatex
orpdflatex program. Runlatexmk with the-showextraoptions to get a list of the options that latexmk
accepts and that are simply passed through tolatex or pdflatex (etc).  See also the explanation of the
-showextraoptionsoption for more information.
Note 2:Inthis documentation, the programpdflatex is often referred to. . Users of programs likelualatex
andxelatex should know that fromlatexmk's point of view, these other programs behave likepdflatex , i.e.,
they make a pdf file from a te xfi le, etc. So wheneverpdflatex is mentioned without mention of the other
programs, the statements apply equally tolualatex,xelatex, and any other similar programs. Latexmkcan
be easily configured to use whiche ver of these programs is needed. See the documentation for the follow-
ing options:-pdflatex="COMMAND" ,-lualatex, and-xelatex, and also see the documentation for the
$pdflatex configuration v v ariable. Atpresentlatexmkcannot do automatic detection of which program is to
be used.
Definitions of options and arguments
file
One or more files can be specified.
If no files are specified, latexmk will, by default, run on all
files in the current w orking directory with a ".tex" extension.  This behavior can be changed: see
the description concerning the@default_files  variable in the section "List of configuration v ari-
ables usable in initialization files".
If a file is specified without an e xtension, then the ".tex" extension is automatically added, just as LaTeX
does. Thus, if you specify:
latexmk foo
thenlatexmk will operate on the file "foo.tex".
-auxdir=FOO or -aux-directory=FOO
Sets the directory for auxiliary output files of (pdf)late x(.aux, .log etc). This achieves its effect by
the-aux-directory option of (pdf)latex, which currently is only implemented on the MiKTeX ver-
sion of (pdf)latex.
See  also  the -outdir/-output-directory options,  and  the $aux_dir$out_dir, and
$search_path_separatorconfiguration v v ariables oflatexmk. Inparticular,see the documentation
24 February 2016
2
Library application class:C# PDF File Split Library: Split, seperate PDF into multiple files
C#.NET control for splitting PDF file into two or multiple files online. Support to break a large PDF file into smaller files. Divide PDF File into Two Using C#.
www.rasteredge.com
Library application class:VB.NET PDF File Split Library: Split, seperate PDF into multiple
Split PDF file into two or multiple files in ASP.NET webpage online. Support to break a large PDF file into smaller files in .NET WinForms.
www.rasteredge.com
LATEXMK(1L) 
LATEXMK(1L)
of$out_dirfor some complications on what directory names are suitable.
-bibtex When the source file uses bbl files for bibliograph h y, run bibtexorbiber as needed to regenerate the
bbl files.
This property can also be configured by setting the $bibtex_usevariable to 2 in a configuration file
-bibtex-
Neverrun bibtexorbiber.
Acommon use for this option is when a document comes from an external source, complete with
its bbl file(s), and the user does not ha ve the corresponding bib files a vailable. Inthis situation use
of the-bibtex- option will preventlatexmk from trying to runbibtexorbiber, which would result
in overwriting of the bbl files.
-bibtex-cond
When the source file uses bbl file(s) for the bibliograph y, runbibtexorbiberas needed to regener-
ate the bbl files, but only if the rele vant bib file(s) e xist.  Thus when the bib files are not a vailable,
bibtexorbiberis not run, thereby avoiding overwriting of the bbl file(s). . This is the default set-
ting.
(Note that it is possible forlatexmk to decide that the bib file does not e xist, even though the bib
file does exist and bibtexorbiberfinds it. The problem is that the bib file may not be in the cur -
rent directory but in some search path; the placeslatexmk andbibtexorbibercause to be searched
need not be identical. On modern installations of TeX and related programs this problem should
not arise, sincelatexmk uses thekpsewhich program to do the search, andkpsewhich should use
the same search path as bibtex andbiber. If this problem arises, use the-bibtex option when
invokinglatexmk.)
-bm <message>
Abanner message to print diagonally across each page when converting the dvi file to postscript.
The message must be a single argument on the command line so be careful with quoting spaces
and such.
Note that if the-bm option is specified, the -ps option is assumed.
-bi <intensity>
How dark to print the banner message. A decimal number between 0 and 1. 0 is black and 1 is
white.  The default is 0.95, which is OK unless your toner cartridge is getting low.
-bs <scale>
Adecimal number that specifies ho w large the banner message will be printed. Experimentation is
necessary to get the right scale for your message, as a rule of thumb the scale should be about
equal to 1100 divided by the number of characters in the message. The default is 220.0 which is
just right for 5 character messages.
-commands
List the commands used bylatexmk for processing files, and then exit.
-c
Clean  up (remove) all regeneratable files  generated by latex and bibtex or biber except  dvi,
postscript and pdf. These files are a combination of log files, aux files,
latexmk's database file of
source file information, and those with e xtensions specified in the @generated_extsconfiguration
variable.  Inaddition, files specified by the
$clean_extconfiguration variable are remo o ved.
This cleanup is instead of a regular make.  See the-gg option if you want to do a cleanup then a
make.
24 February 2016
3
Library application class:C# PDF File Merge Library: Merge, append PDF files in C#.net, ASP.
This part illustrates how to combine three PDF files into a new file in C# application. srcStreams, Source PDF streams to be used to combine into one PDF file.
www.rasteredge.com
Library application class:VB.NET PDF File Merge Library: Merge, append PDF files in vb.net
Combine multiple specified PDF pages in into single one file. This part illustrates how to combine three PDF files into a new file in VB.NET application.
www.rasteredge.com
LATEXMK(1L) 
LATEXMK(1L)
If$bibtex_useis set to 0 or 1, bbl files are counted as non-regeneratable.
If$cleanup_includes_cusdep_generatedis nonzero, regeneratable files are considered as including
those  generated  by  custom  dependencies and  are  also  deleted. Otherwise  these files  are  not
deleted.
-C
Clean up (remove) all regeneratable files generated by latex andbibtexorbiber. This is the same
as the -c option  with the addition of dvi,  postscript and pdf files, and those specified in the
$clean_full_extconfiguration variable.
This cleanup is instead of a regular make.  See the-gg option if you want to do a cleanup than a
make.
If$bibtex_useis set to 0 or 1, bbl files are counted as non-regeneratable.
If$cleanup_includes_cusdep_generatedis nonzero, regeneratable files are considered as including
those  generated  by  custom  dependencies and  are  also  deleted. Otherwise  these files  are  not
deleted.
-CA
(Obsolete). Now equivalent to the-C option. Seethat option for details.
-cd
Change to the directory containing the main source file before processing it. Then all the gener -
ated files (aux, log, dvi, pdf, etc) will be relati ve tothe source file.
This option is  particularly useful when latexmk is invoked from a  GUI  configured  to in voke
latexmkwith a full pathname for the source file.
-cd-
Do NOT change to the directory containing the main source file before processing it. Then all the
generated files (aux, log, dvi, pdf, etc) will be relati ve to the current directory rather than the
source file.
This is the default behavior and corresponds to the behavior of thelatex andpdflatex programs.
However, it is not desirable behavior whenlatexmk is invoked by a GUI configured to in voke
latexmkwith a full pathname for the source file. . See the -cdoption.
-CF
Remove the file containing the database of source file information, before doing the other actions
requested.
-d
Set draft mode. This prints the banner message "DRAFT" across your page when converting the
dvi file to postscript. Size and intensity can be modified with the -bs and-bi options.  The-bm
option will override this option as this is really just a short way of specifying:
latexmk -bm DRAFT
Note that if the-d option is specified, the -ps option is assumed.
-deps Showalist of dependent files after processing. . This is in the form of a dependencylist of the form
used by themakeprogram, and it is therefore suitable for use in a Makefile.  It gives an overall
view ofthe files without listing intermediate files, as well as latexmk can determine them.
By default the list of dependent files is sent to stdout (i.e., normally to the screen unless you' ve
redirectedlatexmk's output). But you can set the filename where the list is sent by the -deps-out=
option.
See the section "USINGlatexmk WITHmake" for an example of how to use a dependency list
withmake.
Users familiar with GNUautomake andgcc will find that the -deps option is very similar in its
purpose and results to the-M option togcc. (In fact,latexmk also has options-M ,-MF , and-MP
24 February 2016
4
Library application class:C# PDF insert text Library: insert text into PDF content in C#.net
If you want to add a text string to PDF file, please try this C# demo. // Open a document. value, The char wil be added into PDF page, 0
www.rasteredge.com
Library application class:C# PDF Convert to Tiff SDK: Convert PDF to tiff images in C#.net
with specified zoom value and save it into stream The magnification of the original PDF page size Description: Convert to DOCX/TIFF with specified resolution and
www.rasteredge.com
LATEXMK(1L) 
LATEXMK(1L)
options that behave likethose ofgcc.)
-dependents
Equivalent to-deps.
-deps- Do not showalist of dependent files after processing. . (This is the default.)
-dependents-
Equivalent to-deps-.
-deps-out=FILENAME
Set the filename to which the list of dependent files is written. If the FILENAME argument is
omitted or set to "-", then the output is sent to stdout.
Use of this option also turns on the output of the list of dependent files after processing.
-dF
Dvi file filtering. The argument to this option is a filter which will generate a filtered dvi file with
the extension ".dviF". All extra processing (e.g. conversion to postscript, preview, printing) will
then be performed on this filtered dvi file.
Example usage: Touse dviselect to select only the evenpages of the dvi file:
latexmk -dF "dviselect even" foo.tex
-diagnostics
Print detailed diagnostics during a run. This may help for debugging problems or to understand
latexmk's behavior in difficult situations.
-dvi
Generate dvi version of document.
-dvi-
Turn off generation of dvi version of document. (This may get overridden, if some other file is
made (e.g., a .ps file) that is generated from the dvi file, or if no generated file at all is requested.)
-e <code>
Execute the specified initialization code before processing. The code is Perlcode of the same
form as is used inlatexmk's initialization files -- for more details, see the information on the -r
option, and the section about "Configuration/initialization (RC) files".
The code is typically a
sequence of assignment statements separated by semicolons.
The code is executed when the-e option is encountered duringlatexmk's parsing of its command
line.  See the-r option for a way of executing initialization code from a file. An error results in
latexmkstopping. Multipleinstances of the-rand-eoptions can be used, and theyare executed in
the order theyappear on the command line.
Some care is needed to deal with proper quoting of special characters in the code on the command
line.  For example, suppose you want to set the latexcommand to use its -shell-escape option, then
under UNIX/LINUX you could use the line
latexmk -e '$latex=q/latex%O -shell-escape %S/' file.tex
Note that the single quotes block normal UNIX/LINUX command shells from treating the charac-
ters inside the quotes as special. (In this example, the q/.../ construct is aPerlidiom equivalent to
using single quotes. This avoids the complications of getting a quote character inside an already
quoted string in a way that is independent of both the shell and the operating-system.)
The above command line will NOT work under MS-Windows with cmd.exe or command.com or
4nt.exe. For MS-Windows with these command shells you could use
latexmk -e "$latex=q/latex%O -shell-escape %S/" file.tex
24 February 2016
5
Library application class:C# PDF Convert to Word SDK: Convert PDF to Word library in C#.net
with specified zoom value and save it into stream The magnification of the original PDF page size Description: Convert to DOCX/TIFF with specified resolution and
www.rasteredge.com
Library application class:VB.NET PDF Page Insert Library: insert pages into PDF file in vb.
of PDF page adding in C# class, we suggest you go to C# Imaging - how to insert a new empty page to PDF file. DLLs for Adding Page into PDF Document in VB.NET
www.rasteredge.com
LATEXMK(1L) 
LATEXMK(1L)
or
latexmk -e "$latex='latex%O -shell-escape %S'" file.tex
The last twoexamples will NOT work with UNIX/LINUX command shells.
-f
Forcelatexmk to continue document processing despite errors. Normally, whenlatexmk detects
that LaTeX or another program has found an error which will not be resolved by further process-
ing, no further processing is carried out.
Note: "Further processing" means the running of other programs or the rerunning oflatex (etc) that
would be done if no errors had occurred. If instead, or additionally, you want thelatex (etc) pro-
gram not to pause for user input after an error, you should arrange this by an option that is passed
to the program, e.g., bylatexmk's option-interaction=nonstopmode.
-f-
Turn off the forced processing-past-errors such as is set by the-f option.  This could be used to
override a setting in a configuration file.
-g
Force latexmk to process document fully, even under situations where latexmk would normally
decide that no changes in the source files ha ve occurred since the previous run. This option is use-
ful, for example, if you change some options and wish to reprocess the files.
-g-
Turn off-g.
-gg
"Super go mode" or "clean make": clean out generated files as if -C had been given, and then do a
regular make.
-h, -help
Print help information.
-jobname=STRING
Set the basename of output files(s) to STRING, instead of the def ault, which is the basename of
the specified TeX file.
This is like the same option for current implementations of thelatex,pdflatex , etc, and the passing
of this option to these programs is part oflatexmk's implementation of-jobname.
-l
Run in landscape mode, using the landscape mode for the previewers and the dvi to postscript con-
verters.  This option is not normally needed nowadays, since current previewers normally deter-
mine this information automatically.
-l-
Turn off-l.
-latex="COMMAND"
This sets the string specifying the command to run latex, and is typically used to add desired
options. Sincethe string normally contains spaces, it should be quoted, e.g.,
latexmk -latex="latex--shell-escape %O %S" foo.tex
The specification of the contents of the string are the same as for the $latexconfiguration v ariable.
Depending on your operating system and the command-line shell you are using, you may need to
change the single quotes to double quotes (or something else).
To set the command for running pdflate x (rather than the command for latex) see the-pdflatex
option.
Note that the effect of this option can also be achievedbyusing the-e option with a suitable line of
Perl code to set the$latexvariable.  See the explanation of the-e option.
24 February 2016
6
LATEXMK(1L) 
LATEXMK(1L)
-lualatex
Use lualatex.  That is, use lualatexto process the source file(s) to pdf (in place of pdflate x).  This
option is exactly equivalent to specifying the following sequence of options:
-pdflatex="lualate x%O %S" -pdf -dvi- -ps-
-M
Show list of dependent files after processing. This is equi valent to the-deps option.
-MF file
If a list of dependents is made, the-MF specifies the file to write it to.
-MP
If a list of dependents is made, includes phony target for each source file. If you use the depen-
dents list in a Makefile, the dummy rules work around errors mak e giv es if you remove header
files without updating the Makefile to match.
-new-viewer
When in continuous-preview mode, always start a new viewer to view the generated file. By
default,latexmk will, in continuous-preview mode, test for a previously running previewer for the
same file and not start a ne w one if a previous previewer is running. However, its test sometimes
fails (notably if there is an already-running previewer that is viewing a file of the same name as the
current file, but in a different directory). This option turns of fthe default behavior.
-new-viewer-
The inverse of the-new-viewer option.  Itputslatexmk in its normal behavior that in preview-con-
tinuous mode it checks for an already-running previewer.
-nobibtex
Neverrun bibtexorbiber.
Acommon use for this option is when a document comes from an external source, complete with
its bbl file(s), and the user does not ha ve the corresponding bib files a vailable. Inthis situation use
of the-nobibtex option will preventlatexmk from trying to runbibtexorbiber, which would result
in overwriting of the bbl files.
-norc
Turn off the automatic reading of initialization (rc) files.
N.B. Normally the initialization files are read and obe yed, and then command line options are
obeyed in the order theyare encountered. But-norc is an exception to this rule: it is acted on first,
no matter where it occurs on the command line.
-outdir=FOO or -output-directory=FOO
Sets the directory for the output files of (pdf)late x.  This achieves its effect by the-output-direc-
toryoption of (pdf)latex, which currently (Dec. 2011 and later) is implemented on the common
versions of (pdf)latex, i.e., MiKTeX and TeXLive. Itmay not be present in other versions.
See also the-auxdir/-aux-directory options, and the$aux_dir,$out_dir, and$search_path_sepa-
ratorconfiguration variables of latexmk. Inparticular,see the documentation of $out_dirfor some
complications on what directory names are suitable.
-p
Print out the document. By default the file to be printed is the first in the list postscript, pdf, dvi
that is being made. But you can use the-print=... option to change the type of file to be printed,
and you can configure this in a start up file (by setting the
$print_typevariable).
However, printing is enabled by default only under UNIX/LINUX systems, where the default is to
use the lpr command and only on postscript files. In general, the correct beha vior for printing very
24 February 2016
7
LATEXMK(1L) 
LATEXMK(1L)
much depends on your system's software.  In particular, under MS-Windows you must have suit-
able program(s) available, and you must have configured the print commands used by latexmk.
This can be non-trivial.  See the documentation on the$lpr,$lpr_dvi, and$lpr_pdfconfiguration
variables to see how toset the commands for printing.
This option is incompatible with the-pv and-pvc options, so it turns them off.
-pdf
Generate pdf version of document usingpdflatex . (If you wish to uselualatex orxelatex, you can
use whichever of the options-lualatex or-xelatex applies.)  To configure latexmk to have such
behavior by default, see the section on "Configuration/initialization (rc) files".
-pdfdvi
Generate pdf version of document from the dvi file, by default using dvipdf.
-pdfps Generate pdf version of document from the ps file, by default using ps2pdf.
-pdf-
Turn off generation of pdf version of document. (This can be used to override a setting in a con-
figuration file. It may get o verridden if some other option requires the generation of a pdf file.)
-pdflatex="COMMAND"
This sets the string specifying the command to run pdflatex, and is typically used to add desired
options. Sincethe string normally contains spaces, it should be quoted, e.g.,
latexmk -pdf -pdflatex="pdflate x--shell-escape %O %S" foo.tex
The specification of the contents of the string are the same as for the $pdflatex configuration v ari-
able.  Depending on your operating system and the command-line shell you are using, you may
need to change the single quotes to double quotes (or something else).
This option can also be used to set a program to be used instead of the standardpdflatex program,
e.g.,
latexmk -pdf -pdflatex="lualate x%O %S"  foo.tex
to uselualatex or
latexmk -pdf -pdflatex="xelate x%O %S"  foo.tex
to usexelatex.
To set the command for runninglatex (rather than the command forpdflatex ) see the-latex option.
Note that the effect of this option can also be achievedbyusing the-e option with a suitable line of
Perl code to set the$pdflatex variable. See the explanation of the-e option.
-print=dvi, -print=ps, -print=pdf,-print=auto,
Define which kind of file is printed. This option also ensures that the requisite file is made, and
turns on printing.
The (default) case-print=auto determines the kind of print file automatically from the set of files
that is being made. The first in the list postscript, pdf, dvi that is among the files to be made is the
one used for print out.
-ps
Generate postscript version of document.
-ps-
Turn off generation of postscript version of document. This can be used to override a setting in a
configuration file. (It may get o verridden by some other option that requires a postscript file, for
24 February 2016
8
LATEXMK(1L) 
LATEXMK(1L)
example a request for printing.)
-pF
Postscript file  filtering. The argument to this option is a filter which  will  generate a filtered
postscript file with the e xtension ".psF". All extra processing (e.g. preview, printing) will then be
performed on this filtered postscript file.
Example of usage: Use psnup to print twopages on the one page:
latexmk -ps -pF 'psnup -2' foo.tex
or
latexmk -ps -pF "psnup -2" foo.tex
Whether to use single or double quotes round the "psnup -2" will depend on your command inter-
preter,as used by the particular version of perl and the operating system on your computer.
-pv
Run file pre viewer. If the-view option is used, this will select the kind of file to be pre viewed
(dvi, ps or pdf). Otherwise the viewer views the "highest" kind of file selected, by the -dvi,-ps,
-pdf, -pdfpsoptions, in the order dvi, ps, pdf (lowtohigh). Ifno file type has been selected, the
dvi previewer will be used. This option is incompatible with the-p and-pvc options, so it turns
them off.
-pv-
Turn off-pv.
-pvc
Run a file pre viewer and continually update the .dvi, .ps, and/or .pdf files whene ver changes are
made to source files (see the Description abo ve).  Which of these files is generated and which is
viewed is governed by the other options, and is the same as for the-pv option.  The preview-con-
tinuous option-pvc can only work with one file. So in this case you will normally only specify
one filename on the command line. It is also incompatible with the-p and-pv options, so it turns
these options off.
The-pvc option also turns off force mode (-f), as is normally best for continuous preview mode.
If you really want force mode, use the options in the order-pvc -f.
With a good previewer the display will be automatically updated. (Undersome but not all ver-
sions of UNIX/Linux "gv -watch" does this for postscript files; this can be set by a configuration
variable.  This would also work for pdf files except for an apparent bug in gv that causes an error
when the newly updated pdf file is read.) Man yother previewers will need a manual update.
Important note:the acroread program on MS-Windows locks the pdf file, and pre e vents newver-
sions being written, so it is a bad idea to use acroread to view pdf files in pre view-continuous
mode.  Itis better to use a different viewer: SumatraPDF and gsview are good possibilities.
There are some other methods for arranging an update, notably useful for many versions of xdvi
and xpdf. These are best set inlatexmk's configuration; see belo w.
Note that iflatexmk dies or is stopped by the user, the "forked" previewer will continue to run.
Successive inv ocations with the-pvc option will not fork new previewers, butlatexmk will nor-
mally use the existing previewer. (At least this will happen whenlatexmk is running under an
operating system where it knows howtodetermine whether an existing previewer is running.)
-pvc-
Turn off-pvc.
-quiet Same as -silent
-r <rcfile>
Read the specified initialization file ("RC file") before processing.
24 February 2016
9
LATEXMK(1L) 
LATEXMK(1L)
Be careful about the ordering: (1) Standard initialization files -- see the section belo w on"Configu-
ration/initialization (RC) files" -- are read first. (2) Then the options on the command line are
acted on in the order theyare given.  Thereforeif an initialization file is specified by the
-roption,
it is read during this second step. Thus an initialization file specified with the
-roption can over-
ride both the standard initialization files and previouslyspecified options. But all of these can be
overridden bylater options.
The contents of the RC file just comprise a piece of code in the Perlprogramming language (typi-
cally a sequence of assignment statements); they are executed when the-r option is encountered
duringlatexmk's parsing of its command line. See the-e option for a way of giving initialization
code directly onlatexmk's command line. An error results inlatexmk stopping.  Multipleinstances
of the-r and-e options can be used, and they are executed in the order they appear on the com-
mand line.
-recorder
Use the -recorder option withlatex andpdflatex . In (most) modern versions of these programs,
this results in a file of e xtension.fls containing a list of the files that these programs ha ve read and
written. Latexmkwill then use this file to impro ve its detection of source files and generated files
after a run oflatex orpdflatex .
For further information, see the documentation for the$recorderconfiguration variable.
-recorder-
Do not use the -recorder option withlatex andpdflatex .
-rules Showalist oflatemk's rules and dependencies after processing.
-rules- Do not showalist oflatexmk's rules and dependencies after processing. . (This is the default.)
-showextraoptions
Show the list of extralatex andpdflatex options thatlatexmk recognizes.  These are options for the
latexand pdflatex thatlatexmkrecognizes, but simply passes through to these programs when they
are run. These options are (currently) a combination of those allowed by the TeXLive and MiK-
TeX implementations.  (If aparticular option is given tolatexmk butis not handled by the particu-
lar implementation oflatex orpdflatex that is being used, that program will probably give anerror
message.)  These options are very numerous, but are not listed in this documentation because they
have noeffect onlatexmk's actions.
There are a few options (-includedirectory=dir-initialize,-ini) that are not recognized, either
because they don'tfit w ithlatexmk's intended operations, or because theyneed special processing
bylatexmk that isn'timplemented (at least, not yet).
There are also options that are accepted bylatex etc, but instead trigger actions bylatexmk:-help ,
-version.
Finally, there are certain options forlatex andpdflatex (e.g.,-recorder) that trigger special actions
or behavior bylatexmk itself as well as being passed in some form to the calledlatex andpdflatex
program, or that affect other programs as well. These options do have entries in this documenta-
tion.  These options  are: -jobname=STRING , -aux-directory=dir-output-directory=DIR ,
-quiet,and -recorder.
-logfilewarninglist
-logfilewarnings After a run of (pdf)latex, give a list of warnings about undefined citations and
references (unless silent mode is on).
See also the $silence_logfile_warnings configuration variable.
24 February 2016
10
Documents you may be interested
Documents you may be interested