Change release notes order

1 files changed, 116 insertions, 109 deletions

diff --git a/manual/qpdf-manual.xml b/manual/qpdf-manual.xml
index c1ac5e15..4f3b54ae 100644
--- a/manual/qpdf-manual.xml
+++ b/manual/qpdf-manual.xml
@@ -4416,111 +4416,32 @@ print "\n";
       </listitem>
       <listitem>
        <para>
-        Bug Fixes
-       </para>
-       <itemizedlist>
-        <listitem>
-         <para>
-          A small handful of memory issues, assertion failures, and
-          unhandled exceptions that could occur on badly mangled input
-          files have been fixed. Most of these problems were found by
-          Google's OSS-Fuzz project.
-         </para>
-        </listitem>
-        <listitem>
-         <para>
-          When <command>qpdf --check</command> or <command>qpdf
-          --check-linearization</command> encounters a file with
-          linearization warnings but not errors, it now properly exits
-          with exit code 3 instead of 2.
-         </para>
-        </listitem>
-        <listitem>
-         <para>
-          The <option>--completion-bash</option> and
-          <option>--completion-zsh</option> options now work properly
-          when qpdf is invoked as an AppImage.
-         </para>
-        </listitem>
-        <listitem>
-         <para>
-          Calling
-          <function>QPDFWriter::set*EncryptionParameters</function> on
-          a <classname>QPDFWriter</classname> object whose output
-          filename has not yet been set no longer produces a
-          segmentation fault.
-         </para>
-        </listitem>
-        <listitem>
-         <para>
-          When reading encrypted files, follow the spec more closely
-          regarding encryption key length. This allows qpdf to open
-          encrypted files in most cases when they have invalid or
-          missing /Length keys in the encryption dictionary.
-         </para>
-        </listitem>
-        <listitem>
-         <para>
-          When <command>qpdf --check</command> or <command>qpdf
-          --check-linearization</command> encounters a file with
-          linearization warnings but not errors, it now properly exits
-          with exit code 3 instead of 2.
-         </para>
-        </listitem>
-       </itemizedlist>
-      </listitem>
-      <listitem>
-       <para>
-        Build Changes
+        CLI Enhancements
        </para>
        <itemizedlist>
         <listitem>
          <para>
-          On platforms that support it, qpdf now builds with
-          <option>-fvisibility=hidden</option>. If you build qpdf with
-          your own build system, this is now safe to use. This
-          prevents methods that are not part of the public API from
-          being exported by the shared library, and makes qpdf's ELF
-          shared libraries (used on Linux, MacOS, and most other UNIX
-          flavors) behave more like the Windows DLL. Since the DLL
-          already behaves in much this way, it is unlikely that there
-          are any methods that were accidentally not exported.
-          However, with ELF shared libraries, typeinfo for some
-          classes has to be explicitly exported. If there are problems
-          in dynamically linked code catching exceptions or
-          subclassing, this could be the reason. If you see this,
-          please report a bug at <ulink
-          url="https://github.com/qpdf/qpdf/issues/">pikepdf</ulink>.
-         </para>
-        </listitem>
-        <listitem>
-         <para>
-          QPDF is now compiled with integer conversion and sign
-          conversion warnings enabled. Numerous changes were made to
-          the library to make this safe.
-         </para>
-        </listitem>
-        <listitem>
-         <para>
-          QPDF's <command>make install</command> target explicitly
-          specifies the mode to use when installing files instead of
-          relying the user's umask. It was previously doing this for
-          some files but not others.
+          The <option>--recompress-flate</option> instructs
+          <command>qpdf</command> to recompress streams that are
+          already compressed with <literal>/FlateDecode</literal>.
+          Useful with <option>--compression-level</option>.
          </para>
         </listitem>
         <listitem>
          <para>
-          If <command>pkg-config</command> is available, use it to
-          locate <filename>libjpeg</filename> and
-          <filename>zlib</filename> dependencies, falling back on old
-          behavior if unsuccessful.
+          the
+          <option>--compression-level=<replaceable>level</replaceable></option>
+          sets the zlib compression level used for any streams
+          compressed by <literal>/FlateDecode</literal>. Most
+          effective when combined with
+          <option>--recompress-flate</option>.
          </para>
         </listitem>
        </itemizedlist>
       </listitem>
       <listitem>
        <para>
-        Library and CLI Enhancements
+        Library Enhancements
        </para>
        <itemizedlist>
         <listitem>
@@ -4609,24 +4530,6 @@ print "\n";
         </listitem>
         <listitem>
          <para>
-          CLI enhancement: the <option>--recompress-flate</option>
-          instructs <command>qpdf</command> to recompress streams that
-          are already compressed with <literal>/FlateDecode</literal>.
-          Useful with <option>--compression-level</option>.
-         </para>
-        </listitem>
-        <listitem>
-         <para>
-          CLI enhancement: the
-          <option>--compression-level=<replaceable>level</replaceable></option>
-          sets the zlib compression level used for any streams
-          compressed by <literal>/FlateDecode</literal>. Most
-          effective when combined with
-          <option>--recompress-flate</option>.
-         </para>
-        </listitem>
-        <listitem>
-         <para>
           The underlying implementation of QPDF arrays has been
           enhanced to be much more memory efficient when dealing with
           arrays with lots of nulls. This enables qpdf to use
@@ -4668,6 +4571,110 @@ print "\n";
       </listitem>
       <listitem>
        <para>
+        Bug Fixes
+       </para>
+       <itemizedlist>
+        <listitem>
+         <para>
+          A small handful of memory issues, assertion failures, and
+          unhandled exceptions that could occur on badly mangled input
+          files have been fixed. Most of these problems were found by
+          Google's OSS-Fuzz project.
+         </para>
+        </listitem>
+        <listitem>
+         <para>
+          When <command>qpdf --check</command> or <command>qpdf
+          --check-linearization</command> encounters a file with
+          linearization warnings but not errors, it now properly exits
+          with exit code 3 instead of 2.
+         </para>
+        </listitem>
+        <listitem>
+         <para>
+          The <option>--completion-bash</option> and
+          <option>--completion-zsh</option> options now work properly
+          when qpdf is invoked as an AppImage.
+         </para>
+        </listitem>
+        <listitem>
+         <para>
+          Calling
+          <function>QPDFWriter::set*EncryptionParameters</function> on
+          a <classname>QPDFWriter</classname> object whose output
+          filename has not yet been set no longer produces a
+          segmentation fault.
+         </para>
+        </listitem>
+        <listitem>
+         <para>
+          When reading encrypted files, follow the spec more closely
+          regarding encryption key length. This allows qpdf to open
+          encrypted files in most cases when they have invalid or
+          missing /Length keys in the encryption dictionary.
+         </para>
+        </listitem>
+        <listitem>
+         <para>
+          When <command>qpdf --check</command> or <command>qpdf
+          --check-linearization</command> encounters a file with
+          linearization warnings but not errors, it now properly exits
+          with exit code 3 instead of 2.
+         </para>
+        </listitem>
+       </itemizedlist>
+      </listitem>
+      <listitem>
+       <para>
+        Build Changes
+       </para>
+       <itemizedlist>
+        <listitem>
+         <para>
+          On platforms that support it, qpdf now builds with
+          <option>-fvisibility=hidden</option>. If you build qpdf with
+          your own build system, this is now safe to use. This
+          prevents methods that are not part of the public API from
+          being exported by the shared library, and makes qpdf's ELF
+          shared libraries (used on Linux, MacOS, and most other UNIX
+          flavors) behave more like the Windows DLL. Since the DLL
+          already behaves in much this way, it is unlikely that there
+          are any methods that were accidentally not exported.
+          However, with ELF shared libraries, typeinfo for some
+          classes has to be explicitly exported. If there are problems
+          in dynamically linked code catching exceptions or
+          subclassing, this could be the reason. If you see this,
+          please report a bug at <ulink
+          url="https://github.com/qpdf/qpdf/issues/">pikepdf</ulink>.
+         </para>
+        </listitem>
+        <listitem>
+         <para>
+          QPDF is now compiled with integer conversion and sign
+          conversion warnings enabled. Numerous changes were made to
+          the library to make this safe.
+         </para>
+        </listitem>
+        <listitem>
+         <para>
+          QPDF's <command>make install</command> target explicitly
+          specifies the mode to use when installing files instead of
+          relying the user's umask. It was previously doing this for
+          some files but not others.
+         </para>
+        </listitem>
+        <listitem>
+         <para>
+          If <command>pkg-config</command> is available, use it to
+          locate <filename>libjpeg</filename> and
+          <filename>zlib</filename> dependencies, falling back on old
+          behavior if unsuccessful.
+         </para>
+        </listitem>
+       </itemizedlist>
+      </listitem>
+      <listitem>
+       <para>
         Other Notes
        </para>
        <itemizedlist>