Summarize recent changes

CHANGES.md

@@ -1,103 +1,94 @@
-Change log for microarchiver
-============================
+# Change log for microarchiver
 
-Version 1.12.0
---------------
+## Version 1.12.1
+
+This release  fixes a couple of issues:
+
+* The default network timeout was too short to get large PDF files from micropublication.org. Fixed by tripling the timeout duration.
+* Image conversion exceeded an internal default in the Python Pillow package being used for image conversion. Fixed by disabling the size check.
+
+
+# Version 1.12.0
 
 Reports can now be written in _both_ CSV and HTML formats.
 
 
-Version 1.11.0
---------------
+# Version 1.11.0
 
-* Add support for producing reports in HTML format.
 * Add support for specifying the title of the report.
 * Fix incorrect count of articles in ZIP file comments.
 
 
-Version 1.10.7
---------------
+# Version 1.10.7
 
 * Test for more signs of failure in `upload-to-pmc.sh`.
 * Make some very tiny tweaks to the format of logs.
 
 
-Version 1.10.6
---------------
+# Version 1.10.6
 
 * Assume the use of Python `virtualenv` to lock in a specific Python environment.
 * Fix a bug in one of the workflow scripts in which the lack of a mail message body caused the mail command to hang indefinitely.
 
 
-Version 1.10.5
---------------
+# Version 1.10.5
 
 * Add new helper function to run `curl` in the upload script for PMC.
 * Fix inconsistency in the PMC upload script, wherein the user and password variables were not the same name as the cron variables actually used.
 
 
-Version 1.10.4
---------------
+# Version 1.10.4
 
 * Fix bug in date handling in workflow scripts.  The value of the `--after-date` argument to `microarchiver` was set to the date it ran, which caused it to miss articles published on the date that it ran.  The value of the date should have been modified to include the day it last ran so that the date comparison was correct.  (Thanks to Nick Stiffler for catching and reporting the problem.)
 
 
-Version 1.10.3
---------------
+# Version 1.10.3
 
 (Mistaken release -- ignore this.)
 
 
-Version 1.10.2
---------------
+# Version 1.10.2
 
 * Update the workflow scripts and associated crontab template.
 
 
-Version 1.10.1
---------------
+# Version 1.10.1
 
 * Fix behavior when DataCite has no data for an article: `microarchiver` was _meant_ to flag the article and keep going, but instead it treated it as a fatal error.
 * Fix some documentation errors about the numeric codes returned by `microarchiver`.
 * Minor other improvements.
 
 
-Version 1.10.0
---------------
+# Version 1.10.0
 
 This version changes the behavior of the `-@` command-line option, such that exceptions encountered when running with the `-@` option do _not_ cause `microarchiver` to drop into an interactive debugger.  The old behavior turned out to be unhelpful in practice, and moreover, it mixed two behaviors into one command-line flag.  The latter was problematic when running `microarchiver` from scripts.
 
 
-Version 1.9.4
---------------
+# Version 1.9.4
 
 This version removes an unnecessary dependency on wxPython.  A GUI interface was never completed for Microarchiver, and while the starting code is still in the code base in case we try to build a GUI, it doesn't have to be hooked in at this point.  Removing the internal references to the GUI code allows the wxPython requirement to be removed, which in turn simplifies and speeds up installation.
 
 
-Version 1.9.3
---------------
+# Version 1.9.3
 
 * Add missing Python package requirement to requirements.txt.
 * Simplify PMC upload script.
 
 
-Version 1.9.2
---------------
+# Version 1.9.2
 
 * Fix broken logos and images in README.md.
 * Replace local version of `debug.py` with the use of [Sidetrack](https://github.com/caltechlibrary/sidetrack).
 * Use newer approach to recording version and other metadata in `__init__.py` and the release procedure codified in `Makefile`.
 * Minor internal changes.
 
 
-Version 1.9.1
--------------
+# Version 1.9.1
 
 * Fix [issue #2](https://github.com/caltechlibrary/microarchiver/issues/2): volume number in file names is incorrectly determined
 
 
-Version 1.9.0
--------------
+# Version 1.9.0
 
 * Support output for PMC using new command-line option `-s`.
 * Rename the JATS XML file after the pattern _issn_-_volume_-_doi_.xml, to make it more compatible with output generated for PMC.
@@ -107,14 +98,12 @@ Version 1.9.0
 * Some internal code changes.
 
 
-Version 1.8.0
--------------
+# Version 1.8.0
 
 * Instead of quitting with an error if the file given to `-a` is empty, `microarchiver` will now just print a warning.
 
 
-Version 1.7.0
--------------
+# Version 1.7.0
 
 * Store JATS XML for each article, as well as any image referenced in the JATS data. Images are converted to uncompressed TIFF before being stored.
 * Perform JATS validation for each article by default.
@@ -127,70 +116,60 @@ Version 1.7.0
 * Fix miscellaneous bugs.
 
 
-Version 1.6.3
--------------
+# Version 1.6.3
 
 * Catch and handle no-content errors more gracefully.
 * Detect mangled XML returned by micropublication.org and handle it more gracefully.
 
 
-Version 1.6.2
--------------
+# Version 1.6.2
 
 * Fix crasher in writing comment into zip file because of reference to no-longer-existing package attribute.
 
 
-Version 1.6.1
--------------
+# Version 1.6.1
 
 * Fix broken handling of debug trace output destination.
 * Update `README.md` to describe changes to debug flag.
 
 
-Version 1.6.0
--------------
+# Version 1.6.0
 
 * Change the debug flag `-@` to accept an argument for where to send the debug output trace. The behavior change of `-@` is not backward compatible.
 * Put metadata in `setup.cfg` and change how Microarchiver gets the metadata internally.
 
 
-Version 1.5.1
--------------
+# Version 1.5.1
 
 * Fix bug in propagating network failures up to the top of main.
 * Fix case of variable being shadowed inside a block.
 
 
-Version 1.5.0
--------------
+# Version 1.5.0
 
 * Added new `-g` option to print the raw XML article list from the server.
 * Did very minor internal code refactoring.
 
 
-Version 1.4.0
--------------
+# Version 1.4.0
 
 * Added new `scripts` subdirectory with script for use with cron.
 * Fixed behavior: if there are no articles to archive, don't create the output directory either.
 
 
-Version 1.3.0
--------------
+# Version 1.3.0
 
 * Now if there are no articles to archive, it won't create a zip file.
 
 
-Version 1.2.0
--------------
+# Version 1.2.0
 
 * Improved installation instructions.
 * Changed debug flag from `-Z` to `-@`.
 * Internal code changes for message printing & colorization.
 
 
-Version 1.1.0
--------------
+# Version 1.1.0
 
 * **Backwards incompatible change**: command-line arguments have been significantly changed in terms of names and shortcut letters.
 * Addition of new `-d` command-line argument, for getting only articles published after a certain date.