Latexmk: current and previous versions

• V. 4.57 dated 21 June 2018.
  1. Correct problem that in calculation of md5 checksum, an error sometimes occurs about malformed utf8 characters. This can happen if the environment variable PERL_UNICODE is set.
  2. Add configuration variable $bibtex_fudge to allow to choose whether to use the fudge that made bibtex run correctly when an output directory (or aux directory) is specified. (A planned future version of bibtex in TeXLive will not need the fudge.)
• V. 4.56 dated 25 May 2018.
  1. Update example latexmrc file for pythontex.
  2. Better error message when .bib file(s) not found.
  3. Better handling and diagnostics when names of expected and actual names of .log disagree.
  4. In particular, some automatic reconfiguration when .log file is not in expected place (e.g., because $aux_dir is different to $out_dir, but TeXLive is used, so -aux-directory option for TeX engines isn't supported).
  5. Fix problem of .bib files sometimes not being found by bibtex when latexmk runs under msys and -outputdirectory is specified.
  6. Add use of environment variable LATEXMKRCSYS to specify system rc file.
  This version is on CTAN at http://www.ctan.org/pkg/latexmk/.
• V. 4.55d dated 16 March 2018.
  1. Correct parsing of biber's log file.
  2. Implement $warning_cmd
  3. Deal with problem that in the fls file the names of INPUT and OUTPUT files sometimes correspond to non-existent files. Latexmk no longer considers these as true dependencies. This situation can happen because of a bug in the TeX engine (e.g., lualatex in TeXLive 2017) or because the files are temporary files created and deleted during a run (e.g., by the minted package). (This is the third version of this fix, now without a sometimes misleading warning message.)
• V. 4.55a dated 25 January 2018.
  1. Add option that latexmk returns a non-zero status code when the final run of (pdf)latex gives warnings about undefined references or citations or about multiply defined references.
  2. Implement $warning_cmd to allow a visual cue for these situations in pvc mode (in addition to the current possibilities for $compiling_cmd, $success_cmd and $failure_cmd).
• V. 4.55 dated 17 January 2018.
  1. Correct bug that some variables wern't defined under msys.
  2. Compensate for problems caused by time offset between system time on system running latexmk and file times on remote file system. (These caused trouble for documents that both are compiled under MiKTeX and use biber.)
  3. Allow optional timeout in pvc mode after a period of inactivity. (See documentation for -pvctimeout option.)
  4. V. 4.54c dated 12 December 2017.
     1. Fix for problem that latexmk v 4.54 failed for users with old Perl installations. (They got an error that bsd_glob couldn't be imported.)
  5. V. 4.54 dated 20 November 2017.
     1. In deps_list, correct bug in identifying generated files. Otherwise, generated files could have been identified as true source files.
     2. Remove insertion of name of deps file in list of targets in deps file.
     3. Don't send to screen deps info in deps mode (unless diagnostics on).
     4. Correct ordering of list of options given by -help.
     5. Fix incorrect deletion of non-generated aux files.
     6. Optimize away current directory string in $out_dir and $aux_dir.
     7. Make latexmk compatible with future versions of Perl where File::Glob's glob function won't exist.
     8. Add extra value 1.5 for $bibtex_use, with corresponding option -bibtex-cond1; this treats bbl files as conditionally precious in cleanup operations, depending on the existence or non-exisitence of bib files.
     9. When running bibtex, ensure that the change in search paths is made to work around deficiencies in bibtex is local and does not affect other programs.
     10. Collection of timing information now works in silent mode.
     11. Set better default previewers for MSys.
     12. Restore default of $analyze_input_log_always to 1. This restores the default detection of certain constructs for dependencies for input files in the .log file. See the comments on this variable in latexmk.pl for details. This works around a problem caused by a change in the behavior of lualatex in TeXLive 2017; it no longer lists all input files in the .fls file. Note that latexmk.pl always examines the .log file for relevant information. The variable $analyze_input_log_always only concerns whether it looks for <...> and (...) constructs.
     13. Add item to @file_not_found for the particular format of generic package warning about "No file", that is produced by glossaries-extra, and probably other packages.
     14. Documentation improvements, especially on methods of implementing custom dependencies for multiple kinds of index.
     15. Document $kpsewhich_show variable.
     16. Add a sample latexmkrc file for use with bib2gls and glossaries-extra.
     (Sorry, there are still some requested/planned changes that I haven't yet made.)
  6. V. 4.53a dated 16 May 2017.
     1. Document $kpsewhich_show variable.
     2. In deps_list, correct bug in identifying generated files. Otherwise, generated files could have been identified as true source files.
     3. Correct ordering of list of options given by -help.
     4. Fix incorrect deletion of non-generated aux files.
     5. Optimize away current directory string in $out_dir and $aux_dir.
  7. V. 4.52c dated 19 January 2017.
     1. When the -pdflua or -pdfxe option is used, the -jobname option now works.
  8. V. 4.52b dated 17 January 2017.
     1. For xelatex, detection that graphics file is missing and can be made by a custom dependency now works just it does for other latex engines.
     2. Optimize number of calls to kpsewhich. This often gives a considerable savings of run time when a document includes many graphics files that are in a texmf tree.
     3. Fix bug that if an .aux file is deleted and latexmk is run, the wrong number of runs of (pdf)latex is made.
     4. Fix related problem that latexmk sometimes does too few runs of (pdf)latex because of the incorrect detection that a file is only read after being written.
     5. Implement direct support for xelatex and lualatex. Previously these programs were used by configuring the $pdflatex so that the desired program is run instead of pdflatex. There are now configuration variables $xelatex and $lualatex to specify the commands used, and extra command line options -pdfxe and -pdflua.
     6. In the case of xelatex, considerable improvement in run time is given for documents containing large graphics files. This is because compilation is made first to an xdv file instead of direct to a pdf file. Only when this file is finalized is a single conversion to a pdf file made. (This last step can be especially time-consuming for documents that bring in large graphics files.)
     7. Update documentation.
     8. Work around LuaTeX line-wrapping bug.
     9. Minor improvements in code and diagnostics.
     10. (Fix bug introduced in initial release, as 4.52, that use of bibtex wasn't always detected when recorder mode is on. The detection now appears to be correct.)
  9. V. 4.48 dated 5 September 2016.
     1. Correct creation of output and aux directories to correctly handle relative paths when -cd is used.
     2. Add routines rdb_list_source, rdb_set_source for manipulating dependency lists of a rule. Add these to the documentated interface, in addition to the already documented rdb_ensure_file, rdb_remove_files.
     3. Correct documention: default value of $recorder is 1.
     4. Update webpages in documentation.
  10. V. 4.45 dated 22 April 2016.
      1. Fix problem of -C not always working correctly when compilation was with -pdf and clear was default.
      2. Fix bug in limiting number of passes when $max_repeat >= 10
      3. Fix bug in finding id of viewer process id under OS-X
  11. V. 4.44 dated 24 February 2016.
      1. Correct error handling when biber finds a malformed bcf file. (Previously latexmk didn't automatically recover from error situation after the source files had been corrected.)
      2. Correct bug in use of %hash_calc_ignore_pattern (Previously it only had its documented effect when a targetted file hadn't changed in size.)
  12. V. 4.43a dated 5 February 2015.
      1. On cleanup, synctex.gz files are deleted only by -C, not by -c.
  13. V. 4.43 dated 26 January 2015.
      1. Fix problem that source files are not correctly detected under MiKTeX when name of current working directory contains non-ASCII characters.
  14. V. 4.42 dated 10 January 2015.
      1. Fix bugs associated with the -cd option
      2. Add missfont.log and the generated synctex.gz to standard cleaned-up files
  15. V. 4.41 dated 1 January 2015.
      1. -c also deletes $deps_file if it is used.
      2. When -jobname option is used, quote it on command line.
      3. Change maintainer's preferred e-mail.
      4. Attempt to improve handling of errors from (pdf)latex.
      5. Fix up for the making of -eps-converted-to.pdf
      6. Improve listing of warning lines from log file.
      7. Fix failure when using both -cd and -output-directory
      8. If user's home directory can't be determined, then don't read ~/.latexmkrc
      9. Introduce configuration variable $silence_logfile_warnings
      10. In setting $pscmd, allow for non-existent environment variable USER
      11. System initialization files: allow them to be named latexmkrc as well as LatexMk, for more consistency with user directory names.
      12. Miscellaneous corrections.
  16. V. 4.40 dated 15 January 2014.
      
      1. Fix failure to clean up correctly when root filename contains certain special characters in it (notably '['). [Technical issue: these characters had special meaning when previously interpreted as metacharacters in a glob operation.]
  17. V. 4.39 dated 10 November 2013, with documentation update on 3 December 2013.
      
      1. Automatic creation of necessary subdirectories of auxdir when needed for writing aux files.
      2. Add error diagnostics to if_source
      3. Allow $print_type = 'auto', and make this the default, so that when the -p option to latexmk is used to print the file, the default is to determine the type of file to be printed, rather than always requiring postscript.
      4. Fix the failures when dealing with directories whose names contained certain special characters in them (notably '[', ']' and space). [Technical issue: these characters had special meaning when previously interpreted as metacharacters in a glob operation.] This gives dependency on Perl's File::Glob module, which is a standard module in normal installations of Perl.
      5. When an output directory is a subdirectory of a directory, ensure that it is correctly created, if it has to be created. Previously, the creation of the output directory when it does not exist only worked for one level. This gives dependency on Perl's File::Path module with v. >= 2.08, which is a standard module in normal installations of Perl.
      6. In output of dependencies, include pathname of target file(s) in the rule.
      7. In -pvc mode, writing of deps file (caused by the -M and related options) is per make not per overall run.
  18. V. 4.37 dated 2 July 2013.
      
      1. Correct failure that happens when name of current directory contains characters with special meaning in regular expression.
      2. -rules option now works with -pvc
      3. Add -lualatex option, like -xelatex.
      4. File specifications in $clean_ext and $clean_full_ext are allowed to contain wildcards.
      5. Warning is given when rc file is a directory instead of a file.
      6. Correct bug that if revtex4-1.cls is used, footnotes are set to be in the bibliography, and latexmk's aux_dir or out_dir is set, then latexmk fails to run bibtex when needed, because the relevant bib file is not found.
      7. Other minor corrections and code improvements.
      8. Documentation updates and corrections.
  19. V. 4.35 dated 11 November 2012.
      
      1. Corrects bug that fls file is incorrectly parsed when using a combination of cygwin and a native MS-Windows TeX program.
      2. Corrects bug that old dependency information was retained when using the --gg option.
  20. V. 4.34 dated 1 October 2012.
      
      1. Corrects non-optimality that latexmk may do extra runs of (pdf)latex when a file is read and written during a run of (pdf)latex, but the file is only read after being written.
  21. V. 4.33c dated 19 August 2012.
      
      1. Corrects infinite loop in error messages when the maximum number of passes through latex/pdflatex is exceeded.
  22. V. 4.33b dated 12 August 2012.
      
      1. Documentation improvements, including documentation of the many options for the (pdf)latex programs that are supported by latexmk.
  23. V. 4.33a dated 8 August 2012.
      
      1. Fix slowness of v. 4.33 under Cygwin.
  24. V. 4.33 dated 6 August 2012.
      
      1. Improve operation under MSWindows: substitute "\" for "/" for directory separator in command lines, deal consistently with directory separator, which can be both "\" and "/".
      2. Correct some bugs that interfered with use of auxiliary directory and output directory for files generated by (pdf)latex, especially with MiKTeX.
      3. Fix problems caused because in the log and fls files MiKTeX writes absolute path for many filenames at and below current directory, and is inconsistent in its use of "/" vs. "\" as directory separator.
      4. Add $dvipdf_silent_switch configuration variable.
      5. Improve handling of errors in (pdf)latex; previously latexmk would give up processing in some situations continuing is correct.
      6. Documentation corrections/improvements.
      7. Reduce number of warnings in silent operation.
  25. V. 4.31 dated 30 March 2012.
      
      1. Implement most options allowed by latex and pdflatex.
      2. Add -M -MP and -MF options, like gcc.
      3. Recorder option is now on by default.
      4. Add -latexoption=... option to latexmk.
      5. Add -xelatex option for use of xelatex.
      6. Change OS-X default for pdf previewer command to open.
      7. Command specification string can start with "include routine" to invoke a Perl subroutine instead of an external cmd.
      8. Viewers are detached by default. (The start keyword is now normally superfluous in command specifications.)
      9. Keyword nostart added in command specification.
      10. Add configuration variables $compiling_cmd, $success_cmd, $failure_cmd. These specify external commands (if any) to be executed during latexmk's continuous preview mode at the following points: $compiling_cmd at the start of compilation, $success_cmd at the end of a successful compilation, and $failure_cmd at the end of an unsuccessful compilation. They can be used, for example, to show the progress of compilation by setting the titles of editor and/or previewer windows.
      11. If aux and/or output directories are specified but don't exist, make them.
      12. Remove excessive repetition of tests for changes of source files (improves performance of latexmk in some situations).
      13. Documentation improvements.
      14. Minor bug corrections.
  26. V. 4.30a dated 9 December 2011.
      
      1. Fix use of bibtex so that it works correctly when $aux_dir and/or $out_dir are set.
      2. Use OS-dependent search path separator when when manipulating TEXINPUTS, etc. Then use of -output-directory and -aux-directory options should work correctly on MSWin systems.
      3. Documentation of $search_path_separator variable.
      4. Correct some bugs in v. 4.30 that manifested themselves under MSWin especially with Cygwin.
  27. V. 4.29a dated 7 December 2011.
      
      1. Latexmk now works with the feynmp package and mpost, provided a suitable custom dependency is defined. (See the example latexmkrc fragment mpost_latexmkrc in the example_rcfiles directory in the latexmk distribution.)
      2. If output directory is set, arrange that dvips can find files there.
      3. In searching for cus-deps that can make a missing file, look in $out_dir.
  28. V. 4.28c dated 1 December 2011.
      
      1. When biber doesn't find the bib file, latexmk treats this as a warning rather than a fatal error, so further processing can continue normally.
      2. Latexmk now parses correctly error messages from biber v. 0.9.7.
  29. V. 4.28a dated 28 November 2011.
      
      1. Correct handling of situations where some file(s) needed by bibtex (or biber) don't exist. Previously latexmk incorrectly stopped with an error message instead of continuing.
      2. Correct duplicate invocations of dvipdf, ps2pdf
  30. V. 4.27a dated 10 October 2011.
      
      1. Deal with problem that making of ps or pdf file via a temporary file fails if the command making it has no %D placeholder
      2. Add png to list of graphics extensions for pdflatex
      3. Add -norc option that prevents auto reading of rc files.
      4. Options -aux-directory -output-directory like those of (pdf)latex, to set the output directories of (pdf)latex. (-aux-directory is MiKTeX only). Corresponding configuration variables, and placeholders for command specification.
  31. V. 4.26 dated 9 August 2011.
      
      1. Make compatible with biber 0.9.4.
      2. Fix some bugs in error reporting.
  32. V. 4.25 dated 7 July 2011.
      
      1. Fix to evade apparent cygwin bug that prevented system rc-file from being read.
      2. Diagnostic for unreadable rc-file.
      3. Add deps output file to target part of dependency information.
  33. V. 4.24 dated 7 May 2011.
      
      1. When running biber, find locations of source files when they aren't in the current directory (by use of kpsewhich). This was previously done for bibtex but not biber.
  34. V. 4.23a dated 24 March 2011.
      
      1. Correct bug in detection of source files listed in .fls file
  35. V. 4.23 dated 21 March 2011.
      
      1. Correctly parse blg files of biber 0.8.
      2. Deal with problem that if maximum number of runs of (pdf)latex is exceeded, -pvc mode infinitely repeats (pdf)latex.
      3. Fix problem that changes in generated files during run of (pdf)latex may not be detected if the run is shorter than the granularity of file times.
      4. Corrections of comments and messages.
      5. Documentation improvement.
      6. Correct handling of errors given by rc files.
      7. Enhancements for convenient use of latexmk with Makefiles (options -deps, -deps-out, -use-make).
      8. -recorder option for improved detection of input and output files.
  36. V. 4.22e dated 3 February 2011.
      
      1. Fix incorrect error handling in reading initialization files. (Sometimes an error was incorrectly detected, after which latexmk stopped.)
  37. V. 4.22d dated 26 January 2011.
      
      1. Fix compatibility problem MiKTeX v. 2.8, that latexmk didn't always detect use of makeindex.
  38. V. 4.22c dated 23 January 2011.
      
      1. Make detection of use of biber compatible with MikTeX
  39. V. 4.22b dated 9 January 2011.
      
      1. Make compatible with biber 0.7.2. (Latexmk previously failed to detect .bib files used by biber 0.7.2.)
  40. V. 4.22 dated 1 January 2011.
      
      1. Support the use of biber (with the biblatex package) as an alternative to bibtex for generating bibliographies, with automatic determination of whether to use bibtex or biber.
  41. V. 4.21 dated 28 December 2010.
      
      1. Fixed some problems with parsing quoted filenames in log file. These prevented latexmk working correctly with latest version of asymptote.sty.
      2. Corrected potential bug in locating graphics files.
  42. V. 4.20 dated 12 November 2010.
      
      1. Fix problem that when bibtex finds no citations, this is treated by bibtex as an error. Previously latexmk respected this and did not continue processing. Now if the only bibtex error is the finding of no citations, then latexmk now treats it as only a warning and continues processing (by latex/pdflatex) as appropriate.
      2. Get .bst file in source file list for bibtex. (So an update to the bst file provokes a rerun of the relevant programs.)
      3. Allow clean-up to delete destination files of custom-dependencies Configuration variable $cleanup_includes_cusdep_generated to configure whether this is done. (Default is off, for backward compatibility.)
      4. Remove use of --width option on $pscmd on linux. It's no longer needed.
      5. Remove double quotes (if any) surrounding output filename read from .log file, to avoid wrong diagnostic message.
      6. Allow a more general pattern for files to clean up (when the -c, or -C option is used). For details, see the explanation of the $clean_ext variable in the latexmk documentation.
      7. Options to set commands used for latex and pdflatex, as in

                     -latex=special_latex_replacement_command
                     -pdflatex=special_pdflatex_replacement_command
                 

         (This is not yet documented.)
  43. V. 4.18 dated 27 July 2010.
      
      1. Only produce "Removing no-longer-needed dependent" messages when diagnostics are on.
      2. In analysis of log file, add test for natbib's citation-undefined warning
      3. Correct misprint in documentation.
  44. V. 4.17 dated 9 June 2010.
      
      1. Deal with bug about misparsing log file with non-space-containing filename that is followed by a space and a message on same line. Previously, the filename would not be detected as a dependent.
      2. With force_mode on, do a better job of completing processing.
      3. Remove obsolete options -F and -F-, which have been unused for a long time.
  45. V. 4.16a dated 18 May 2010.
      
      1. Sanity check on $sleep_time. (Negative times and times between 0 and 1 are replaced by 1.)
      2. Corrected problem under preview-continuous mode that some previewers would not see the changed file on an NFS file system.
  46. V. 4.16 dated 10 May 2010.
      
      1. Solved a problem with misparsed log files. Some versions of pdflatex fail to preceed some warning messages by a new line. Thus these warning messages sometimes appear to be part of a filename.
      2. Updated documentation to mention previously undocumented feature about the use of temporary files in making ps and pdf files.
  47. V. 4.15c dated 19 April 2010.
      
      1. Solved problem that occasionally latexmk failed to detect a dependent file when it analyzed a .log file. (It incorrectly treated some lines of length 79 as being wrapped.)
  48. V. 4.15b dated 12 April 2010.
      
      1. Change in use of Digest module to make latexmk compatible with the perl system (tlperl) installed by TeX Live.
      2. Under cygwin, additions to locations searched for system rc file, to give more UNIX compatibility.
  49. V. 4.15 dated 7 April 2010.
      
      1. Changes of default settings for running latex and pdflatex with latexmk's -quiet option; they are now TeX-Live compatible for all OSs.
      2. Small improvements in diagnostics and error handling.
  50. V. 4.13a dated 16 January 2010.
      
      1. This corrects a bug in v. 4.13 that when using the option -C to delete generated files, certain files were not actually deleted.
  51. V. 4.13 dated 13 January 2010.
      
      1. Corrections (to dealing with clean-up of generated files).
      2. Default for running bibtex: Only run bibtex when .bib file exists.
  52. V. 4.12 dated 15 December 2009.
      
      1. Added an option not to run bibtex (to deal with situations where a bbl file is available but not the bib file from which it was made).
      2. Corrected misprints in documentation.
      3. (Dec. 24, 2009) Corrected more misprints in documentation.
  53. V. 4.11 dated 27 November 2009.
      
      1. Corrects a long-standing bug that when the main file uses bibtex, and uses \include for subdocuments and the set of included files changes, latexmk did not update the list of source files for bibtex. Then changes in bibliography citations did not always trigger a rerun of bibtex.
      2. Fixed a problem that latexmk did not detect changed aux files and the like on a small document when the run of (pdf)latex was within the 1-second granularity of filetimes.
      3. Improved start-up times on some large documents by avoiding unnecessary recalculations of md5 checksums.
  54. V. 4.10d dated 10 September 2009.
      Attempt to deal better with conversions reported by epstopdf, when the converted file appears not to exist. (Do a kpsewhich search.)
      When view files are make via a temporary file (not-yet-documented feature), delete old view file before moving the temporary file. (To avoid reported bug in kpdf and okular.)
  55. V. 4.10b dated 4 September 2009. The -silent option now causes certain non-existent-file messages to be suppressed.
  56. V. 4.10a dated 1 September 2009. Corrects a problem that with an error introduced at v. 4.08 that on finding an error in processing one file latexmk exits rather than continuing processing other requested files. The exit code returned by latexmk was also incorrect in this situation.
  57. V. 4.10 dated 21 August 2009.
  58. V. 4.09a dated 19 August 2009. Small update to v. 4.09a, which should not affect anything.
  59. V. 4.09 dated 18 August 2009. Appropriate treatment of graphics files converted by current version of epstopdf package. Plus minor bug fixes. This version has not been tested thoroughly.
  60. V. 4.08 dated 23 June 2009. Corrects problem caused by MikTeX 2.7 writing log files containing binary characters, including ctrl/Z. When latexmk reads the log file to get dependency information, a ctrl/Z causes a premature end-of-file condition. On MS-Win, latexmk now reads the log file in binary mode.
  61. V. 4.07 dated 27 May 2009. Corrects problem that ctrl/C used to exit from preview-continuous mode always killed any script used to call latexmk. Deals better with situation that a run of (pdf)latex does not produce the expected dvi or pdf file.
  62. V. 4.05 dated 10 April 2009.
  63. V. 4.04 dated 25 February 2009. Corrects problems when latexmk is used to run both latex and pdflatex on the same source file. The problems were particularly noticeable when different choices were used on different runs.
  64. V. 4.03 dated 22 December 2008. Corrects issue in parsing the log file. Sometimes lines were treated as wrapped when they shouldn't have been; this occasionally resulted in latexmk not detecting source files.
  65. V. 4.02b dated 1 December 2008. Corrects issue with clean-up options -c and -C. They now delete the database file of source file information.
  66. V. 4.02a dated 26 November 2008. Corrects problem with using start command under MSWin in default commands for viewing files: MSWin took quoted filenames to mean window title instead of filename.
  67. V. 4.02 dated 15 November 2008. Corrects problem with misreading of log files generated by current MikTeX (v. 2.7) that puts double quotes around space-containing filenames.
  68. V. 4.01b dated 10 November 2008.
  69. V. 3.20 dated 17 August 2007.
  70. V. 3.08n dated 26 February 2007.
  71. V. 3.07a dated 2 June 2004.
  72. V. 3.07 dated 14 May 2004.
  73. V. 3.06d dated 2 Mar. 2004.
  74. V. 3.06c dated 17 Jun. 2003.
  75. V. 3.06 dated 22 Oct. 2002.
  76. V. 3.04 dated 24 Nov. 2001.
  77. V. 2
  78. Current main release is also on CTAN at http://www.ctan.org/pkg/latexmk/