diff --git a/.cvsignore b/.cvsignore index 5010110..81eb43d 100644 --- a/.cvsignore +++ b/.cvsignore @@ -1 +1 @@ -latexmk-308n.zip +latexmk-320.zip diff --git a/latexmk-README.fedora b/latexmk-README.fedora index 42fbf4c..d21b016 100644 --- a/latexmk-README.fedora +++ b/latexmk-README.fedora @@ -100,4 +100,3 @@ take some action of your own to see changes to the document. $pdf_previewer = 'start acroread'; $pdf_update_method = 1; - diff --git a/latexmk-conf.patch b/latexmk-conf.patch index b7f9861..8737a00 100644 --- a/latexmk-conf.patch +++ b/latexmk-conf.patch @@ -1,10 +1,10 @@ -diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 ---- latexmk-3.08n.ORIG/latexmk.1 2007-02-16 13:03:38.000000000 -0700 -+++ latexmk-3.08n/latexmk.1 2007-02-27 11:59:26.000000000 -0700 +diff -dur latexmk-3.20.ORIG/latexmk.1 latexmk-3.20/latexmk.1 +--- latexmk-3.20.ORIG/latexmk.1 2007-07-03 14:22:44.000000000 -0600 ++++ latexmk-3.20/latexmk.1 2007-08-31 21:44:15.000000000 -0600 @@ -1,9 +1,9 @@ --.TH LATEXMK 1L "16 February 2007" "" +-.TH LATEXMK 1L "3 July 2007" "" -.SH NAME -+.TH "LATEXMK" "1L" "16 February 2007" "" "" ++.TH "LATEXMK" "1L" "3 July 2007" "" "" +.SH "NAME" latexmk \- generate LaTeX document -.SH SYNOPSIS @@ -14,95 +14,80 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 +.SH "DESCRIPTION" .I LatexMk completely automates the process of compiling a LaTeX document. - Essentially, it is a highly specialized relative of the general -@@ -13,10 +13,10 @@ - to run continuously with a previewer; in that case the latex program, - etc, are rerun - whenever one of the source files is modified. + Essentially, it is like a specialized relative of the general +@@ -15,8 +15,8 @@ + document. It can also be set to run continuously with a suitable + previewer; in that case the LaTeX program, etc, are rerun whenever one + of the source files is modified, and the previewer updates the +-on-screen view of the compiled document. -.PP ++on\-screen view of the compiled document. +.PP - \fILatexmk\fR will normally determine which are the source files by - examining the log file. It has an option to parse the TeX file instead ----- see later. When \fIlatexmk\fR is run, it will examine the timestamps -+\-\-\- see later. When \fIlatexmk\fR is run, it will examine the timestamps - on the source files. - If any of the source files have been changed since the last document - generation, \fIlatexmk\fR will run the various LaTeX processing -@@ -27,39 +27,39 @@ - With some macro packages and document styles four, or even more, runs may - be needed. If necessary, \fIlatexmk\fR will also run bibtex and/or - makeindex. --.PP --[If the option \fB-it\fR to scan the LaTeX file is used, the main LaTeX -+.PP -+[If the option \fB\-it\fR to scan the LaTeX file is used, the main LaTeX - file and all input and included files (recursively) are scanned for - LaTeX commands - for inputting and including other TeX files and figure files. Then on - subsequent runs, --\fIlatexmk\fR with the \fB-it\fR switch reads the dependency -+\fIlatexmk\fR with the \fB\-it\fR switch reads the dependency - information from this file. If the dependencies of the document are - changed (e.g., by adding or removing an \\input command), an additional --pass of \fIlatexmk -i\fR or \fIlatexmk -I\fR will update the dependency -+pass of \fIlatexmk \-i\fR or \fIlatexmk \-I\fR will update the dependency - file.] + \fILatexmk\fR determines which are the source files by examining the + log file. When \fIlatexmk\fR is run, it examines properties of the + source files, and if any have been changed since the last document +@@ -30,14 +30,14 @@ + For example, from an updated figure file it can automatically generate + a file in encapsulated postscript or another suitable format for + reading by LaTeX. -.PP +.PP \fILatexmk\fR has two different previewing options. In the simple --\fB-pv\fR option, a dvi, postscript or pdf previewer is automatically run -+\fB\-pv\fR option, a dvi, postscript or pdf previewer is automatically run - after generating the dvi, postscript or pdf version of the document. The --type of viewer is selected automatically depending on the \fB-ps\fR, --\fB-pdf\fR or \fB-pdfps\fR options. The kind of file to be viewed can --also be explicitly selected by using the \fB-view\fR option --(\fB-view=ps\fR, etc). +-\fB-pv\fR option, a dvi, postscript or pdf previewer is automatically ++\fB\-pv\fR option, 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 is selected according to + configuration settings and command line options. -.PP -+type of viewer is selected automatically depending on the \fB\-ps\fR, -+\fB\-pdf\fR or \fB\-pdfps\fR options. The kind of file to be viewed can -+also be explicitly selected by using the \fB\-view\fR option -+(\fB\-view=ps\fR, etc). +-The second previewing option is the powerful \fB-pvc\fR option +.PP - The second previewing option is --the powerful \fB-pvc\fR option (mnemonic: "preview continuously"). -+the powerful \fB\-pvc\fR option (mnemonic: "preview continuously"). - Particularly when a document is reaching the final stages of editing, it - is often useful to have a previewer open continuously and have it update - its display whenever changes are made to the source file(s), and this --is done by the \fB-pvc\fR option. With this option, \fIlatexmk\fR -+is done by the \fB\-pvc\fR option. With this option, \fIlatexmk\fR - runs a previewer for the - document, and then \fIlatexmk\fR repeatedly monitors the source files of - the document to see if any changes have been made since the last dependent - file - was produced. When changes are detected, \fIlatexmk\fR runs the - appropriate LaTeX commands to regenerate the .dvi, .ps and/or .pdf files --(depending on the which of the \fB-ps\fR, \fB-pdf\fR and \fB-pdfps\fR -+(depending on the which of the \fB\-ps\fR, \fB\-pdf\fR and \fB\-pdfps\fR - options was specified). A good previewer (like - \fIgv\fR) will then automatically update its display. - Thus the user can simply edit a file and, when the -@@ -67,24 +67,24 @@ - cycle of updating the .dvi (and possibly the .ps and .pdf) file, - and refreshing the previewer's display. - It's not quite WYSIWYG, but usefully close. ++The second previewing option is the powerful \fB\-pvc\fR option + (mnemonic: "preview continuously"). In this case, \fIlatexmk\fR runs + continuously, regularly monitoring all the source files to see if any + have changed. Every time a change is detected, \fIlatexmk\fR runs all +@@ -47,31 +47,31 @@ + are written to disk, \fIlatexmk\fR completely automates the cycle of + updating the .dvi (and possibly the .ps and .pdf) file, and refreshing + the previewer's display. It's not quite WYSIWYG, but usefully close. -.PP +.PP - For other - previewers, the user will have to manually make the previewer update - its display, which can be (xdvi and gsview) as forcing a redraw of its - display. + For other previewers, the user may have to manually make the previewer + update its display, which can be (some versions of xdvi and gsview) as + simple as forcing a redraw of its display. -.PP +.PP - \fILatexmk\fR has 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 the generated - files. + \fILatexmk\fR has 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 the + generated files. -.PP +.PP \fILatexmk\fR 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. + user needs and system configurations. Default values are set + according to the operating system, so \fIlatexmk\fR often works +-without special configuration on MS-Windows, cygwin, Linux, OS-X, and ++without special configuration on MS\-Windows, cygwin, Linux, OS\-X, and + other UNIX systems (notably Solaris). +-.PP ++.PP + A very annoying complication handled very reliably by \fILatexmk\fR, + is that LaTeX is a multiple pass system. On each run, LaTeX reads in + information generated on a previous run, for things like cross + referencing and indexing. In the simplest cases, a second run of + LaTeX suffices, and often the log file contains a message about the +-need for another pass. However, there is a wide variety of add-on ++need for another pass. However, there is a wide variety of add\-on + macro packages to LaTeX, with a variety of behaviors. The result is +-to break simple-minded determinations of how many runs are needed and ++to break simple\-minded determinations of how many runs are needed and + of which programs. In its new version, \fIlatexmk\fR has a highly + general and efficient solution to these issues. The solution involves + retaining between runs information on the source files, and a symptom +@@ -79,10 +79,10 @@ + \fR.fdb_latexmk\fR, by default) that contains the source file + information. + -.SH LATEXMK OPTIONS AND ARGUMENTS -(All options can be introduced by single or double "-" characters, -e.g., "latexmk -help" or "latexmk --help".) @@ -114,7 +99,7 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 .B file One or more files can be specified. If no files are specified, \fIlatexmk\fR will, by default, run on all files in the current working directory -@@ -97,72 +97,72 @@ +@@ -95,79 +95,79 @@ latexmk foo then \fIlatexmk\fR will operate on the file "foo.tex". @@ -128,14 +113,13 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 -Note that if the \fB-bm\fR option is specified, the \fB-ps\fR option is +Note that if the \fB\-bm\fR option is specified, the \fB\-ps\fR option is - assumed and the postscript file is always generated, even if it is newer - than the dvi file. + assumed. -.TP -.B -bi +.TP +.B \-bi How dark to print the banner message. A decimal number between 0 and 1. - 0 is black and 1 is white, default is 0.95 which is OK unless your + 0 is black and 1 is white. The default is 0.95, which is OK unless your toner cartridge is getting low. -.TP -.B -bs @@ -144,7 +128,7 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 A decimal number that specifies how 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. Default is 220.0 + divided by the number of characters in the message. The default is 220.0 which is just right for 5 character messages. .TP -.B -commands @@ -154,36 +138,46 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 .TP -.B -c +.B \-c - Clean up (remove) all regenerateable files generated by \fIlatex\fR and - \fIbibtex\fR except dvi, postscript and pdf. In addition, files - specified by the $clean_ext configuration variable are removed. + Clean up (remove) all regenerateable files generated by \fIlatex\fR + and \fIbibtex\fR except dvi, postscript and pdf. In addition, files + specified by the $clean_ext configuration variable are removed. But + the file containing a database of source file information is not + removed. -This cleanup is instead of a regular make. See the \fB-gg\fR option +This cleanup is instead of a regular make. See the \fB\-gg\fR option - if you want to do a cleanup than a make. + if you want to do a cleanup then a make. .TP -.B -C +.B \-C Clean up (remove) all regenerateable files generated by \fIlatex\fR and \fIbibtex\fR including aux, dep, dvi, postscript and pdf. In addition, those specified by the $clean_ext and $clean_full_ext - configuration variables. + configuration variables are removed. But the file containing a + database of source file information is not removed. -This cleanup is instead of a regular make. See the \fB-gg\fR option +This cleanup is instead of a regular make. See the \fB\-gg\fR option if you want to do a cleanup than a make. --.TP --.B -c1 -+.TP -+.B \-c1 - Clean up (remove) all regenerateable files generated by \fIlatex\fR - and \fIbibtex\fR except aux and dep. In addition, files specified by - the $clean_ext and $clean_full_ext configuration variables are - removed. + .TP +-.B -CA ++.B \-CA + Clean up (remove) absolutely all regenerateable files generated by + \fIlatex\fR and \fIbibtex\fR including aux, dep, dvi, postscript and + pdf. In addition, those specified by the $clean_ext, $clean_full_ext, + and @generated_exts configuration variables are removed, and the file + containing a database of source file information. --This cleanup is instead of a regular make. See the \fB-gg\fR option -+This cleanup is instead of a regular make. See the \fB\-gg\fR option - if you want to do a cleanup than a make. +-This cleanup is instead of a regular make. It is the same as \fB-C +--CF\fR. See the \fB-gg\fR option if you want to do a cleanup then a ++This cleanup is instead of a regular make. It is the same as \fB\-C ++\-CF\fR. See the \fB\-gg\fR option if you want to do a cleanup then a + make. + .TP +-.B -CF ++.B \-CF + Remove the file containing a database of source file information, + before doing the other actions requested. .TP -.B -d +.B \-d @@ -199,8 +193,7 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 -Note that if the \fB-d\fR option is specified, the \fB-ps\fR option is +Note that if the \fB\-d\fR option is specified, the \fB\-ps\fR option is - assumed and the postscript file is always generated, even if it is newer - than the dvi file. + assumed. -.TP -.B -dF +.TP @@ -208,15 +201,22 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 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 -@@ -170,157 +170,157 @@ +@@ -175,117 +175,117 @@ Example usage: To use dviselect to select only the even pages of the dvi file: - latexmk -dF 'dviselect even' foo.tex -.TP --.B -dvi +-.B -diagnostics + latexmk \-dF 'dviselect even' foo.tex +.TP ++.B \-diagnostics + Print detailed diagnostics during a run. This may help for debugging + problems or to understand \fI.latexmk\fR's behavior in difficult + situations. +-.TP +-.B -dvi ++.TP +.B \-dvi Generate dvi version of document. -.TP @@ -227,18 +227,13 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 overridden, if some other file is made (a .ps file) that is generated from the dvi file, or if no generated file at all is requested.) -.TP --.B -diagnostics -+.TP -+.B \-diagnostics - Whenever a log file is parsed to determine the input and included - files, print a list of these files. --.TP -.B -f +.TP +.B \-f Force \fIlatexmk\fR to continue document processing despite errors. - Normally, when \fIlatexmk\fR detects that \fIlatex\fR has found an error - which will not be resolved by further processing, the program terminates. + Normally, when \fIlatexmk\fR detects that LaTeX or another program has + found an error which will not be resolved by further processing, no + further processing is carried out. -.TP -.B -f- -Turn off the forced processing-past-errors such as is set by the @@ -249,31 +244,12 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 +\fB\-f\fR option. This could be used to override a setting in a configuration file. -.TP --.B -F -+.TP -+.B \-F - Force \fIlatexmk\fR to include files that don't exist when generating - dependency files. A warning is produced instead of an error message and - the program terminating. If the file name is not an absolute path, it - is assumed to be relative to the current working directory. (Note: This --option is only relevant if you are using the \fB-it\fR to obtain the -+option is only relevant if you are using the \fB\-it\fR to obtain the - dependency information from the tex files. The default is to obtain --this information from the log file and it that case the \fB-F\fR -+this information from the log file and it that case the \fB\-F\fR - option has no effect.) --.TP --.B -F- --Turn off \fB-F\fR. --.TP -.B -g +.TP -+.B \-F\- -+Turn off \fB\-F\fR. -+.TP +.B \-g - Force \fIlatexmk\fR to process document, disregarding the timestamps of the - source files. + Force \fIlatexmk\fR to process document fully, even under situations + where \fIlatexmk\fR would normally decide that no changes in the + source files have occured since the previous run. This option is useful, for example, if you change some options and wish to reprocess the files. -.TP @@ -286,74 +262,22 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 +Turn off \fB\-g\fR. +.TP +.B \-gg - "Super go mode" or "clean make": clean out generated files as if the --\fB-C\fR had been given, and then do a regular make. + "Super go mode" or "clean make": clean out generated files as if +-\fB-CA\fR had been given, and then do a regular make. -.TP -.B -h, -help -+\fB\-C\fR had been given, and then do a regular make. ++\fB\-CA\fR had been given, and then do a regular make. +.TP +.B \-h, \-help Print help information. -.TP --.B -i -+.TP -+.B \-i - Generate new dependency file if root file is newer - than dependency file or dependency file does not exist. - The dependency information is taken from the log file or the source file, --depending on the setting made by the \fB-il\fR and \fB-it\fR switches. --.TP --.B -i- --Turn off \fB-i\fR. --.TP --.B -il -+depending on the setting made by the \fB\-il\fR and \fB\-it\fR switches. -+.TP -+.B \-i\- -+Turn off \fB\-i\fR. -+.TP -+.B \-il - Extract dependency information from log file. This is normally the best - method, so it is the default. However, some packages do not put - information on files read in the log file, and then it may be better to --tell \fIlatexmk\fR to get the information from the TeX file(s) --- see the --switch \fB-it\fR. -+tell \fIlatexmk\fR to get the information from the TeX file(s) \-\-\- see the -+switch \fB\-it\fR. - (Default) --.TP --.B -it -+.TP -+.B \-it - Extract dependency information by scanning the source TeX file(s), rather - than the log file. - This is the method used by earlier versions of \fIlatexmk\fR. It relies on - parsing TeX files, which can be confused by definitions of new commands, --etc. Normally it is better to tell \fIlatexmk\fR to scan the log file --- see --the switch \fB-il\fR. --.TP --.B -I -+etc. Normally it is better to tell \fIlatexmk\fR to scan the log file \-\-\- see -+the switch \fB\-il\fR. -+.TP -+.B \-I - Always generate new dependency file, even if newer - dependency file exists. - The dependency information is taken from the log file or the source file, --depending on the setting made by the \fB-il\fR and \fB-it\fR switches. --.TP --.B -I- --Turn off \fB-I\fR. --.TP -.B -l -+depending on the setting made by the \fB\-il\fR and \fB\-it\fR switches. -+.TP -+.B \-I\- -+Turn off \fB\-I\fR. +.TP +.B \-l Run in landscape mode, using the landscape mode for the previewers and - the dvi to postscript converters. + the dvi to postscript converters. This option is not normally needed + nowadays, since current previewers normally determine this information + automatically. -.TP -.B -l- -Turn off \fB-l\fR. @@ -376,28 +300,31 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 different directory). This option turns off this default behavior. -.TP -.B -new-viewer- --The inverse of the \fR-new-viewer\fB option. It puts \fIlatexmk\fR +-The inverse of the \fB-new-viewer\fR option. It puts \fIlatexmk\fR -in its normal behavior that in preview-continuous mode it checks for -an already-running previewer. -.TP -.B -p +.TP +.B \-new\-viewer\- -+The inverse of the \fR\-new\-viewer\fB option. It puts \fIlatexmk\fR ++The inverse of the \fB\-new\-viewer\fR option. It puts \fIlatexmk\fR +in its normal behavior that in preview\-continuous mode it checks for +an already\-running previewer. +.TP +.B \-p - Print out the file. By default, this is done using lpr after - generating the postscript version. But you can use the --\fB-print=...\fR option to print the dvi or pdf files instead, and you can -+\fB\-print=...\fR option to print the dvi or pdf files instead, and you can - configure this in a start up file (by setting the \fI$print_type\fR - variable. + Print out the document. By default on a UNIX or Linux system, this is + done using lpr after generating the postscript file. But you can use +-the \fB-print=...\fR option to print the dvi or pdf files instead, and ++the \fB\-print=...\fR option to print the dvi or pdf files instead, and + you can configure this in a start up file (by setting the + \fI$print_type\fR variable). --Under MS-Windows you must have configured the print commands used by -+Under MS\-Windows you must have configured the print commands used by - \fIlatexmk\fR. + However, the correct behavior for printing very much depends on your +-system's software. In particular, under MS-Windows you must have ++system's software. In particular, under MS\-Windows you must have + suitable program(s) available, and you must have configured the print +-commands used by \fIlatexmk\fR. This can be non-trivial. ++commands used by \fIlatexmk\fR. This can be non\-trivial. -This option is incompatible with the \fB-pv\fR and \fB-pvc\fR options, +This option is incompatible with the \fB\-pv\fR and \fB\-pvc\fR options, @@ -452,7 +379,7 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 Postscript file filtering. The argument to this option is a filter which will generate a filtered postscript file with the extension ".psF". All extra processing (e.g. preview, printing) will then be -@@ -328,112 +328,112 @@ +@@ -293,54 +293,54 @@ Example usage: Use psnup to print two pages on the one page: @@ -510,12 +437,13 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 -\fB-p\fR and \fB-pv\fR options, so it turns these options off +\fB\-p\fR and \fB\-pv\fR options, so it turns these options off - With a good previewer the display will be automatically --updated. (Under UNIX "gv -watch" does this for postscript files; it -+updated. (Under UNIX "gv \-watch" does this for postscript files; it - would also do it for pdf files except for an apparent bug in gv that - causes an error when the newly updated pdf file is read.) Other - previewers will need a manual update. + With a good previewer the display will be automatically updated. +-(Under \fIsome but not all\fR versions of UNIX/Linux "gv -watch" does ++(Under \fIsome but not all\fR versions 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.) Many other previewers will need a manual update. -Important note: the acroread program on MS-Windows locks the pdf file, +Important note: the acroread program on MS\-Windows locks the pdf file, @@ -527,13 +455,17 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 +to use a dvi or ps viewer, as set by one of the \fB\-view=dvi\fR and +\fB\-view=ps\fR options. - Note that if \fIlatexmk\fR dies because it encounters an error, the + There are some other methods for arranging an update, notably useful + for many versions of xdvi and xpdf. These are best set in +@@ -348,65 +348,65 @@ + + Note that if \fIlatexmk\fR dies or is stopped by the user, the "forked" previewer will continue to run. Successive invocations with -the \fB-pvc\fR option will not fork new previewers, but \fIlatexmk\fR +the \fB\-pvc\fR option will not fork new previewers, but \fIlatexmk\fR - will use the existing previewer. (At least this will happen when - \fIlatexmk\fR is running under an operating system where it knows how - to determine whether an existing previewer is running.) + will normally use the existing previewer. (At least this will happen + when \fIlatexmk\fR is running under an operating system where it knows + how to determine whether an existing previewer is running.) -.TP -.B -pvc- -Turn off \fB-pvc\fR. @@ -550,18 +482,21 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 +Same as \-silent +.TP +.B \-r - Read the specified initialization file ("RC file") before processing. --Be careful about the ordering: Standard initialization files --- see --the section below on "Initialization (RC) files" --- are read first, -+Be careful about the ordering: Standard initialization files \-\-\- see -+the section below on "Initialization (RC) files" \-\-\- are read first, - then the options on the command line in the order they are given. + Read the specified initialization file ("RC file") before processing. + +-Be careful about the ordering: (1) Standard initialization files -- +-see the section below on "Initialization (RC) files" -- are read ++Be careful about the ordering: (1) Standard initialization files \-\- ++see the section below on "Initialization (RC) files" \-\- are read + first. (2) Then the options on the command line are acted on in the + order they are given. Therefore if an initialization file is +-specified by the \fB-r\fR option, it is read during this second step. -Thus an initialization file specified with the \fB-r\fR option can ++specified by the \fB\-r\fR option, it is read during this second step. +Thus an initialization file specified with the \fB\-r\fR option can - override both the standard initialization files and previously - specified options. But all of these can be overridden by later - options. - See below for more details about initialization (RC) files. + override both the standard initialization files and \fIpreviously\fR + specified options. But all of these can be overridden by \fIlater\fR + options. See below for more details about initialization (RC) files. -.TP -.B -silent +.TP @@ -578,7 +513,7 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 -.B -v, -version +.TP +.B \-v, \-version - Print version number of \fILatexmk\fR. + Print version number of \fIlatexmk\fR. -.TP -.B -verbose -Opposite of \fB-silent\fR. This is the default setting. @@ -604,6 +539,7 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 +.PP +Options \fB\-p\fR, \fB\-pv\fR and \fB\-pvc\fR are mutually exclusive. So each of these options turns the others off. + -.SH EXAMPLES -.nf +.SH "EXAMPLES" @@ -620,7 +556,7 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 file, start a previewer. Then watch for changes in the source file thesis.tex and any files it -@@ -443,55 +443,56 @@ +@@ -416,55 +416,56 @@ encounters an error, latexmk will keep running. @@ -643,7 +579,7 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 "/usr/local/lib/latexmk/LatexMk". - On a MS-WINDOWS system it looks for "C:\\latexmk\\LatexMk". -.PP -+ On Fedora Core systems, it only looks for "/etc/latexmk.conf". ++ On Fedora systems, it only looks for "/etc/latexmk.conf". + On a MS\-WINDOWS system it looks for "C:\\latexmk\\LatexMk". +.PP 2) The user's RC file in "$HOME/.latexmkrc", where $HOME is the value @@ -698,7 +634,7 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 for the setting of an array of strings. Some of the variables set the names of the commands that \fIlatexmk\fR -@@ -499,37 +500,37 @@ +@@ -472,37 +473,37 @@ \fB"Detaching" a command\fR: If a command is to be run detached this is indicated by preceding it with "start", as in @@ -745,8 +681,8 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 +.PP This means that an appropriate command has not been configured. The string after the 'NONE' is effectively a comment. - \fBOptions to commands\fR: -@@ -538,9 +539,9 @@ + +@@ -512,9 +513,9 @@ Suppose you want \fIlatexmk\fR to use latex with source specials enabled. Then you might use the following line in an initialization file: @@ -759,7 +695,7 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 \fBAdvanced tricks\fR: Normally \fIlatexmk\fR assumes certain behavior for commands and in particular it assumes certain kinds and ordering -@@ -548,50 +549,50 @@ +@@ -522,50 +523,50 @@ example you might want to use Distiller to convert postscript files to pdf files. You cannot simply change the name of the ps2pdf conversion program, as in @@ -826,7 +762,7 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 .B @BIBINPUTS This is an array variable that specifies directories where \fIlatexmk\fR should look for .bib files. By default it is set from -@@ -614,13 +615,13 @@ +@@ -588,13 +589,13 @@ This variable is likely to become obsolete in a future version of \fIlatexmk\fR which uses a better method of searching for files. @@ -842,10 +778,10 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 -.TP +.TP .B $cleanup_mode [0] - If nonzero, specifies cleanup mode: 1 for full cleanup, 2 for cleanup + If nonzero, specifies cleanup mode: 1 for full cleanup, 2 for cleanup except for dvi, ps and pdf files, 3 for cleanup except for dep and aux -@@ -628,21 +629,21 @@ - and $clean_full_ext variables.) +@@ -602,21 +603,21 @@ + $clean_full_ext and @generated_exts variables.) This variable is equivalent to specifying one of -the \fB-c\fR, \fB-c1\fR, or \fB-C\fR options. But there should be no need @@ -855,9 +791,9 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 +.TP .B $clean_ext [""] Extra extensions of files for \fIlatexmk\fR to remove when any of the --clean-up options (\fB-c\fR, \fB-c1\fR, or \fB-C\fR) is selected. +-clean-up options (\fB-c\fR, \fB-c1\fR, or \fB-C\fR) is selected. -.TP -+clean\-up options (\fB\-c\fR, \fB\-c1\fR, or \fB\-C\fR) is selected. ++clean\-up options (\fB\-c\fR, \fB\-c1\fR, or \fB\-C\fR) is selected. +.TP .B $clean_full_ext [""] -Extra extensions of files for \fIlatexmk\fR to remove when the \fB-C\fR @@ -875,10 +811,10 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 .B @default_files [('*.tex')] Default list of files to be processed. -@@ -667,30 +668,30 @@ - - Note that more than file may be given, and that the default extension - is '.tex'. Wild cards are allowed. +@@ -643,30 +644,30 @@ + is '.tex'. Wild cards are allowed. The parentheses are because + \fI@default_files\fR is an array variable, i.e., a sequence of + filename specifications is possible. -.TP +.TP .B $dvi_filter [empty] @@ -916,7 +852,7 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 pdf file. WARNING 2: If you want to use one of the programs dvipdfm or dvipdfmx -@@ -700,24 +701,24 @@ +@@ -676,29 +677,29 @@ the command line. See the extra_scripts directory of the latexmk distribution, where the necessary scripts dvipdfm_call, etc are to be found, together with instructions for their use in the file README1. @@ -925,10 +861,10 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 .B $dvips ["dvips"] The program to used as a filter to convert a .dvi file to a .ps file. If pdf is going to be generated from pdf, then the value of the --$dvips_pdf_switch --- see below --- will be appended. +-$dvips_pdf_switch -- see below -- will be appended. -.TP -.B $dvips_landscape ["dvips -tlandscape"] -+$dvips_pdf_switch \-\-\- see below \-\-\- will be appended. ++$dvips_pdf_switch \-\- see below \-\- will be appended. +.TP +.B $dvips_landscape ["dvips \-tlandscape"] The program to used as a filter to convert a .dvi file to a .ps file @@ -937,13 +873,19 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 -.B $dvips_pdf_switch ["-P pdf"] +.TP +.B $dvips_pdf_switch ["\-P pdf"] - \fBSwitch(es)\fR for dvips program when pdf file is to be generated from + Switch(es) for dvips program when pdf file is to be generated from ps file. -.TP -.B $dvips_silent_switch ["-q"] +.TP +.B $dvips_silent_switch ["\-q"] - \fBSwitch(es)\fR for dvips program when silent mode is on. + Switch(es) for dvips program when silent mode is on. +-.TP ++.TP + .B $dvi_update_command [""] + When the dvi previewer is set to be updated by running a command, this + is the command that is run. See the information for the variable + \fI$dvi_update_method\fR. -.TP -.B $dvi_update_method [2 under UNIX, 1 under MS-Windows] +.TP @@ -951,14 +893,16 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 How the dvi viewer updates its display when the dvi file has changed. 0 => update is automatic, 1=> manual update by user, which may only mean a mouse click on the -@@ -725,35 +726,35 @@ +@@ -706,26 +707,26 @@ 2 => Send the signal, whose number is in the variable $dvi_update_signal. The default value under UNIX is suitable for xdvi. 3 => Viewer cannot do an update, because it locks the file. (As with -acroread under MS-Windows.) ++acroread under MS\-Windows.) + 4 => run a command to do the update. The command is specified by + the variable $dvi_update_command. -.TP -.B $dvi_update_signal [Under UNIX: SIGUSR1, which is a system-dependent value] -+acroread under MS\-Windows.) +.TP +.B $dvi_update_signal [Under UNIX: SIGUSR1, which is a system\-dependent value] The number of the signal that is sent to the dvi viewer when it is @@ -967,50 +911,25 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 value is the one appropriate for xdvi on a UNIX system. -.TP +.TP - .B $force_generate_and_save_includes [0] - If nonzero, specifies that the dependency file should always be --generated. Equivalent to specifying the \fB-I\fR option. + .B $fdb_ext ["fdb_latex"] + The extension of the file which \fIlatexmk\fR generates to contain a + database of information on source files. You will not normally need + to change this. -.TP -+generated. Equivalent to specifying the \fB\-I\fR option. +.TP .B $force_mode [0] If nonzero, continue processing past minor \fIlatex\fR errors including unrecognized cross references. Equivalent to specifying the -\fB-f\fR option. --Note that specifying the \fB-pvc\fR sets $forec_mode to 1. +-Note that specifying the \fB-pvc\fR sets $force_mode to 1. -.TP +\fB\-f\fR option. -+Note that specifying the \fB\-pvc\fR sets $forec_mode to 1. -+.TP - .B $force_include_mode [0] - If nonzero, force \fIlatexmk\fR to include files that don't exist when - generating dependency files. A warning is produced instead of an error - message and the program terminating. If the file name is not an - absolute path, it is assumed to be relative to the current working --directory. Equivalent to specifying the \fB-F\fR option. --.TP -+directory. Equivalent to specifying the \fB\-F\fR option. -+.TP - .B $generate_and_save_includes [0] - If nonzero, generates dependency file if it does not exist or is older - than the root file (the base .tex file). Equivalent to specifying --the \fB-i\fR option. --.TP -+the \fB\-i\fR option. ++Note that specifying the \fB\-pvc\fR sets $force_mode to 1. +.TP - .B @generated_exts [( 'ind', 'lof', 'lot', 'out', 'toc')] + .B @generated_exts [( 'ind', 'lof', 'lot', 'out', 'toc', $fdb_ext)] This contains a list of extensions for files that are generated (directly or indirectly) during a LaTeX run and that are read in by -@@ -761,7 +762,7 @@ - from the .log file, it will ignore files with the extensions in - \fI@generated_exts\fR, since NORMALLY they are not true source files, - and the time stamps of these may mislead \fIlatexmk\fR as to whether --the real output files are up-to-date. -+the real output files are up\-to\-date. - - The extensions "aux" and "bbl" are always excluded from the dependents, - because they get special treatment, so they do not need to be in this -@@ -775,43 +776,43 @@ +@@ -750,38 +751,38 @@ adds the extension 'end' to the list of predefined generated extensions. @@ -1022,15 +941,6 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 -.TP +\fB\-g\fR option. +.TP - .B $includes_from_log [1] - If nonzero, extract dependency information from the log file, rather than --the source TeX file(s); this is equivalent to the \fB-il\fR option. -+the source TeX file(s); this is equivalent to the \fB\-il\fR option. - If zero, extract dependency information by scanning the source TeX file(s); --this is equivalent to the \fB-it\fR option. --.TP -+this is equivalent to the \fB\-it\fR option. -+.TP .B $index_mode [0 and then as determined from the results of a run] If nonzero, run \fImakeindex\fR to produce index of document. Normally you should not need to set this variable in an RC file, since @@ -1040,8 +950,9 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 .B $landscape_mode [0] If nonzero, run in landscape mode, using the landscape mode previewers and -dvi to postscript converters. Equivalent to the \fB-l\fR option. --.TP +dvi to postscript converters. Equivalent to the \fB\-l\fR option. + Normally not needed with current previewers. +-.TP +.TP .B $latex ["latex"] The LaTeX processing program. Note that as with other programs, you @@ -1064,17 +975,17 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 .B $lpr ["lpr"] -[Default is "NONE lpr" under MS-WINDOWS.] +[Default is "NONE lpr" under MS\-WINDOWS.] - The printing program to print postscript files. + The command to print postscript files. -Under MS-Windows (unlike UNIX/LINUX), there is no standard program for +Under MS\-Windows (unlike UNIX/LINUX), there is no standard program for printing files. But there are ways you can do it. For example, if - you have gsview installed, you can use it with the option '/p': - -@@ -822,14 +823,14 @@ - is necessary because one part of the command name ('Program Files') - contains a space which would otherwise be misinterpreted. + you have gsview installed, you could use it with the option '/p': +@@ -795,14 +796,14 @@ + the command obeyed; this is necessary because one part of the command + name ('Program Files') contains a space which would otherwise be + misinterpreted. -.TP +.TP .B $lpr_dvi ["NONE lpr_dvi"] @@ -1089,7 +1000,7 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 e.g., $lpr = '"c:/Program Files/Ghostgum/gsview/gsview32.exe" /p'; -@@ -839,18 +840,18 @@ +@@ -812,18 +813,18 @@ is necessary because one part of the command name ('Program Files') contains a space which would otherwise be misinterpreted. @@ -1113,17 +1024,15 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 .B $pdf_mode [0] If zero, do NOT generate a pdf version of the document. If equal to 1, generate a pdf version of the document using pdflatex. -@@ -858,148 +859,148 @@ +@@ -831,153 +832,153 @@ file, by using the command specified by the $ps2pdf variable. If equal to 3, generate a pdf version of the document from the dvi file, by using the command specified by the $dvipdf variable. -Equivalent to the \fB-pdf-\fR, \fB-pdf\fR, \fB-pdfdvi\fR, --\fB-pdfps\fR options, -+Equivalent to the \fB\-pdf\-\fR, \fB\-pdf\fR, \fB\-pdfdvi\fR, -+\fB\-pdfps\fR options, - and is stored in the dependency file - if generated. +-\fB-pdfps\fR options. -.TP ++Equivalent to the \fB\-pdf\-\fR, \fB\-pdf\fR, \fB\-pdfdvi\fR, ++\fB\-pdfps\fR options. +.TP .B $pdflatex ["pdflatex"] The LaTeX processing program in the version that makes a pdf file instead @@ -1132,7 +1041,7 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 -.B $pdflatex_silent_switch ["-interaction=batchmode"] +.TP +.B $pdflatex_silent_switch ["\-interaction=batchmode"] - \fBSwitch(es)\fR for the LaTeX processing program when silent mode is on. + Switch(es) for the LaTeX processing program when silent mode is on. -Under MS-Windows, the default value is changed to -"-interaction=batchmode -c-style-errors", as used by MikTeX and fpTeX. -.TP @@ -1157,11 +1066,20 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 This problem does not occur if ghostview, gv or gsview is used to view pdf files. -.TP ++.TP + .B $pdf_update_command [""] + When the pdf previewer is set to be updated by running a command, this + is the command that is run. See the information for the variable + \fI$pdf_update_method\fR. +-.TP -.B $pdf_update_method [1 under UNIX, 3 under MS-Windows] +.TP +.B $pdf_update_method [1 under UNIX, 3 under MS\-Windows] How the pdf viewer updates its display when the pdf file has - changed. See $dvi_update_method for the codes. + changed. See $dvi_update_method for the codes, with the change that + for the value 4, to run a command to do the update, the command is + specified by the variable $pdf_update_command. + -Note that acroread under MS-Windows (but not UNIX) locks the pdf file, so +Note that acroread under MS\-Windows (but not UNIX) locks the pdf file, so the default value is then 3. @@ -1203,24 +1121,24 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 +continue running \fIlatexmk\fR to keep .dvi up\-to\-date. Equivalent to +the \fB\-pvc\fR option. Which previewer is run depends on the other settings, see the command --line options $\fB-view=\fR. +-line options \fB-view=\fR, and the variable \fI$view\fR. -.TP -+line options $\fB\-view=\fR. ++line options \fB\-view=\fR, and the variable \fI$view\fR. +.TP .B $preview_mode [0] If nonzero, run a previewer to preview the document. -Equivalent to the \fB-pv\fR option. +Equivalent to the \fB\-pv\fR option. Which previewer is run depends on the other settings, see the command --line options $\fB-view=\fR. +-line options \fB-view=\fR, and the variable \fI$view\fR. -.TP -+line options $\fB\-view=\fR. ++line options \fB\-view=\fR, and the variable \fI$view\fR. +.TP .B $printout_mode [0] If nonzero, print the document using \fIlpr\fR. Equivalent to the --\fB-p\fR option. Recommend that this is not set from an RC file or -+\fB\-p\fR option. Recommend that this is not set from an RC file or - you could waste lots of paper. +-\fB-p\fR option. This is recommended \fBnot\fR to be set from an RC ++\fB\-p\fR option. This is recommended \fBnot\fR to be set from an RC + file, otherwise you could waste lots of paper. -.TP +.TP .B $print_type = ["ps"] @@ -1241,9 +1159,9 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 previewer. The command line options for this command under the different flavors of UNIX are quite variable. The command given above is suitable for Solaris - 2.6 and above, and \fBlatexmk\fR corrects it for Linux and OSX. + 2.6 and above, and \fIlatexmk\fR corrects it for Linux and OSX. - NOTE: The variable $pid_position must also be set: see its description. + NOTE: The variable \fI$pid_position\fR must also be set; see its description. -.TP +.TP .B $ps2pdf ["ps2pdf"] @@ -1280,11 +1198,19 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 Windows, this will cause to be run whatever command the system has associated with .ps files.] -.TP ++.TP + .B $ps_update_command [""] + When the postscript previewer is set to be updated by running a command, this + is the command that is run. See the information for the variable + \fI$ps_update_method\fR. +-.TP -.B $ps_update_method [0 under UNIX, 1 under MS-Windows] +.TP +.B $ps_update_method [0 under UNIX, 1 under MS\-Windows] How the postscript viewer updates its display when the ps file has - changed. See $dvi_update_method for the codes. + changed. See $dvi_update_method for the codes, with the change that + for the value 4, to run a command to do the update, the command is + specified by the variable $ps_update_command. -.TP -.B $ps_update_signal [Under UNIX: SIGHUP, which is a system-dependent value] +.TP @@ -1303,39 +1229,33 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 +.TP .B $texfile_search [""] This is an obsolete variable, replaced by the \fI@default_files\fR --variable -- see the description of \fI@default_files\fR for how it -+variable \-\- see the description of \fI@default_files\fR for how it - works. + variable. - For backward compatibility, if you choose to set it, --\fI$texfile_search\fR is a string of space-separated filenames, and -+\fI$texfile_search\fR is a string of space\-separated filenames, and + For backward compatibility, if you choose to set +-\fI$texfile_search\fR, it is a string of space-separated filenames, and ++\fI$texfile_search\fR, it is a string of space\-separated filenames, and then \fIlatexmk\fR replaces \fI@default_files\fR with the filenames in \fI$texfile_search\fR to which is added '*.tex'. -.TP --.B $tmpdir ["/tmp" under UNIX, value of environment variable TEMP under MS-Windows] -+.TP -+.B $tmpdir ["/tmp" under UNIX, value of environment variable TEMP under MS\-Windows] - Directory to store temporary files that \fIlatexmk\fR generates while - running. Currently it only has a minor use, when making a banner to - insert in a postscript file. There should be no trailing separator. - It should not be necessary to change this value except when running - under Cygwin. -- -+.TP - .B @TEXINPUTS - This is an array variable that under circumstances specifies - directories where \fIlatexmk\fR should look for .tex files. By -@@ -1008,58 +1009,58 @@ - element list consisting of the current directory is set. The format - is as for the @BIBINPUTS variable (qv). - --This variable is almost obsolete. It is only used when the \fB-it\fR -+This variable is almost obsolete. It is only used when the \fB\-it\fR - option is used to force \fIlatexmk\fR to scan the .tex files to find - the input files instead of scanning the .log file, which it does by - default. Since the .log file contains full path information, you - should not need, normally, to set the @TEXINPUTS variable. ++.TP + .B $tmpdir [See below for default] + Directory to store temporary files that \fIlatexmk\fR may generate while + running. +@@ -986,62 +987,62 @@ + \fI$tmpdir\fR to the value of the first of whichever of the system + environment variables TMPDIR or TEMP exists, otherwise to the current + directory. Under other operating systems (expected to be UNIX/Linux, +-including OS-X), the default is the value of the system environment ++including OS\-X), the default is the value of the system environment + variable TMPDIR if it exists, otherwise to "/tmp". +-.TP ++.TP + .B $view ["default"] + Which kind of file is to be previewed if a previewer is used. The + possible values are 'default', 'dvi', 'ps', 'pdf'. The value of + "default" means that the "highest" of the kinds of file generated is + to be used (among dvi, ps and pdf). + -.SH CUSTOM DEPENDENCIES -.PP +.SH "CUSTOM DEPENDENCIES" @@ -1402,7 +1322,7 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 Search for .bib files is not correct if they are not in the current directory; the problem is that the log file generated by bibtex does not give the full path to the .bib files. The easiest fix at the moment is to -@@ -1080,27 +1081,27 @@ +@@ -1062,29 +1063,29 @@ Gv on UNIX/LINUX works for both postscript and pdf. Ghostview on UNIX/LINUX needs a manual update (reopen); it views postscript and pdf. @@ -1417,7 +1337,9 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 instead.) -.SH THANKS TO +.SH "THANKS TO" - David Coppit (username david at node coppit.org) made many useful + Authors of previous versions. Many users with their feedback, and + especially + David Coppit (username david at node coppit.org) who made many useful suggestions that contributed to version 3. (Please note that the -e-mail addresses are not written in their standard form to avoid being +e\-mail addresses are not written in their standard form to avoid being @@ -1426,7 +1348,7 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 +.SH "AUTHOR" Current version, with substantial modifications, enhancements and bug fixes by John Collins (username collins at node phys.psu.edu). - (Version 3.08g). + (Version 3.09). It can be obtained from CTAN: -, and from the @@ -1438,10 +1360,10 @@ diff -dur latexmk-3.08n.ORIG/latexmk.1 latexmk-3.08n/latexmk.1 -.br +.br Original script called "go" by David J. Musliner (RCS Version 3.2) -diff -dur latexmk-3.08n.ORIG/latexmk.pl latexmk-3.08n/latexmk.pl ---- latexmk-3.08n.ORIG/latexmk.pl 2007-02-27 11:55:42.000000000 -0700 -+++ latexmk-3.08n/latexmk.pl 2007-02-27 11:57:13.000000000 -0700 -@@ -804,10 +804,8 @@ +diff -dur latexmk-3.20.ORIG/latexmk.pl latexmk-3.20/latexmk.pl +--- latexmk-3.20.ORIG/latexmk.pl 2007-08-31 21:46:47.000000000 -0600 ++++ latexmk-3.20/latexmk.pl 2007-08-31 21:45:50.000000000 -0600 +@@ -584,10 +584,8 @@ ## /usr/local/share, depending on the local conventions. ## /usr/local/lib/latexmk/LatexMk is put in the list for ## compatibility with older versions of latexmk. @@ -1449,7 +1371,7 @@ diff -dur latexmk-3.08n.ORIG/latexmk.pl latexmk-3.08n/latexmk.pl - ( '/opt/local/share/latexmk/LatexMk', - '/usr/local/share/latexmk/LatexMk', - '/usr/local/lib/latexmk/LatexMk' ); -+ ## Fedora Core change: only look in /etc ++ ## Fedora change: only look in /etc + @rc_system_files = ( '/etc/latexmk.conf' ); $search_path_separator = ':'; # Separator of elements in search_path diff --git a/latexmk-perl.patch b/latexmk-perl.patch index 37b0fe3..3ac3b5b 100644 --- a/latexmk-perl.patch +++ b/latexmk-perl.patch @@ -1,5 +1,5 @@ ---- latexmk.pl.ORIG 2007-02-20 10:19:23.000000000 -0700 -+++ latexmk.pl 2007-02-20 10:22:18.000000000 -0700 +--- latexmk.pl.ORIG 2007-08-17 12:21:57.000000000 -0600 ++++ latexmk.pl 2007-08-31 21:38:25.000000000 -0600 @@ -1,23 +1,4 @@ -eval '(exit $?0)' && eval 'exec perl -x -S "$0" ${1+"$@"}' && -eval 'exec perl -x -S "$0" $argv:q' @@ -22,5 +22,5 @@ -# Source of the above: manpage for perlrun - - # ATTEMPT TO ALLOW FILENAMES WITH SPACES: - # (as of 1 Apr 2006) + # Delete #??!! when working + diff --git a/latexmk.conf b/latexmk.conf index b451fcb..02b2e2f 100644 --- a/latexmk.conf +++ b/latexmk.conf @@ -1,4 +1,4 @@ -# This is the system-wide configuration file for latexmk. +# This is the system-wide configuration file for latexmk version 3.20. # See the latexmk(1) man page for more information. # # The following options are given their default values. @@ -62,7 +62,7 @@ $dvi_previewer_landscape = 'xdg-open'; # $dvips = 'dvips'; # The command to convert a DVI file into a PostScript file in landscape mode -# $dvips = 'dvips -tlandscape'; +# $dvips_landscape = 'dvips -tlandscape'; # Command line switch for dvips when a PDF file is to be generated # $dvips_pdf_switch = '-P pdf'; @@ -70,16 +70,20 @@ $dvi_previewer_landscape = 'xdg-open'; # Command line switch for dvips to make it run in silent mode # $dvips_silent_switch = '-q'; +# The command to run when the DVI viewer is set to be updated by a command +# $dvi_update_command = ''; + # How to make the DVI viewer update its display when the DVI file changes. # See the man page for a description of each method. # $dvi_update_method = 2; $dvi_update_method = 1; # When DVI update method 2 is used, the number of the Unix signal to send -# $dvi_update_signal = SIGUSR1 (a system-dependent value) +# $dvi_update_signal = SIGUSR1 -# If nonzero, the dependency file is always generated -# $force_generate_and_save_includes = 0; +# The extension of the file which latexmk generates to contain a database +# of information on source files. +# $fdb_ext = 'fdb_latex'; # If nonzero, continue processing past minor LaTeX errors # This option is made nonzero if the -pvs command line option is used. @@ -89,22 +93,14 @@ $dvi_update_method = 1; # dependency files. # $force_include_mode = 0; -# If nonzero, generate the dependency file if it does not exist or is older -# than the base .tex file -# $generate_and_save_includes = 0; - # The list of extensions for files that are generated in one run and consumed # by later runs of one of the LaTeX tools. The 'aux' and 'bbl' extensions are # treated specially, and hence are not in this list. -# @generated_exts = ( 'ind', 'lof', 'lot', 'out', 'toc' ); +# @generated_exts = ( 'ind', 'lof', 'lot', 'out', 'toc', $fdb_ext ); # If nonzero, process files regardless of timestamps # $go_mode = 0; -# If nonzero, extract dependency information from the log file instead of the -# .tex file. If zero, extract dependency information from the .tex file. -# $includes_from_log = 1; - # If nonzero, run makeindex to produce a document index. Normally, latexmk # should be able to figure out when this is necessary. # $index_mode = 0; @@ -153,12 +149,15 @@ $dvi_update_method = 1; # $pdf_previewer = 'start acroread'; $pdf_previewer = 'xdg-open'; +# The command to run when the PDF viewer is set to be updated by a command +# $pdf_update_command = ''; + # How to make the PDF viewer update its display when the PDF file changes. # See the man page for a description of each method. # $pdf_update_method = 1; # When PDF update method 2 is used, the number of the Unix signal to send -# $pdf_update_signal = SIGHUP (a system-dependent value) +# $pdf_update_signal = SIGHUP # Where the pid is in the output of $pscmd; see the man page # $pid_position = 1; @@ -180,7 +179,7 @@ $pdf_previewer = 'xdg-open'; # $print_type = 'ps'; # Command used to list all the processes currently run by the user -# $pscmd = "ps --width 200 -f -u $ENV{USER}"; +# $pscmd = "ps -f -u $ENV{USER}"; # Command to convert a PostScript file to a PDF file # $ps2pdf = 'ps2pdf'; @@ -194,7 +193,11 @@ $ps_previewer = 'xdg-open'; # The command to invoke a PostScript previewer in landscape mode # $ps_previewer_landscape = 'start gv -swap -watch'; -$ps_previwer = 'xdg-open'; +$ps_previewer_landscape = 'xdg-open'; + +# The command to run when the PostScript viewer is set to be updated by a +# command +# $ps_update_command = ''; # How to make the PostScript viewer update its display when the PostScript # file changes. See the man page for a description of each method. @@ -203,7 +206,7 @@ $ps_update_method = 1; # When PostScript update method 2 is used, the number of the Unix signal to # send -# $ps_update_signal = SIGHUP (a system-dependent value) +# $ps_update_signal = SIGHUP # The time to sleep in seconds between checking for source file changes when # running in continuous update mode @@ -211,3 +214,9 @@ $ps_update_method = 1; # The directory to store temporary files; omit the trailing '/' # $tmpdir = '/tmp'; + +# Which kind of file is to be previewed if a previewer is used. The possible +# values are 'default', 'dvi', 'ps', and 'pdf'. The value of 'default' means +# that the PDF is viewed if it is generated, else PostScript is viewed if it is +# generated, else DVI is viewed. +# $view = 'default'; diff --git a/latexmk.spec b/latexmk.spec index 6606994..8e7dd69 100644 --- a/latexmk.spec +++ b/latexmk.spec @@ -1,12 +1,12 @@ Name: latexmk -Version: 3.08n -Release: 5%{?dist} +Version: 3.20 +Release: 1%{?dist} Summary: A make-like utility for LaTeX files Group: Applications/Publishing License: GPLv2+ URL: http://www.phys.psu.edu/~collins/software/latexmk-jcc/ -Source0: http://www.phys.psu.edu/~collins/software/latexmk-jcc/latexmk-308n.zip +Source0: http://www.phys.psu.edu/~collins/software/latexmk-jcc/latexmk-320.zip Source1: latexmk.conf Source2: latexmk-README.fedora Patch0: latexmk-perl.patch @@ -14,9 +14,7 @@ Patch1: latexmk-conf.patch BuildRoot: %{_tmppath}/%{name}-%{version}-%{release}-root-%(%{__id_u} -n) BuildArch: noarch -# F7 and earlier use tetex, F8 and later use texlive, so require the binaries -Requires: /usr/bin/latex, /usr/bin/bibtex, /usr/bin/makeindex -Requires: ghostscript, xdg-utils +Requires: tetex, tetex-latex, ghostscript, xdg-utils %description Latexmk is a perl script for running LaTeX the correct number of times to @@ -41,9 +39,6 @@ cp %{SOURCE2} README.fedora # the man page accordingly. %patch1 -p1 -# Get rid of the DOS batch files so we can %doc extra-scripts below -rm -f extra-scripts/*.bat - %build %install @@ -66,6 +61,10 @@ rm -rf $RPM_BUILD_ROOT %doc CHANGES COPYING INSTALL README README.fedora extra-scripts %changelog +* Fri Aug 31 2007 Jerry James - 3.20-1 +- New version 3.20. +- Texlive isn't as near as I thought; require the tetex packages for now. + * Tue Aug 21 2007 Jerry James - 3.08n-5 - Update license tag diff --git a/sources b/sources index bf0c8bd..1148b16 100644 --- a/sources +++ b/sources @@ -1 +1 @@ -0849be9d5aabe03e6de7159c8d10a191 latexmk-308n.zip +fba0740fd6e5b9001c1300b3425cb659 latexmk-320.zip