summaryrefslogtreecommitdiff
path: root/support/latexmk/CHANGES
blob: 018ff33c5c4180e815da4c945023174b2487fff0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
List of main changes in latexmk


From v. 3.04 to v. 3.07
   Pdf files can be made by any of three methods: pdflatex, from dvi
       or from postscript.
   Extra command-line options -- see documentation
   Improved configuration options -- see documentation
   Bug fixes, etc
   Improved detection of dependencies
   If latexmk exits because of an error with latex, bibtex 
      or makeindex, then it gives a non-zero exit code.
   Under MS-Windows allow wildcards in filenames.

From v. 3.07 to v. 4.01
   Allow dvips, etc to put files in temporary location then move to
      final location.  This enables the problem to be avoided that
      some viewers look for changes in a file and read a new file
      before the writing of it is complete.
   Ensure that an error in exectuing an rcfile results in an error
      message visible to the user.
   OS-specific initialization code now includes section for Mac OS-X.
   Make code safe, as far as possible, for filenames containing
      spaces.
   Change method of detecting out-of-date-ness, etc, to examine all
      files for changes.  Keep a database (in a file with extension
      fdb_latexmk) of the previous state of the files.  The aux.bak
      and idx.bak files are no longer used.  The primary method of
      detecting change is from the md5 checksum of a file.  This deals
      automatically with the vast majority of cases where there is
      circular dependence of files, without needing special coding in
      latexmk to know which input files to a LaTeX run are generated
      from a previous run.
   Hence make a much more systematic and general method for treating
      dependencies. 
   Substituteable place holders allowed in command specifications, to
      allow very general specification of commands (including multiple
      commands, pipelines etc).
   Extra option --dependents to list dependent files.
   Support for multibib.sty, multind.sty, etc.
   Support for index.sty as well as makeidx.sty.
   Allow .latexmkrc as file name in project directory (as opposed to
      latexmkrc). 
   Command-line option -e to allow execution of initialization code
      from command-line invocation of latexmk.
   Routines add_cus_dep, remove_cus_dep and show_cus_dep for
      manipulating custom-dependency list.
   Ability to specify lines to be ignored in computing md5 checksum of
      a file of a particular extension.  (An example would be a
      comment line in an encapsulated postscript file that contains
      the date and time it was created.  Such lines may change without
      having any consequence on the use of the file.)
   Miscellaneous bug fixes, etc.
   Improvements in parsing of log file

From v. 4.01 to v. 4.05
   Miscellaneous bug fixes
   Fix bug that -ps -pdfps runs ps2pdf before dvips
   Deal with quoted filenames in log file
   Correct problem with invocation of MSWin start command
   -c and -C now also delete fdb_latex file
   For home directory (where user's .latexmkrc is located, 
      when $ENV{'HOME'} does not exist, use $ENV{USERPROFILE}
      (suitable for MS-Win).
   Correct treatment of -e option
   Fix possibility that unwrapping of lines in log_file is done
      incorrectly 
   Correct parsing of log file
   Improve diagnostics of reasons for rerun of external program.
   Fix problems when using both latex and pdflatex
   Configurable extensions for finding cusdep
   Change to a nicer #! line
   Safer use of % in placeholders in commands

From v. 4.05 to v. 4.07
   In preview-continuous mode, arrange that ctrl/C used to stop the
      processing loop does not automatically kill a script used to
      call latexmk
   Better handling of situation when a run of (pdf)latex does not
      produce a dvi or pdf file, or when the opposite type of output
      is produced than expected (e.g., pdf instead of dvi by latex)
   Deal better with case that file is written and read by (pdf)latex
      during a run

From v. 4.07 to v. 4.10
   Binmode for log file under MSWin to avoid problem with ctrl/Z
      written by Miktex 2.7 giving spurious end-of-file.
   Deal with issues in depedency structure caused by epstopdf, which
      automatically creates pdf files from eps files during run of
      pdflatex. 
   Correct problem with determining use of custom dependencies, when
      file-not found-report has extensionless filename, but
      corresponding .tex file exists.  
   Preview-continuous mode now doesn't bomb out if there are errors
      during first run of (pdf)latex.  (Previously that caused the
      previewer not to run even if viewed file exists.)

From v. 4.10 to v. 4.11
   Corrects a long-standing bug that when the main file uses
      bibtex, and uses \include for subdocuments, changes in 
      bibliography citations did not always trigger a rerun of bibtex.
   Fixed a problem that latexmk did not detect changed aux files etc
      on a small document when the run of (pdf)latex was within the
      1-second granularity of filetimes. 
   Improved start-up times on some large documents by avoiding
      unnecessary recalculations of md5 checksums.
   Deals better with eps-to-pdf conversions reported by epstopdf
      package.
   -silent option now causes suppression of certain messages about 
      non-existent files
   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.)
   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

From v. 4.11 to v. 4.12
    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). 
    Corrected misprints in documentation.

From v. 4.12 to v. 4.13
    Corrected clean_up so aux file is deleted.
    Default for running bibtex: Only when .bib file exists.
    Correction insertion of bbl into list of generated extensions.

From v. 4.13 to v. 4.13a
    Corrected a problem that clean-up option (-C) failed to delete
       certain generated files.

From v. 4.13a to v. 4.15
    Change defaults on $latex_silent_switch and $pdflatex_silent_switch
       to make them always TeXLive compatible.
    To avoid problems with apparent source files that are incorrectly
       determined from the log file: (a) Make sure md5 calc doesn't
       bomb out on directory.  (b) In parsing log file: if apparent
       dependent file is directory, remove it from list of dependent
       files.
    Better diagnostics at end of run with multiple files: list
       applications of latex and pdflatex that failed.
    Fixed problem that with -pvc when (pdf)latex failed, latexmk kept
       doing dvips, dvipdf, etc.  

From v. 4.15 to v. 4.15b
    Changed default location of system rc files for cygwin to include
       both Unix-like and MSWindows paths.
    Changed use of Digest module to use of Digest::MD5 module, to give
       compatibility with the limited installation of perl shipped
       with TeX Live.

From v. 4.15b to v. 4.15c
    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.)

From v. 4.15b to v. 4.16
    Solved another 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. 
    Updated documentation to mention previously undocumented feature
      about the use of temporary files in making ps and pdf files. 

From v. 4.16 to v. 4.16a
    Sanity check on $sleep_time.  (Negative times and times between 0
       and 1 are replaced by 1.)
    Corrected problem under preview-continuous mode that some
      previewers would not see the changed file on an NFS file
      system. 

From v. 4.16a to v. 4.17
    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. 
    With $force_mode on, do a better job of completing processing.
    Remove long-unused options -F and -F-

From v. 4.17 to v. 4.18
    Only produce "Removing no-longer-needed dependent" messages
        when diagnostics are on.
    In analysis of log file, add test for natbib's citation-undefined
        warning.
    Correct misprint in documentation.

From v. 4.18 to v. 4.20
    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. 
    Get .bst file in source file list for bibtex.  (So an update to
        the bst file provokes a rerun of the relevant programs.)
    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.) 
    Remove use of --width option on $pscmd on linux.  It's no longer
        needed.
    Remove double quotes (if any) surrounding output filename read
        from .log file, to avoid wrong diagnostic message.
    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.
    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.)

From v. 4.20 to v. 4.21
    Fix some problems with parsing quoted filenames in log file.
        These prevented latexmk working correctly with latest version
        of asymptote.sty.
    Corrected potential bug in locating graphics files.

From v. 4.21 to v. 4.22
    Support use of biber (with the biblatex package) for generating
        bibliographies, with automatic selection of bibtex or biber. 

From v. 4.22 to v. 4.22b
    Compatibility with biber 0.7.2.  (Latexmk failed to detect .bib
    files used by biber 0.7.2.)

From v. 4.22b to v. 4.22c
    Biber support is now compatible with MikTeX.

From v. 4.22c to v. 4.22d
    Fix compatibility problem MiKTeX v. 2.8, that latexmk didn't
    always detect use of makeindex. 

From v. 4.22d to v. 4.22e
    Fix incorrect error handling in reading initialization files.
    (Sometimes an error was incorrectly detected, after which latexmk
    stopped.)

From v. 4.22e to v. 4.23
    Deal with problem that if maximum number of runs of (pdf)latex is
      exceeded, -pvc mode infinitely repeats (pdf)latex
    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.
    Corrections of comments and messages. Documentation improvement.
    Correctly parse blg files of biber 0.8
    Correct handling of errors given by rc files
    Enhancements for convenient use of latexmk with Makefiles (options
      -deps, -deps-out, -use-make)
    -recorder option for improved detection of input and output files.
    
From v. 4.23 to v. 4.23a
    Correct bug in detection of source files listed in .fls file

From v. 4.23a to v. 4.24
    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.

From v. 4.24 to v. 4.25
    Fix to evade apparent cygwin bug that prevented system
       rc-file from being read.
    Diagnostic for unreadable rc-file.
    Add deps output file to target part of dependency information

From v. 4.25 to v. 4.26
    Make compatible with biber 0.9.4.
    Fix some bugs in error reporting.

From v. 4.26 to v. 4.27a
    Deal with problem that making of ps or pdf file via a temporary
       file fails if the command making it has no %D placeholder
    Add png to list of graphics extensions for pdflatex
    Add -norc option that prevents auto reading of rc files.
    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.

From v. 4.27a to 4.28
    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.

From v. 4.28 to 4.28a
    Correct duplicate making of view file

From v. 4.28a to 4.28c
    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.
    Latexmk now parses correctly error messages from biber v. 0.9.7.

From v. 4.28c to 4.29a
    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.)
    If output directory is set, arrange that dvips can find files
      there.
    In  searching for cus-deps that can make a missing file, look in
      $out_dir.
    Solves problem that sometimes dvips and dvipdf weren't run when
      they should have been.  (The problem only arose with certain 
      changes in eps files being made within a minute of the previous
      run.)

From v. 4.29a to 4.30a
    Fix use of bibtex so that it works correctly when $aux_dir and/or
       $out_dir are set.
    Use OS-dependent search path separator when when manipulating
       TEXINPUTS, etc. Then use of -output-directory and
       -aux-directory options should work on MSWin systems.
    Documentation of $search_path_separator variable.

From v. 4.30a to 4.31
    Add -M -MP and -MF options, like gcc.
    Recorder option is now on by default.
    Add options reproducing most options of (pdf)latex (list from both
       TeXLive and MikTeX versions).  
       Options NOT implemented by latexmk at all:
           -ini and -initialize  since they refer to operations
                                 not supported by latexmk
           -includedirectory=dir its support needs extra code in
                                 latexmk, not currently written
      Options differently processed by latexmk:
           -help
           -version
           -quiet
      Options that are passed to (pdf)latex but that also have special
      processing by latexmk
           -aux-directory=dir
           -output-directory=dir
           -recorder
    Add -latexoption=... option to latexmk
    Add -xelatex option for use of xelatex
    Change OS-X default for pdf previewer command to open
    Command specification string can start with "include routine" to
       invoke a Perl subroutine instead of an external cmd.
    Viewers are detached by default.  (The start keyword is now normally
      superfluous in command specifications.)
    Keyword nostart added in command specification.
    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.
    If aux and/or output directories are specified but don't exist,
      make them.
    Remove excessive repetition of tests for changes of source files
      (improves performance of latexmk in some situations).
    Documentation improvements.
    Minor bug corrections.

From v. 4.31 to 4.33a
   Improve operation under MSWindows: substitute "\" for "/" for
     directory separator in command lines, deal consistently with
     directory separator, which can be both "\" and "/".
   Correct some bugs that interfered with use of auxiliary directory
     and output directory for files generated by (pdf)latex,
     especially with MiKTeX.
   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. 
   Add $dvipdf_silent_switch configuration variable.
   Improve handling of errors in (pdf)latex; previously latexmk would
     give up processing in some situations continuing is correct.
   Documentation corrections/improvements.
   Reduce number of warnings in silent operation.
   Cure slowness of v. 4.33 under Cygwin.

From v. 4.33a to 4.33b
   Documentation improvements.
   Improve text displayed by using -showextraoptions option.

From v. 4.33b to 4.33c
   Correct infinite loop when maximum passes through latex/pdflatex
      are exceeded

From v. 4.33c to 4.34
   Correct non-optimality that if (pdf)latex reads a file only after
      it has been written in the same run, the file is not a true
      source file, but nevertheless latexmk treats it as a source
      file.  Thus changes in the file sometimes caused latexmk to make
      unnecessary (but otherwise innocuous) extra runs of (pdflatex).

From v. 4.34 to 4.35
   Correct bug in parsing fls file from native MS-Windows LaTeX (e.g.,
      MiKTeX) when latexmk is run under cygwin.  (The names of some
      files used by latexmk incorrectly contained a CR character.)
   Correct bug that when the --gg option is used, the rule database
      from the old fdb file was used instead of being cleared.

From v. 4.35 to 4.37
   Correct failure that happens when name of current directory
     contains characters with special meaning in regular expression.
   -rules option now works with -pvc
   Add -lualatex option, like -xelatex.
   File specifications in $clean_ext and $clean_full_ext are allowed
     to contain wildcards.
   Warnings are given when rc file is a directory instead of a file.
   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.
   Other minor corrections and code improvements.
   Documentation updates and corrections.

From v. 4.37 to 4.39
  Automatic creation of necessary subdirectories of auxdir when needed
    for writing aux files. 
  Add error diagnostics to if_source 
  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.
  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. 
  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.
  In output of dependencies, include pathname of target file(s) in the
    rule. 
  In -pvc mode, writing of deps file (caused by the -M and related
    options) is per make not per overall run. 

From v. 4.39 to 4.39 documentation update of 2 Dec 2013
  Correct two errors in documentation and in the file COPYING.

From v. 4.39 to 4.40
  Fix failure to clean up correctly when root filename contains [,
    which is a glob metacharacter.

From v. 4.40 to 4.41
  -c also deletes $deps_file if it is used
  Quote jobname when needed.
  Change maintainer's preferred e-mail
  Attempt to improve handling of errors from (pdf)latex.
  Fix up for the making of -eps-converted-to.pdf
  Improve listing of warning lines from log file.
  Fix failure when using both -cd and -output-directory
  If user's home directory can't be determined, then don't read ~/.latexmkrc
  Introduce configuration variable $silence_logfile_warnings
  In setting $pscmd, allow for non-existent environment variable USER
  Correct subroutine Run for internal cmd w/o arguments
  Experimental: Add analysis hook for aux file.
  System initialization files: allow them to be named latexmkrc as
    well as LatexMk, for more consistency with user directory names.
    Keep both cases, to preserve backward compatibility.
  Change sign-on message.  Bug report info with help.

From v. 4.41 to 4.42
  Fix bugs associated with the -cd option
  Add missfont.log and the generated synctex.gz to standard cleaned-up files

From v. 4.42 to 4.43a
  Fix problem that source files are not correctly detected under
    MiKTeX when name of current working directory contains non-ASCII
    characters.
  On cleanup, synctex.gz files are deleted only by -C, not by -c.

From v. 4.43a to 4.43c
  Correct normalization of filenames, so that initial "./" is always
  removed.  This prevents custom dependencies being run twice on the
  same file.
  Documentation correction on use of @BIBINPUTS.
  Diagnostic correction.
  Example rc file for using texinfo (thanks to Vincent Bela\"iche).
  Additions to documentation concerning advanced configuration.

From v. 4.43c to 4.44
  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.)
  Correct error handling when biber finds a malformed .bcf file.

From v. 4.44 to 4.45
  Fix problem of -C not always working correctly when compilation was
  with -pdf and clear was default. 
  Fix bug in limiting number of passes when $max_repeat >= 10
  Fix bug in finding id of viewer process id under OS-X

From v. 4.45 to 4.46
  Correct creation of output and aux directories to correctly handle
  relative paths when -cd is used.
  Minor documentation corrections.

From v. 4.46 to 4.48
  Correct documention: default value of $recorder is 1
  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.
  Update webpages in documentation.

From v. 4.48 to 4.52
  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.
  Fix bug that if an .aux file is deleted and latexmk is run, the
    wrong number of runs of (pdf)latex was made.
  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.
  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.
  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.)
  Correct detection for missing graphics files with xelatex.
  Work around LuaTeX line-wrapping bug.
  Update documentation.
  Minor improvements in code and diagnostics.

From v. 4.52 to 4.52b
  Fix bug introduced in 4.52 that use of bibtex wasn't always detected
    when recorder mode is on.

From v. 4.52b to 4.52c
  Make -jobname work with -pdfxe and -pdflua.

From v. 4.52c to 4.54
  In deps_list, correct bug in identifying generated files.
     Otherwise, generated files could have been identified as true
     source files.
  Remove insertion of name of deps file in list of targets in deps file.
  Don't send to screen deps info in deps mode (unless diagnostics on).
  Correct ordering of list of options given by -help.
  Fix incorrect deletion of non-generated aux files.
  Optimize away current directory string in $out_dir and $aux_dir.
  Make compatible with future versions of Perl where File::Glob's glob
    function won't exist.
  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.
  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.
  Collection of timing information now works in silent mode.
  Set better default previewers for MSys.
  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.
  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. 
  Documentation improvements, especially on methods of implementing
    custom dependencies for multiple kinds of index.
  Document $kpsewhich_show variable.
  Add a sample latexmkrc file for use with bib2gls and glossaries-extra. 

From v. 4.54 to 4.54c
  Work-around for when bsd_glob is not available on old installations of
    Perl.  (Note that with these old installations, clean-up operations
    may not work when file or directory names contain spaces.)

From v. 4.54c to 4.55
  Correct bug that $search_path_separator wasn't defined under msys.
  Ensure that all configuration variables do have sensible default
    definitions (which wasn't always the case previously).
  Allow optional timeout in pvc mode after a period of inactivity.
    (See documentation for -pvctimeout option.)
  Compensate for problems caused by time offset between system time on
    system running latexmk and file times on remote file system.
    (It caused wrong behavior when a document uses biber, MiKTeX
    is used, the aux_dir is on a remote file system, and the system
    time on the host of the file system differs from the system time on
    the system running latexmk.)

From v. 4.55 to 4.55a
  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.
  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).

From v. 4.55a to 4.56
  Correct parsing of biber's log file.
  Implement $warning_cmd.
  Deal correctly with situation that files reported in the .fls file
    as INPUT or OUTPUT files no longer exist at end of run. These
    files aren't true source files or generated files from latexmk's
    point of view.  Such cases can arise from a bug in the TeX
    engine (as with lualatex in TeXLive 2016/2017).  They can also
    arise when temporary files are created, read and deleted during
    a run (as with the minted package).
  Update example latexmrc file for pythontex.
  Better error message when .bib file(s) not found.
  Better handling and diagnostics when names of expected and actual
    names of .log disagree.
  In particular, there is 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).
  Fix problem of .bib files sometimes not being found by bibtex when
    latexmk runs under msys and -outputdirectory is specified.
  Add use of environment variable LATEXMKRCSYS to specify system rc
    file.
 
From v. 4.56 to 4.57
  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. 
  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.)

From v. 4.57 to 4.59
  Deal with double quote ('"') characters in files on command line to
    correspond to behavior of tex programs.  Remove balanced pairs,
    and give fatal error for unbalanced double quotes. (Note MiKTeX's
    tex programs simply remove unbalanced quotes.)  In all cases, the
    '"' character is not allowed in a filename read by tex and
    friends.
  Give fatal error when name of tex file on command line is either not
    allowed by tex and friends , or gives problematic behavior.
  Use TEXINPUTS as search path for source files for custom
    dependency.
  Only give warning about differing expected and output filenames when
    the extensions differ.  All other cases gave only false positives.
  Do better to ensure xelatex gets its -no-pdf option.

From v. 4.59 to 4.61
  Add -pdfxelatex and -pdflualatex options to set commands for
    xelatex and lualatex (in analogy with -pdflatex and -latex).
  Correct bug that use of -gg option with -deps-file option 
    did not create deps file.
  After run of latex/pdflatex (etc), report count of warnings about missing
    characters (typically unavailable Unicode characters). Messages about
    this may appear only in the .log file and are therefore easily missed
    by the user.
  Fix problem that if biber gets a remote file, latexmk would report it
    incorrectly as a missing file.
  Provide routines for setting all of $latex, etc, with a common pattern.
  Variables, options, placeholders for executing code in *latex before
    inputting source file.  The new variable is $pre_tex_code, the
    options are -pretex, -usepretex, and the new placeholders are %P
    and %U.
  Improved definitions provided for the configuration of latexmk to
    use pythontex; see the file pythontex-latexmkrc in the directory
    example_rcfiles.
  Correction to use of specifications in $clean_ext and
    $clean_full_ext so that %R can appear in the interior of a string
    as in 'pythontex-files-%R/*'. 
  Updates of documentation.

From v. 4.61 to 4.63b
  Update example_rcfiles/glossary_latexmkrc
  Fix problem that in -cd mode, an error is raised when the path
    part of the tex filename contains a character prohibited by *tex.
  Implement changing of rule network when output of *latex is not what
    is expected, e.g., because \pdfoutput is used in document.
  Implement placeholder for true basename of main tex file, and use it
    in jobname.
  Various bug fixes.

From v. 4.63b to 4.64
  Fix problem that rules processing dvi and xdv did not always run after
    rapid-fire changes in graphics files.

From v. 4.64 to 4.64a
  Fix incorrect listings by -rules and by -deps

From v. 4.64a to 4.65
  Fix incorrect parsing of long quoted filenames in log file that sometimes
    prevented latexmk from running.

From v. 4.65 to 4.67
  Improve parsing of long lines in log file, especially with UTF-8 filenames
    and xelatex. 
  Minor diagnostic improvements
  Allow addition of hook for processing lists of missing source files.
  Changing of '\' to '/' in filenames is done for msys as well as MSWin32.
  Use $compiling_cmd, $warning_cmd, $success_cmd on normal make, rather
    than just in -pvc mode.
  If there were missing subdirectories in output/aux directories, and these
    were successfully created, then ignore error from *latex, since rerun
    may succeed.

From v. 4.67 to 4.69a
  Add -E option to default command for xdvipdfmx, to match call made
    by xetex. This forces xdvipdfmx to always try to embed fonts.
  Add -MSWinBackSlash -MSWinBackSlash- options (and corresponding
    configuration variable $MSWin_back_slash) to control whether
    directory separator '\' is used for filenames on command line for
    called programs under MSWin.  -MSWinBackSlash- needs to be used
    when TeXLive is used on MSWin and the TeX filename includes a
    directory component. 
  When command-line-specified tex file not found, test for cusdep to
    make it, then try kpsewhich, and only if all 3 fail report an
    error.
  Remove use of $extension_treatment: Too hard to check.  Always use
    what was called 'unix' method, which all *latex implementations
    now use. 
  Improve some warning messages.
  Fix bug when -cd and -outdir are used, and outdir is same as
    document directory.  (Bug is caused by problem in perl module
    Cwd.)
  Report rc files read

From v. 4.69a to 4.70a
  Improved compatibility with chapterbib.sty, provided that the configuration
    given in file example_rcfiles/chapterbib-latexmkrc is used.
  Correction of default values of $biber and $bibtex.
  Improved handling of location of bbl and aux files on an intial run.
  Change of default: running bibtex no longer uses temporary change of
    directory, since the bug in bibtex that it evades isn't present in
    recent versions.
  Small bug corrections, and changes to some diagnostic messages.
  Documentation corrections.

From v. 4.70a to 4.70b
  Fix problems when rearranging rules to deal with change of output file of
    *latex engine (e.g., .pdf to .dvi).
  Fix problem with the new default not to do the change of directory for
    bibtex.  Use of full path names for output-directory or tex file no
    longer causes a bibtex error.
  Add options -bibfudge, -bibfudge-, -nobibfudge.