From e5cec314bc074a7a4eb5328cf29bfe5f9ee4e887 Mon Sep 17 00:00:00 2001
From: Jay Berkenbilt <ejb@ql.org>
Date: Sat, 9 Nov 2019 12:07:13 -0500
Subject: [PATCH] Update release notes for crypto providers

---
 manual/qpdf-manual.xml | 75 ++++++++++++++++++++++++++++--------------
 1 file changed, 51 insertions(+), 24 deletions(-)

diff --git a/manual/qpdf-manual.xml b/manual/qpdf-manual.xml
index 37ced827..0420ad33 100644
--- a/manual/qpdf-manual.xml
+++ b/manual/qpdf-manual.xml
@@ -4606,32 +4606,59 @@ print "\n";
      <itemizedlist>
       <listitem>
        <para>
-         Library Enhancements
+        Library Enhancements
        </para>
        <itemizedlist>
-         <listitem>
-           <para>
-             Incorporate contribution from Masamichi Hosoda to
-             properly handle signature dictionaries by not including
-             them in object streams, formatting the
-             <literal>/Contents</literal> key has a hexadecimal
-             string, and excluding the <literal>/Contents</literal>
-             key from encryption and decryption.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Incorporate contribution from Masamichi Hosoda to provide
-             new API calls for getting file-level information about
-             input and output files, enabling certain operations on
-             the files at the file level rather than the object level.
-             New methods include
-             <function>QPDF::getXRefTable()</function>,
-             <function>QPDFObjectHandle::getParsedOffset()</function>,
-             <function>QPDFWriter::getRenumberedObjGen(QPDFObjGen)</function>,
-             and <function>QPDFWriter::getWrittenXRefTable()</function>.
-           </para>
-         </listitem>
+        <listitem>
+         <para>
+          Incorporate contribution from Masamichi Hosoda to properly
+          handle signature dictionaries by not including them in
+          object streams, formatting the <literal>Contents</literal>
+          key has a hexadecimal string, and excluding the
+          <literal>/Contents</literal> key from encryption and
+          decryption.
+         </para>
+        </listitem>
+        <listitem>
+         <para>
+          Incorporate contribution from Masamichi Hosoda to provide
+          new API calls for getting file-level information about
+          input and output files, enabling certain operations on
+          the files at the file level rather than the object level.
+          New methods include
+          <function>QPDF::getXRefTable()</function>,
+          <function>QPDFObjectHandle::getParsedOffset()</function>,
+          <function>QPDFWriter::getRenumberedObjGen(QPDFObjGen)</function>,
+          and <function>QPDFWriter::getWrittenXRefTable()</function>.
+         </para>
+        </listitem>
+        <listitem>
+         <para>
+          Support build-time and runtime selectable crypto providers.
+          This includes the addition of new classes
+          <classname>QPDFCryptoProvider</classname> and
+          <classname>QPDFCryptoImpl</classname> and the recognition
+          of the <literal>QPDF_CRYPTO_PROVIDER</literal> environment
+          variable. Crypto providers are described in depth in <xref
+          linkend="ref.crypto"/>.
+         </para>
+        </listitem>
+       </itemizedlist>
+      </listitem>
+     </itemizedlist>
+     <itemizedlist>
+      <listitem>
+       <para>
+        CLI Enhancements
+       </para>
+       <itemizedlist>
+        <listitem>
+         <para>
+          Addition of the <option>--show-crypto</option> option in
+          support of selectable crypto providers, as described in
+          <xref linkend="ref.crypto"/>.
+         </para>
+        </listitem>
        </itemizedlist>
       </listitem>
      </itemizedlist>