Prepare 8.2.1 release

Jay Berkenbilt
1 parent 28453a49
Showing 4 changed files with 60 additions and 5 deletions
ChangeLog
configure.ac
libqpdf/QPDF.cc
manual/qpdf-manual.xml
 2018-08-18  Jay Berkenbilt  <ejb@ql.org>
+	* 8.2.1: release
+
 	* Add new option --keep-files-open=[yn] to control whether qpdf
 	keeps files open when merging. Prior to version 8.1.0, qpdf always
 	kept all files open, but this meant that the number of files that
@@ -2,7 +2,7 @@ dnl Process this file with autoconf to produce a configure script.
 dnl This config.in requires autoconf 2.5 or greater.
 AC_PREREQ([2.68])
-AC_INIT([qpdf],[8.2.0])
+AC_INIT([qpdf],[8.2.1])
 AC_CONFIG_MACRO_DIR([m4])
 AC_CONFIG_FILES([autoconf.mk])
@@ -31,7 +31,7 @@ LT_INIT([win32-dll])
 # LT = libtool
 LT_CURRENT=23
 LT_AGE=2
-LT_REVISION=0
+LT_REVISION=1
 AC_SUBST(LT_CURRENT)
 AC_SUBST(LT_REVISION)
 AC_SUBST(LT_AGE)
@@ -19,7 +19,7 @@
 #include <qpdf/QPDF_Null.hh>
 #include <qpdf/QPDF_Dictionary.hh>
-std::string QPDF::qpdf_version = "8.2.0";
+std::string QPDF::qpdf_version = "8.2.1";
 static char const* EMPTY_PDF =
     "%PDF-1.3\n"
@@ -5,8 +5,8 @@
 <!ENTITY mdash "&#x2014;">
 <!ENTITY ndash "&#x2013;">
 <!ENTITY nbsp "&#xA0;">
-<!ENTITY swversion "8.2.0">
-<!ENTITY lastreleased "August 16, 2018">
+<!ENTITY swversion "8.2.1">
+<!ENTITY lastreleased "August 18, 2018">
 ]>
 <book>
  <bookinfo>
@@ -454,6 +454,35 @@ make
       </listitem>
      </varlistentry>
      <varlistentry>
+      <term><option>--keep-files-open=<replaceable>[yn]</replaceable></option></term>
+      <listitem>
+       <para>
+        This option controls whether qpdf keeps individual files open
+        while merging. Prior to version 8.1.0, qpdf always kept all
+        files open, but this meant that the number of files that could
+        be merged was limited by the operating system's open file
+        limit. Version 8.1.0 opened files as they were referenced and
+        closed them after each read, but this caused a major
+        performance impact. Version 8.2.0 optimized the performance
+        but did so in a way that, for local file systems, there was a
+        small but unavoidable performance hit, but for networked file
+        systems, the performance impact could be very high. Starting
+        with version 8.2.1, the default behavior is that files are
+        kept open if no more than 200 files are specified, but that
+        the behavior can be explicitly overridden with the
+        <option>--keep-files-open</option> flag. If you are merging
+        more than 200 files but less than the operating system's max
+        open files limit, you may want to use
+        <option>--keep-files-open=y</option>, especially if working
+        over a networked file system. If you are using a local file
+        system where the overhead is low and you might sometimes merge
+        more than the OS limit's number of files from a script and are
+        not worried about a few seconds additional processing time,
+        you may want to specify <option>--keep-files-open=n</option>.
+       </para>
+      </listitem>
+     </varlistentry>
+     <varlistentry>
       <term><option>--pages options --</option></term>
       <listitem>
        <para>
@@ -3258,6 +3287,30 @@ print &quot;\n&quot;;
   </para>
   <variablelist>
    <varlistentry>
+    <term>8.2.1: August 18, 2018</term>
+    <listitem>
+     <itemizedlist>
+      <listitem>
+       <para>
+        Command-line Enhancements
+       </para>
+       <itemizedlist>
+        <listitem>
+         <para>
+	  Add
+	  <option>--keep-files-open=<replaceable>[yn]</replaceable></option>
+	  to override default determination of whether to keep files
+	  open when merging. Please see the discussion of
+	  <option>--keep-files-open</option> in <xref
+	  linkend="ref.basic-options"/> for additional details.
+         </para>
+        </listitem>
+       </itemizedlist>
+      </listitem>
+     </itemizedlist>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
     <term>8.2.0: August 16, 2018</term>
     <listitem>
      <itemizedlist>