From 01b6260553399b129d0cd12fed15fa8eb8b1ba52 Mon Sep 17 00:00:00 2001 From: Jerry James Date: Mar 30 2007 15:34:53 +0000 Subject: auto-import latexmk-3.08n-4 on branch devel from latexmk-3.08n-4.src.rpm --- diff --git a/.cvsignore b/.cvsignore index e69de29..5010110 100644 --- a/.cvsignore +++ b/.cvsignore @@ -0,0 +1 @@ +latexmk-308n.zip diff --git a/latexmk-README.fedora b/latexmk-README.fedora new file mode 100644 index 0000000..42fbf4c --- /dev/null +++ b/latexmk-README.fedora @@ -0,0 +1,103 @@ +I. CHANGES FROM UPSTREAM + +Latexmk almost works out of the box. Three changes have been made to +conform to Fedora Core conventions. First, the default DVI, PostScript, +and PDF previewers have been changed to 'xdg-open'; see below for more +information. Second, the script has been altered so that it does not +search for the perl binary; perl is in a known location on Fedora Core +systems. Finally, the site-wide configuration file is /etc/latexmk.conf +only, as opposed to the list of names searched by the original latexmk. + +II. PREVIEWERS + +The command xdg-open views a file using the viewer selected by the user +for that type of file. See the xdg-mime(1) command for more +information. Unfortunately, the use of xdg-open precludes the updating +of the previewing application, as latexmk cannot know which application +is doing the previewing. It also breaks viewing of landscape documents +for some previewers. For best results, you should customize latexmk for +the particular previewers you intend to use. Following are the settings +for some commonly used previewers, to be placed in the site, user, or +project configuration file. Note that an update method of 1 means that +there is no way for latexmk to cause the program to refresh; you have to +take some action of your own to see changes to the document. + + A. DVI PREVIEWERS + + 1. xdvi + + $dvi_previewer = 'start xdvi'; + $dvi_previewer_landscape = 'start xdvi -paper usr'; + $dvi_update_method = 2; + + 2. pxdvi + + $dvi_previewer = 'start pxdvi'; + $dvi_previewer_landscape = 'start pxdvi -paper usr'; + $dvi_update_method = 2; + + 3. kdvi + + $dvi_previewer = 'start kdvi'; + $dvi_previewer_landscape = 'start kdvi'; + $dvi_update_method = 0; + + B. POSTSCRIPT PREVIEWERS + + 1. gv + + $ps_previewer = 'start gv -watch'; + $ps_previewer_landscape = 'start gv -swap -watch'; + $ps_update_method = 0; + + 2. evince + + $ps_previewer = 'start evince'; + $ps_previewer_landscape = 'start evince'; + $ps_update_method = 1; + + 3. kghostview + + $ps_previewer = 'start kghostview'; + $ps_previewer_landscape = 'start kghostview --orientation=landscape'; + $ps_update_method = 1; + + If you can remember to set the "Watch File" option in + kghostview, then instead set: + + $ps_update_method = 0; + + Unfortunately, there appears to be no command line argument to + set the "Watch File" option. + + C. PDF PREVIEWERS + + 1. gv + + $pdf_previewer = 'start gv -watch'; + $pdf_update_method = 0; + + 2. evince + + $pdf_previewer = 'start evince'; + $pdf_update_method = 1; + + 3. kghostview + + $pdf_previewer = 'start kghostview'; + $pdf_update_method = 1; + + See the remark on the "Watch File" option above. + + 4. kpdf + + $pdf_previewer = 'start kpdf; + $pdf_update_method = 1; + + The "Watch File" remark above for kghostview applies to kpdf also. + + 5. acroread + + $pdf_previewer = 'start acroread'; + $pdf_update_method = 1; + diff --git a/latexmk-conf.patch b/latexmk-conf.patch new file mode 100644 index 0000000..b7f9861 --- /dev/null +++ b/latexmk-conf.patch @@ -0,0 +1,1456 @@ +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 +@@ -1,9 +1,9 @@ +-.TH LATEXMK 1L "16 February 2007" "" +-.SH NAME ++.TH "LATEXMK" "1L" "16 February 2007" "" "" ++.SH "NAME" + latexmk \- generate LaTeX document +-.SH SYNOPSIS ++.SH "SYNOPSIS" + .B latexmk [options] [file ...] +-.SH DESCRIPTION ++.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. +-.PP ++.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.] +-.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). +-.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). ++.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. +-.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. +-.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. +-.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. +-.SH LATEXMK OPTIONS AND ARGUMENTS +-(All options can be introduced by single or double "-" characters, +-e.g., "latexmk -help" or "latexmk --help".) +-.TP ++.SH "LATEXMK OPTIONS AND ARGUMENTS" ++(All options can be introduced by single or double "\-" characters, ++e.g., "latexmk \-help" or "latexmk \-\-help".) ++.TP + .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 @@ + latexmk foo + + then \fIlatexmk\fR will operate on the file "foo.tex". +-.TP +-.B -bm ++.TP ++.B \-bm + A banner 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 \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. +-.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 + toner cartridge is getting low. +-.TP +-.B -bs ++.TP ++.B \-bs + 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 + which is just right for 5 character messages. + .TP +-.B -commands ++.B \-commands + List the commands used by \fIlatexmk\fR for processing files, and then + exit. + .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. + +-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 -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. + +-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. + +-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 -d ++.B \-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 \fB-bs\fR and \fB-bi\fR options. The \fB-bm\fR ++can be modified with the \fB\-bs\fR and \fB\-bi\fR options. The \fB\-bm\fR + option will override this option as this is really just a short way of + specifying: + +- latexmk -bm DRAFT ++ latexmk \-bm DRAFT + +-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. +-.TP +-.B -dF ++.TP ++.B \-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 +@@ -170,157 +170,157 @@ + + Example usage: To use dviselect to select only the even pages of the dvi file: + +- latexmk -dF 'dviselect even' foo.tex +-.TP +-.B -dvi ++ latexmk \-dF 'dviselect even' foo.tex ++.TP ++.B \-dvi + Generate dvi version of document. +-.TP +-.B -dvi- ++.TP ++.B \-dvi\- + Turn off generation of dvi version of document. (This may get + 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. +-.TP +-.B -f- +-Turn off the forced processing-past-errors such as is set by the +-\fB-f\fR option. This could be used to override a setting in a ++.TP ++.B \-f\- ++Turn off the forced processing\-past\-errors such as is set by the ++\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. + This option is useful, for example, if you change some options and + wish to reprocess the files. +-.TP +-.B -g- +-Turn off \fB-g\fR. +-.TP +-.B -gg ++.TP ++.B \-g\- ++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. +-.TP +-.B -h, -help ++\fB\-C\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. +-.TP +-.B -l- +-Turn off \fB-l\fR. +-.TP +-.B -new-viewer +-When in continuous-preview mode, always start a new viewer to view the +-generated file. By default, \fIlatexmk\fR will, in continuous-preview ++.TP ++.B \-l\- ++Turn off \fB\-l\fR. ++.TP ++.B \-new\-viewer ++When in continuous\-preview mode, always start a new viewer to view the ++generated file. By default, \fIlatexmk\fR will, in continuous\-preview + mode, test for a previously running previewer for the same file and + not start a new one if a previous previewer is running. However, its +-test sometimes fails (notably if there is an already-running previewer ++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 off this default behavior. +-.TP +-.B -new-viewer- +-The inverse of the \fR-new-viewer\fB 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 ++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. + +-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. + +-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, + so it turns them off. +-.TP +-.B -pdf ++.TP ++.B \-pdf + Generate pdf version of document using pdflatex. +-.TP +-.B -pdfdvi ++.TP ++.B \-pdfdvi + Generate pdf version of document from the dvi file, by default using dvipdf. +-.TP +-.B -pdfps ++.TP ++.B \-pdfps + Generate pdf version of document from the ps file, by default using + ps2pdf. +-.TP +-.B -pdf- ++.TP ++.B \-pdf\- + Turn off generation of pdf version of document. + (This can be used to override a setting in a configuration file. + It may get overridden if some other option requires the generation of + a pdf file.) +-.TP +-.B -print=dvi, -print=ps, -print=pdf ++.TP ++.B \-print=dvi, \-print=ps, \-print=pdf + Define which kind of file is printed. This option also ensures that + the requisite file is made, and turns on printing. +-.TP +-.B -ps ++.TP ++.B \-ps + Generate postscript version of document. +-.TP +-.B -ps- ++.TP ++.B \-ps\- + Turn off generation of postscript version of document. + This can be used to override a setting in a configuration file. + (It may get overridden by some other option that requires a postscript + file, for example a request for printing.) +-.TP +-.B -pF ++.TP ++.B \-pF + 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 @@ + + Example usage: Use psnup to print two pages on the one page: + +- latexmk -ps -pF 'psnup -2' foo.tex ++ latexmk \-ps \-pF 'psnup \-2' foo.tex + + or + +- latexmk -ps -pF "psnup -2" foo.tex ++ latexmk \-ps \-pF "psnup \-2" foo.tex + +-Whether to use single or double quotes round the "psnup -2" will depend on ++Whether to use single or double quotes round the "psnup \-2" will depend on + your command interpreter, in particular on the operating system. +-.TP +-.B -pv +-Run file previewer. If the \fB-view\fR option is used, this will select ++.TP ++.B \-pv ++Run file previewer. If the \fB\-view\fR option is used, this will select + the kind of file to be previewed (dvi, ps or pdf). + Otherwise the viewer views the "highest" kind of file selected, by the +-\fB-dvi\fR, \fB-ps\fR, \fB-pdf\fR, \fB-pdfps\fR options, in the ++\fB\-dvi\fR, \fB\-ps\fR, \fB\-pdf\fR, \fB\-pdfps\fR options, in the + order dvi, ps, pdf (low to high). + If no file type has been selected, the dvi previewer will be used. +-This option is incompatible with the \fB-p\fR and \fB-pvc\fR options, ++This option is incompatible with the \fB\-p\fR and \fB\-pvc\fR options, + so it turns them off. +-.TP +-.B -pv- +-Turn off \fB-pv\fR. +-.TP +-.B -pvc ++.TP ++.B \-pv\- ++Turn off \fB\-pv\fR. ++.TP ++.B \-pvc + Run a file previewer and continually update the .dvi, .ps, and/or .pdf + files whenever changes are made to source files (see the Description + above). Which of these files is generated and which is viewed is +-governed by the other options, and is the same as for the \fB-pv\fR ++governed by the other options, and is the same as for the \fB\-pv\fR + option. +-This option also turns on the \fB-f\fR option, since it is normally +-desirable in preview-continuous-mode to continue working even if ++This option also turns on the \fB\-f\fR option, since it is normally ++desirable in preview\-continuous\-mode to continue working even if + errors are found. +-The preview-continuous option \fB-pvc\fR can only work with one file. ++The preview\-continuous option \fB\-pvc\fR 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 +-\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. + +-Important note: the acroread program on MS-Windows locks the pdf file, ++Important note: the acroread program on MS\-Windows locks the pdf file, + and prevents new versions being written, so it is a bad idea to use +-acroread to view pdf files in preview-continuous mode. It is better +-to use a dvi or ps viewer, as set by one of the \fB-view=dvi\fR and +-\fB-view=ps\fR options. ++acroread to view pdf files in preview\-continuous mode. It is better ++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 + "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.) +-.TP +-.B -pvc- +-Turn off \fB-pvc\fR. +-.TP +-.B -quiet +-Same as -silent +-.TP +-.B -r ++.TP ++.B \-pvc\- ++Turn off \fB\-pvc\fR. ++.TP ++.B \-quiet ++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. +-Thus an initialization file specified with the \fB-r\fR option can ++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. +-.TP +-.B -silent ++.TP ++.B \-silent + Run commands silently, i.e., with options that reduce the amount of + diagnostics generated. For example, with the default settings for +-commands under UNIX, the command "latex -interaction=batchmode" is used ++commands under UNIX, the command "latex \-interaction=batchmode" is used + for latex. + + Also reduce the number of informational messages that \fIlatexmk\fR + generates. +-.TP +-.B -v, -version ++.TP ++.B \-v, \-version + Print version number of \fILatexmk\fR. +-.TP +-.B -verbose +-Opposite of \fB-silent\fR. This is the default setting. +-.TP +-.B -view=default, -view=dvi, -view=ps, -view=pdf ++.TP ++.B \-verbose ++Opposite of \fB\-silent\fR. This is the default setting. ++.TP ++.B \-view=default, \-view=dvi, \-view=ps, \-view=pdf + Set the kind of file used when previewing is requested (e.g., by the +-\fB-pv\fR or \fB-pvc\fR switches). The default is to view the "highest" ++\fB\-pv\fR or \fB\-pvc\fR switches). The default is to view the "highest" + kind of requested file (in the order dvi, ps, pdf). +-.PP +-The preview-continuous option \fB-pvc\fR can only work with one file. ++.PP ++The preview\-continuous option \fB\-pvc\fR can only work with one file. + So in this case you will normally only specify one filename on + the command line. +-.PP +-Options \fB-p\fR, \fB-pv\fR and \fB-pvc\fR are mutually exclusive. So ++.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" ++.nf + .ta 2i + % \fBlatexmk thesis\fR \fI# run latex enough times to resolve +- cross-references\fR ++ cross\-references\fR + +-% \fBlatexmk -pvc -ps thesis\fR \fI# run latex enough times to resolve +- cross-references, make a postscript ++% \fBlatexmk \-pvc \-ps thesis\fR \fI# run latex enough times to resolve ++ cross\-references, make a postscript + file, start a previewer. Then + watch for changes in the source + file thesis.tex and any files it +@@ -443,55 +443,56 @@ + encounters an error, latexmk will + keep running. + +-% \fBlatexmk -c\fR \fI# remove .aux, .log, .bbl, .blg, .dep, ++% \fBlatexmk \-c\fR \fI# remove .aux, .log, .bbl, .blg, .dep, + .dvi, .pdf, .ps & .bbl files\fR +-.SH INITIALIZATION (RC) FILES +-.PP ++.SH "INITIALIZATION (RC) FILES" ++.PP + There are four initialization files ("RC files") that \fIlatexmk\fR can + read at startup: +-.PP ++.PP + 1) The system RC file, if it exists. + On a UNIX system, \fIlatexmk\fR searches for following places for its + system RC file, in the following order, and reads the first it finds: + "/opt/local/share/latexmk/LatexMk", + "/usr/local/share/latexmk/LatexMk", + "/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 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 + of the environment variable HOME. On UNIX and clones (including LINUX), + this variable +-is set by the system; on MS-Windows, the user may choose to set it. +-.PP ++is set by the system; on MS\-Windows, the user may choose to set it. ++.PP + 3) The RC file in the current working directory called "latexmkrc". +-.PP +-4) Any RC file(s) specified on the command line with the \fB-r\fR option. +-.PP ++.PP ++4) Any RC file(s) specified on the command line with the \fB\-r\fR option. ++.PP + Each RC file is a sequence of Perl commands. Usually it will be just a +-sequence of assignment statements that override the built-in settings of ++sequence of assignment statements that override the built\-in settings of + \fILatexmk\fR. Comment lines are introduced by the "#" character. + + Note that command line options are obeyed in the order in which + they are written; thus any RC file specified on the command line with +-the \fB-r\fR option can override previous options but can be itself ++the \fB\-r\fR option can override previous options but can be itself + overridden by later options on the command line. + +-.SH RC VARIABLES IN INITIALIZATION FILES +-.PP ++.SH "RC VARIABLES IN INITIALIZATION FILES" ++.PP + Many of the available variables that can be set are shown in the next + section. Syntax for the statements in an initialization file is of + the form: +-.PP ++.PP + $bibtex = 'bibtex'; +-.PP ++.PP + for the setting of a string variable, +-.PP ++.PP + $preview_mode = 1; +-.PP ++.PP + for the setting of a numeric variable, and +-.PP ++.PP + @default_files = ('paper', 'paper1'); +-.PP ++.PP + 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 @@ + + \fB"Detaching" a command\fR: If a command is to be run detached this + is indicated by preceding it with "start", as in +-.PP ++.PP + $dvi_previewer = 'start xdvi'; +-.PP ++.PP + This will be translated to whatever is appropriate for your operating + system. (Note: in some circumstances, \fIlatex\fR will always run a + command detached. This is the case for a previewer in preview + continuous mode, since otherwise previewing continuously makes no + sense.) + +-\fBCommand names containing spaces\fR: Under MS-Windows it is common ++\fBCommand names containing spaces\fR: Under MS\-Windows it is common + that the name of a command includes spaces, since software is often + installed in a subdirectory of "C:\Program Files". Such command names + should be enclosed in double quotes, as in + + $lpr_pdf = '"c:/Program Files/Ghostgum/gsview/gsview32.exe" /p'; + +-\fBUsing MS-Windows file associations\fR: A useful trick under modern +-versions of MS-Windows (e.g., WinXP) is to use just the command ++\fBUsing MS\-Windows file associations\fR: A useful trick under modern ++versions of MS\-Windows (e.g., WinXP) is to use just the command + 'start' by itself: +-.PP ++.PP + $dvi_previewer = 'start'; +-.PP +-Under recent versions of MS-Windows, this will cause to be run ++.PP ++Under recent versions of MS\-Windows, this will cause to be run + whatever program the system has associated with dvi files. (The same + applies for a postscript viewer and a pdf viewer.) + + \fBNot using a certain command\fR: If a command is not to be run, the + command name NONE is used, as in +-.PP ++.PP + $lpr = 'NONE lpr'; +-.PP ++.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 @@ + Suppose you want \fIlatexmk\fR to use latex with source specials + enabled. Then you might use the following line in an initialization + file: +-.PP +- $latex = 'latex --src-specials'; +-.PP ++.PP ++ $latex = 'latex \-\-src\-specials'; ++.PP + + \fBAdvanced tricks\fR: Normally \fIlatexmk\fR assumes certain behavior + for commands and in particular it assumes certain kinds and ordering +@@ -548,50 +549,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 +-.PP ++.PP + $ps2pdf = 'distiller'; ######### WRONG +-.PP ++.PP + because the command line arguments will be wrong. In such a +-situation, your best bet is to write a batch file (under MS-Windows) or ++situation, your best bet is to write a batch file (under MS\-Windows) or + a script (under UNIX) that will do the conversion. Then you set +-.PP ++.PP + $ps2pdf = 'special_script'; +-.PP ++.PP + Your script will be invoked by \fIlatexmk\fR in its usual way as + "Special_script file.ps file.pdf". Your script calls Distiller with + Distiller's correct arguments. + +-.SH LIST OF RC VARIABLES IN INITIALIZATION FILES +-.PP ++.SH "LIST OF RC VARIABLES IN INITIALIZATION FILES" ++.PP + Default values are indicated in brackets. +-.TP ++.TP + .B $banner [0] + If nonzero, the banner message is printed across each page when converting + the dvi file to postscript. Without modifying $banner_message, this is +-equivalent to specifying the \fB-d\fR option. ++equivalent to specifying the \fB\-d\fR option. + + Note that if \fB$banner\fR is nonzero, the \fB$postscript_mode\fR is + assumed and the postscript file is always generated, even if it is newer + than the dvi file. +-.TP ++.TP + .B $banner_intensity [0.95] +-Equivalent to the \fB-bi\fR option, this is a decimal number between 0 ++Equivalent to the \fB\-bi\fR option, this is a decimal number between 0 + and 1 that specifies how dark to print the banner message. 0 is black, + 1 is white. The default is just right if your toner cartridge isn't + running too low. +-.TP ++.TP + .B $banner_message ["DRAFT"] + The banner message to print across each page when converting the dvi +-file to postscript. This is equivalent to the \fB-bm\fR option. +-.TP ++file to postscript. This is equivalent to the \fB\-bm\fR option. ++.TP + .B $banner_scale [220.0] + 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. The Default is + just right for 5 character messages. This is equivalent to the +-\fB-bs\fR option. +-.TP ++\fB\-bs\fR option. ++.TP + .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 @@ + + This variable is likely to become obsolete in a future version of + \fIlatexmk\fR which uses a better method of searching for files. +-.TP ++.TP + .B $bibtex ["bibtex"] + The BibTeX processing program. +-.TP +-.B $bibtex_silent_switch ["-terse"] ++.TP ++.B $bibtex_silent_switch ["\-terse"] + \fBSwitch(es)\fR for the BibTeX processing program when silent mode is on. +-.TP ++.TP + .B $cleanup_mode [0] + 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.) + + 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 ++the \fB\-c\fR, \fB\-c1\fR, or \fB\-C\fR options. But there should be no need + to set this variable from an RC file. +-.TP ++.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. +-.TP ++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 ++Extra extensions of files for \fIlatexmk\fR to remove when the \fB\-C\fR + option is selected, i.e., extensions of files to remove when the .dvi, +-etc files are to be cleaned-up. +-.TP ++etc files are to be cleaned\-up. ++.TP + .B @cus_dep_list [()] +-Custom dependency list -- see section on "Custom Dependencies". +-.TP ++Custom dependency list \-\- see section on "Custom Dependencies". ++.TP + .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. +-.TP ++.TP + .B $dvi_filter [empty] + The dvi file filter to be run on the newly produced dvi file before +-other processing. Equivalent to specifying the \fB-dF\fR option. +-.TP ++other processing. Equivalent to specifying the \fB\-dF\fR option. ++.TP + .B $dvi_previewer ["start xdvi" under UNIX] +-The command to invoke a dvi-previewer. +-[Default is "start" under MS-WINDOWS; under more recent versions of ++The command to invoke a dvi\-previewer. ++[Default is "start" under MS\-WINDOWS; under more recent versions of + Windows, this will cause to be run whatever command the system has + associated with .dvi files.] +-.TP ++.TP + .B $dvi_previewer_landscape ["start xdvi"] +-The command to invoke a dvi-previewer in landscape mode. +-[Default is "start" under MS-WINDOWS; under more recent versions of ++The command to invoke a dvi\-previewer in landscape mode. ++[Default is "start" under MS\-WINDOWS; under more recent versions of + Windows, this will cause to be run whatever command the system has + associated with .dvi files.] +-.TP ++.TP + .B $dvipdf ["dvipdf"] + Command to convert dvi to pdf file. + + WARNING1: The default dvipdf + script generates pdf files with bitmapped fonts, which don't look + good when viewed by acroread. The script should be modified to give +-dvips the options "-P pdf" to ensure that type 1 fonts are used in the ++dvips the options "\-P pdf" to ensure that type 1 fonts are used in the + pdf file. + + WARNING 2: If you want to use one of the programs dvipdfm or dvipdfmx +@@ -700,24 +701,24 @@ + 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. +-.TP ++.TP + .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. +-.TP +-.B $dvips_landscape ["dvips -tlandscape"] ++$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 + in landscape mode. +-.TP +-.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 + 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. +-.TP +-.B $dvi_update_method [2 under UNIX, 1 under MS-Windows] ++.TP ++.B $dvi_update_method [2 under UNIX, 1 under MS\-Windows] + 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 @@ + 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.) +-.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 +-updated by sending a signal -- see $dvi_update_method. The default ++updated by sending a signal \-\- see $dvi_update_method. The default + 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. +-.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. +-.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. ++.TP + .B @generated_exts [( 'ind', 'lof', 'lot', 'out', 'toc')] + 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 @@ + + adds the extension 'end' to the list of predefined generated + extensions. +-.TP ++.TP + .B $go_mode [0] + If nonzero, process files regardless of timestamps. Equivalent to the +-\fB-g\fR option. +-.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 + latexmk determines automatically if \fImakeindex\fR needs to be run. +-.TP ++.TP + .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. ++.TP + .B $latex ["latex"] + The LaTeX processing program. Note that as with other programs, you + can use this variable not just to change the name of the program used, + but also specify options to the program. E.g., + +- $latex = 'latex --src-specials'; +-.TP +-.B $latex_silent_switch ["-interaction=batchmode"] ++ $latex = 'latex \-\-src\-specials'; ++.TP ++.B $latex_silent_switch ["\-interaction=batchmode"] + \fBSwitch(es)\fR 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 ++Under MS\-Windows, the default value is changed to ++"\-interaction=batchmode \-c\-style\-errors", as used by MikTeX and fpTeX. ++.TP + .B $lpr ["lpr"] +-[Default is "NONE lpr" under MS-WINDOWS.] ++[Default is "NONE lpr" under MS\-WINDOWS.] + The printing program 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. + +-.TP ++.TP + .B $lpr_dvi ["NONE lpr_dvi"] + The printing program to print dvi files. +-.TP ++.TP + .B $lpr_pdf ["NONE lpr_pdf"] + The printing program to print pdf files. + +-Under MS-Windows you could set this to use gsview, if it is installed, ++Under MS\-Windows you could set this to use gsview, if it is installed, + e.g., + + $lpr = '"c:/Program Files/Ghostgum/gsview/gsview32.exe" /p'; +@@ -839,18 +840,18 @@ + is necessary because one part of the command name ('Program Files') + contains a space which would otherwise be misinterpreted. + +-.TP ++.TP + .B $makeindex ["makeindex"] + The index processing program. +-.TP ++.TP + .B $new_viewer_always [0] + This variable applies to \fIlatexmk\fR \fBonly\fR in +-continuous-preview mode. If $new_viewer_always is 0, ++continuous\-preview mode. If $new_viewer_always is 0, + \fIlatexmk\fR will check for a previously running previewer on the + same file, and if one is running will not start a new one. If +-$new_viewer_always is non-zero, this check will be skipped, and ++$new_viewer_always is non\-zero, this check will be skipped, and + \fIlatexmk\fR will behave as if no viewer is running. +-.TP ++.TP + .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 @@ + 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. +-.TP ++.TP + .B $pdflatex ["pdflatex"] + The LaTeX processing program in the version that makes a pdf file instead + of a dvi file. +-.TP +-.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. +-Under MS-Windows, the default value is changed to +-"-interaction=batchmode -c-style-errors", as used by MikTeX and fpTeX. +-.TP ++Under MS\-Windows, the default value is changed to ++"\-interaction=batchmode \-c\-style\-errors", as used by MikTeX and fpTeX. ++.TP + .B $pdf_previewer ["start acroread"] +-The command to invoke a pdf-previewer. +-[Default is changed to "start" on MS-WINDOWS; under more recent versions of ++The command to invoke a pdf\-previewer. ++[Default is changed to "start" on MS\-WINDOWS; under more recent versions of + Windows, this will cause to be run whatever command the system has + associated with .pdf files.] + +-Potential problem under MS-Windows: ++Potential problem under MS\-Windows: + if acroread is used as the pdf previewer, and it is + actually viewing a pdf file, the pdf file cannot be updated. Thus + makes acroread a bad choice of previewer if you use \fIlatexmk\fR's +-previous-continuous mode (option \fB-pvc\fR) under MS-windows. ++previous\-continuous mode (option \fB\-pvc\fR) under MS\-windows. + This problem does not occur if ghostview, gv or gsview is used to + view pdf files. +-.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. +-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. +-.TP +-.B $pdf_update_signal [Under UNIX: SIGHUP, which is a system-dependent value] ++.TP ++.B $pdf_update_signal [Under UNIX: SIGHUP, which is a system\-dependent value] + The number of the signal that is sent to the pdf viewer when it is +-updated by sending a signal -- see $pdf_update_method. The default ++updated by sending a signal \-\- see $pdf_update_method. The default + value is the one appropriate for gv on a UNIX system. +-.TP +-.B $pid_position = [1 under UNIX, -1 under MS-Windows] ++.TP ++.B $pid_position = [1 under UNIX, \-1 under MS\-Windows] + Command used to get all the processes currently run by the user. +-The -pvc option uses the command specified by the variable $pscmd to ++The \-pvc option uses the command specified by the variable $pscmd to + determine if there is an already running previewer, and to find the + process ID (needed if \fIlatexmk\fR needs to signal the previewer about + file changes). The variable $pid_position is used to specify which word + in lines of the output from $pscmd corresponds to the process ID. The + first word in the line is numbered 0. The default value of 1 (2nd word in +-line) is correct for Solaris 2.6 and Linux. Setting the variable to -1 is ++line) is correct for Solaris 2.6 and Linux. Setting the variable to \-1 is + used to indicate that $pscmd is not to be used. +-.TP ++.TP + .B $postscript_mode [0] + If nonzero, generate a postscript version of the document. +-Equivalent to the \fB-ps\fR option. +-.TP ++Equivalent to the \fB\-ps\fR option. ++.TP + .B $preview_continuous_mode [0] + If nonzero, run a previewer to view the document, and +-continue running \fIlatexmk\fR to keep .dvi up-to-date. Equivalent to +-the \fB-pvc\fR option. ++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. +-.TP ++line options $\fB\-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. +-.TP ++line options $\fB\-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. +-.TP ++.TP + .B $print_type = ["ps"] + Type of file to printout: possibilities are "dvi", "none", "pdf", or + "ps". +-.TP ++.TP + .B $pscmd +-[On UNIX, the default is "ps -f -u $ENV{USER}", with changes for Linux +-and OS-X. +-On MS-WINDOWS the default in "NONE pscmd".] ++[On UNIX, the default is "ps \-f \-u $ENV{USER}", with changes for Linux ++and OS\-X. ++On MS\-WINDOWS the default in "NONE pscmd".] + Command used to get all the processes currently run by the user. This +-is used by the -pvc option to determine if there is an already running ++is used by the \-pvc option to determine if there is an already running + 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. + + NOTE: The variable $pid_position must also be set: see its description. +-.TP ++.TP + .B $ps2pdf ["ps2pdf"] + Command to convert ps to pdf file. +-.TP ++.TP + .B $ps_filter [empty] + The postscript file filter to be run on the newly produced postscript +-file before other processing. Equivalent to specifying the \fB-pF\fR ++file before other processing. Equivalent to specifying the \fB\-pF\fR + option. +-.TP +-.B $ps_previewer ["start gv -watch"] +-The command to invoke a ps-previewer. +-[Default is "start" on MS-WINDOWS; under more recent versions of ++.TP ++.B $ps_previewer ["start gv \-watch"] ++The command to invoke a ps\-previewer. ++[Default is "start" on MS\-WINDOWS; under more recent versions of + Windows, this will cause to be run whatever command the system has + associated with .ps files.] + +-Note that gv with the -watch option updates its display whenever the ++Note that gv with the \-watch option updates its display whenever the + postscript file changes, whereas ghostview does not. +-.TP +-.B $ps_previewer_landscape ["start gv -swap -watch"] +-The command to invoke a ps-previewer in landscape mode. +-[Default is "start" on MS-WINDOWS; under more recent versions of ++.TP ++.B $ps_previewer_landscape ["start gv \-swap \-watch"] ++The command to invoke a ps\-previewer in landscape mode. ++[Default is "start" on MS\-WINDOWS; under more recent versions of + Windows, this will cause to be run whatever command the system has + associated with .ps files.] +-.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. +-.TP +-.B $ps_update_signal [Under UNIX: SIGHUP, which is a system-dependent value] ++.TP ++.B $ps_update_signal [Under UNIX: SIGHUP, which is a system\-dependent value] + The number of the signal that is sent to the pdf viewer when it is +-updated by sending a signal -- see $ps_update_method. The default ++updated by sending a signal \-\- see $ps_update_method. The default + value is the one appropriate for gv on a UNIX system. +-.TP ++.TP + .B $sleep_time [2] + The time to sleep (in seconds) between checking for source file +-changes when running the \fB-pvc\fR option. +-.TP ++changes when running the \fB\-pvc\fR option. ++.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. + + 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 + 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. +-.SH CUSTOM DEPENDENCIES +-.PP ++.SH "CUSTOM DEPENDENCIES" ++.PP + In any RC file a set of custom dependencies can be set up to convert a + file with one extension to a file with another. An example use of this +-would be to allow \fIlatexmk\fR to convert a \fI.fig\fR file to ++would be to allow \fIlatexmk\fR to convert a \fI.fi g\fR file to + \fI.eps\fR to be included in the \fI.tex\fR file. A table of custom + dependencies are set up by using the \fB@cus_dep_list\fR array. Each + string in the array has four arguments, separated by a space: +-.TP ++.TP + .B from extension: + The extension of the file we are converting from (e.g. "fig"). +-.TP ++.TP + .B to extension: + The extension of the file we are converting to (e.g. "eps"). +-.TP ++.TP + .B must: +-If non-zero, the file we are converting from \fBmust\fR exist, if it ++If non\-zero, the file we are converting from \fBmust\fR exist, if it + doesn't exist \fIlatexmk\fR will give an error message and exit unless +-the \fB-f\fR option is specified. If \fImust\fR is zero and the file ++the \fB\-f\fR option is specified. If \fImust\fR is zero and the file + we are converting from doesn't exist, then no action is taken. +-.TP ++.TP + .B function: + The name of the subroutine that \fIlatexmk\fR should call to perform the + file conversion. The first argument to the subroutine is the base name + of the file to be converted without any extension. The subroutines are + declared in the syntax of \fIperl\fR. The function should return 0 if + it was successful and a nonzero number if it failed. +-.PP +-Example in an RC file to convert a \fI.fig\fR file to a \fI.eps\fR file: ++.PP ++Example in an RC file to convert a \fI.fi g\fR file to a \fI.eps\fR file: + + @cus_dep_list = (@cus_dep_list, "fig eps 0 fig2eps"); + + sub fig2eps + { +- system("fig2dev -Lps $_[0].fig $_[0].eps"); ++ system("fig2dev \-Lps $_[0].fi g $_[0].eps"); + } + +-The subroutine \fIfig2eps\fR will only be called if the \fI.fig\fR file ++The subroutine \fIfig2eps\fR will only be called if the \fI.fi g\fR file + was modified more recently then the \fI.eps\fR file, or the \fI.eps\fR + file does not exist. + +-If the return value of the subroutine is non-zero, then \fIlatexmk\fR ++If the return value of the subroutine is non\-zero, then \fIlatexmk\fR + will assume an error occurred during the execution of the subroutine. + +-.SH SEE ALSO ++.SH "SEE ALSO" + latex(1), bibtex(1). +-.SH BUGS ++.SH "BUGS" + 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 @@ + Gv on UNIX/LINUX works for both postscript and pdf. + Ghostview on UNIX/LINUX needs a manual update (reopen); it views + postscript and pdf. +-Gsview under MS-Windows works for both postscript and pdf, ++Gsview under MS\-Windows works for both postscript and pdf, + but only reads the updated file when its screen is refreshed. + Acroread under UNIX/LINUX views pdf, but the file needs to be closed + and reopened to view an updated version. +-Under MS-Windows, acroread locks its input file and so the ++Under MS\-Windows, acroread locks its input file and so the + pdf file cannot be updated. (Remedy: configure \fIlatexmk\fR use gsview + instead.) +-.SH THANKS TO ++.SH "THANKS TO" + David Coppit (username david at node coppit.org) 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 + harvested by worms and viruses.) +-.SH AUTHOR ++.SH "AUTHOR" + Current version, with substantial modifications, enhancements and bug + fixes by John Collins (username collins at node phys.psu.edu). + (Version 3.08g). + + It can be obtained from CTAN: +-, and from the ++, and from the + author's website . +-.br ++.br + Modifications and enhancements by Evan McLean (Version 2.0) +-.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 @@ + ## /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. +- @rc_system_files = +- ( '/opt/local/share/latexmk/LatexMk', +- '/usr/local/share/latexmk/LatexMk', +- '/usr/local/lib/latexmk/LatexMk' ); ++ ## Fedora Core 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 new file mode 100644 index 0000000..37b0fe3 --- /dev/null +++ b/latexmk-perl.patch @@ -0,0 +1,26 @@ +--- latexmk.pl.ORIG 2007-02-20 10:19:23.000000000 -0700 ++++ latexmk.pl 2007-02-20 10:22:18.000000000 -0700 +@@ -1,23 +1,4 @@ +-eval '(exit $?0)' && eval 'exec perl -x -S "$0" ${1+"$@"}' && +-eval 'exec perl -x -S "$0" $argv:q' +-if 0; + #!/usr/bin/perl -w +-#!/opt/local/bin/perl -w +-#!/usr/local/bin/perl -w +-# The above code allows this script to be run under UNIX/LINUX without +-# the need to adjust the path to the perl program in a "shebang" line. +-# (The location of perl changes between different installations, and +-# may even be different when several computers running different +-# flavors of UNIX/LINUX share a copy of latex or other scripts.) The +-# script is started under the default command interpreter sh, and the +-# evals in the first two lines restart the script under perl, and work +-# under various flavors of sh. The -x switch tells perl to start the +-# script at the first #! line containing "perl". The "if 0;" on the +-# 3rd line converts the first two lines into a valid perl statement +-# that does nothing. +-# +-# Source of the above: manpage for perlrun +- + + # ATTEMPT TO ALLOW FILENAMES WITH SPACES: + # (as of 1 Apr 2006) diff --git a/latexmk.conf b/latexmk.conf new file mode 100644 index 0000000..b451fcb --- /dev/null +++ b/latexmk.conf @@ -0,0 +1,213 @@ +# This is the system-wide configuration file for latexmk. +# See the latexmk(1) man page for more information. +# +# The following options are given their default values. +# Uncomment them and change the values if the defaults do not suit your needs. + +# If nonzero, DVI-to-postscript conversion adds a banner message on each page +# $banner = 0; + +# The darkness of the banner, a number between 0 (black) and 1 (white) +# $banner_intensity = 0.95; + +# The banner message to print across each page if $banner is nonzero +# $banner_message = 'DRAFT'; + +# The size of the banner message (about 1100 divided by the message length) +# $banner_scale = 220.0; + +# An array of directory names where BibTeX should look for .bib files. +# @BIBINPUTS = $ENV('BIBINPUTS') converted to an array of strings + +# The name of the BibTeX executable +# $bibtex = 'bibtex'; + +# The switch that puts BibTeX in silent mode +# $bibtex_silent_switch = '-terse'; + +# How much cleaning to do: 0 specifies normal operation (no cleaning), +# 1 specifies a full cleanup, 2 specifies a cleanup that leaves DVI, +# PostScript, and PDF files, and 3 specifies a cleanup that also leaves dep +# and aux files. You probably should not set this option. +# $cleanup_mode = 0; + +# Extra file extensions to remove when cleaning +# $clean_ext = ""; + +# Extra file extensions to remove when doing a full clean +# $clean_full_ext = ""; + +# A custom dependency list; see the man page for details +# @cus_dep_list = (); + +# The default list of files to be processed; see the man page for details +# @default_files = ('*.tex'); + +# The DVI file filter to be run on newly produced DVI files +# $dvi_filter = ''; + +# The command to start a DVI previewer +# $dvi_previewer = 'start xdvi'; +$dvi_previewer = 'xdg-open'; + +# The command to start a DVI previewer in landscape mode +# $dvi_previewer_landscape = 'start xdvi -paper usr'; +$dvi_previewer_landscape = 'xdg-open'; + +# The command to convert a DVI file into a PDF file. +# See the warnings on the man page +# $dvipdf = 'dvipdf'; + +# The command to convert a DVI file into a PostScript file +# $dvips = 'dvips'; + +# The command to convert a DVI file into a PostScript file in landscape mode +# $dvips = 'dvips -tlandscape'; + +# Command line switch for dvips when a PDF file is to be generated +# $dvips_pdf_switch = '-P pdf'; + +# Command line switch for dvips to make it run in silent mode +# $dvips_silent_switch = '-q'; + +# 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) + +# If nonzero, the dependency file is always generated +# $force_generate_and_save_includes = 0; + +# If nonzero, continue processing past minor LaTeX errors +# This option is made nonzero if the -pvs command line option is used. +# $force_mode = 0; + +# If nonzero, force latexmk to include files that don't exist when generating +# 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' ); + +# 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; + +# If nonzero, run in landscape mode +# $landscape_mode = 0; + +# The name of the LaTeX program +# $latex = 'latex'; + +# The command line switch to make LaTeX run in silent mode +# $latex_silent_switch = '-interaction=batchmode'; + +# The program that prints PostScript files +# $lpr = 'lpr'; + +# The program that prints DVI files +# $lpr_dvi = 'NONE $lpr_dvi variable is not configured to allow printing of dvi files'; + +# The program that prints PDF files +# $lpr_pdf = 'NONE $lpr_pdf variable is not configured to allow printing of pdf files'; + +# The name of the makeindex program +# $makeindex = 'makeindex'; + +# The command line switch to make makeindex run in silent mode +# $makeindex_silent_switch = '-q'; + +# This variable is used only when running in continuous-preview mode. If zero, +# check for a previously running previewer on the same file and update it. If +# nonzero, always start a new previewer. +# $new_viewer_always = 0; + +# If zero, generate a DVI file. If 1, generate a PDF file using pdflatex. +# If 2, generate a PostScript file, then convert it using ps2pdf. +# If 3, generate a DVI file, then convert it using dvipdf. +# $pdf_mode = 0; + +# The name of the LaTeX program that produces PDF files by default +# $pdflatex = 'pdflatex'; + +# The command line switch to make pdflatex run in silent mode +# $pdflatex_silent_switch = '-interaction=batchmode'; + +# The command to invoke a PDF previewer +# $pdf_previewer = 'start acroread'; +$pdf_previewer = 'xdg-open'; + +# 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) + +# Where the pid is in the output of $pscmd; see the man page +# $pid_position = 1; + +# If zero, generate a DVI file. If nonzero, generate a PostScript file +# $postscript_mode = 0; + +# If nonzero, run a previewer to view the document and keep the DVI file up +# to date +# $preview_continuous_mode = 0; + +# If nonzero, run a previewer to preview the document +# $preview_mode = 0; + +# If nonzero, print the document using lpr each time it is created +# $printout_mode = 0; + +# The type of file to printout: 'dvi', 'none', 'pdf', or 'ps' +# $print_type = 'ps'; + +# Command used to list all the processes currently run by the user +# $pscmd = "ps --width 200 -f -u $ENV{USER}"; + +# Command to convert a PostScript file to a PDF file +# $ps2pdf = 'ps2pdf'; + +# Filter to run on newly created PostScript files +# $ps_filter = ''; + +# The command to invoke a PostScript previewer +# $ps_previewer = 'start gv -watch'; +$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'; + +# How to make the PostScript viewer update its display when the PostScript +# file changes. See the man page for a description of each method. +# $ps_update_method = 0; +$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) + +# The time to sleep in seconds between checking for source file changes when +# running in continuous update mode +# $sleep_time = 2; + +# The directory to store temporary files; omit the trailing '/' +# $tmpdir = '/tmp'; diff --git a/latexmk.spec b/latexmk.spec new file mode 100644 index 0000000..ddaa061 --- /dev/null +++ b/latexmk.spec @@ -0,0 +1,82 @@ +Name: latexmk +Version: 3.08n +Release: 4%{?dist} +Summary: A make-like utility for LaTeX files + +Group: Applications/Publishing +License: GPL +URL: http://www.phys.psu.edu/~collins/software/latexmk-jcc/ +Source0: http://www.phys.psu.edu/~collins/software/latexmk-jcc/latexmk-308n.zip +Source1: latexmk.conf +Source2: latexmk-README.fedora +Patch0: latexmk-perl.patch +Patch1: latexmk-conf.patch +BuildRoot: %{_tmppath}/%{name}-%{version}-%{release}-root-%(%{__id_u} -n) +BuildArch: noarch + +# FC6 and earlier use tetex, FC7 and later use texlive, so require the binaries +Requires: /usr/bin/latex, /usr/bin/bibtex, /usr/bin/makeindex +Requires: ghostscript, xdg-utils + +%description +Latexmk is a perl script for running LaTeX the correct number of times to +resolve cross references, etc.; it also runs auxiliary programs (bibtex, +makeindex if necessary, and dvips and/or a previewer as requested). It has +a number of other useful capabilities, for example to start a previewer and +then run latex whenever the source files are updated, so that the previewer +gives an up-to-date view of the document. The script runs on both UNIX and +MS-WINDOWS (95, ME, XP, etc). This script is a corrected and improved +version of the original version of latexmk. + +Before using a previewer, read the file README.fedora. + +%prep +%setup -q -c +cp %{SOURCE2} README.fedora + +# Remove the path searching facility; we know where the perl binary is located +%patch0 + +# Change the system-wide configuration file to /etc/latexmk.conf and fix +# 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 +rm -rf $RPM_BUILD_ROOT +mkdir -p $RPM_BUILD_ROOT%{_bindir} +mkdir -p $RPM_BUILD_ROOT%{_mandir}/man1 +mkdir -p $RPM_BUILD_ROOT%{_sysconfdir} +install -m 0755 -p latexmk.pl $RPM_BUILD_ROOT%{_bindir}/latexmk +install -m 0644 -p latexmk.1 $RPM_BUILD_ROOT%{_mandir}/man1 +install -m 0644 -p %{SOURCE1} $RPM_BUILD_ROOT%{_sysconfdir} + +%clean +rm -rf $RPM_BUILD_ROOT + +%files +%defattr(-,root,root,-) +%{_bindir}/* +%{_mandir}/man1/* +%config(noreplace) %{_sysconfdir}/latexmk.conf +%doc CHANGES COPYING INSTALL README README.fedora extra-scripts + +%changelog +* Tue Mar 27 2007 Jerry James - 3.08n-4 +- Avoid tetex vs. texlive issues by Requiring the binaries. + +* Tue Mar 20 2007 Jerry James - 3.08n-3 +- Use xdg-open for the DVI and PostScript previewers also. +- Describe previewer configuration in README.fedora. + +* Mon Mar 19 2007 Jerry James - 3.08n-2 +- Use xdg-open instead of explicitly invoking evince. +- Package the extra-scripts directory as documentation. +- Fix a few other packaging infelicities as pointed out in Extras review. + +* Tue Feb 27 2007 Jerry James - 3.08n-1 +- Initial RPM diff --git a/sources b/sources index e69de29..bf0c8bd 100644 --- a/sources +++ b/sources @@ -0,0 +1 @@ +0849be9d5aabe03e6de7159c8d10a191 latexmk-308n.zip