From 4fe2e06b4787ffb639f965ac840b51018308ec07 Mon Sep 17 00:00:00 2001
From: Jay Berkenbilt <ejb@ql.org>
Date: Sun, 8 May 2022 13:42:16 -0400
Subject: Add --create-from-json and --update-from-json arguments

Also add stubs for top-level QPDF methods (createFromJSON,
updateFromJSON)
---
 manual/cli.rst  | 25 +++++++++++++++++++++++++
 manual/json.rst |  7 +++++++
 2 files changed, 32 insertions(+)

(limited to 'manual')

diff --git a/manual/cli.rst b/manual/cli.rst
index 92194e78..57a164cb 100644
--- a/manual/cli.rst
+++ b/manual/cli.rst
@@ -3270,6 +3270,31 @@ Related Options
    :samp:`-{nnn}` to create the name of the file that will contain the
    data for the stream stream in object :samp:`{nnn}`.
 
+.. qpdf:option:: --create-from-json=qpdf-json-file
+
+   .. help: create PDF from qpdf JSON
+
+      Create a PDF file from the prior output of qpdf --json. See the
+      "QPDF JSON Format" section of the manual for information about
+      how to use this option.
+
+   This option creates a PDF file from the previous output of ``qpdf
+   --json`` that includes stream data and information about all
+   objects. For information about converting between PDF and JSON,
+   please see :ref:`qpdf-json`.
+
+.. qpdf:option:: --update-from-json=qpdf-json-file
+
+   .. help: update a PDF from qpdf JSON
+
+      Update a PDF file from a JSON file. Please see the "QPDF JSON
+      Format" section of the manual for information about how to use
+      this option.
+
+   This option updates a PDF file from a qpdf JSON file. For a
+   information about how to use this option, please see
+   :ref:`qpdf-json`.
+
 .. _test-options:
 
 Options for Testing or Debugging
diff --git a/manual/json.rst b/manual/json.rst
index ef6bed96..a3922051 100644
--- a/manual/json.rst
+++ b/manual/json.rst
@@ -18,6 +18,13 @@ files programmatically from the command-line in languages that can't
 call or link with the qpdf library directly. Note that stream data can
 be extracted from PDF files using other qpdf command-line options.
 
+.. _qpdf-json:
+
+QPDF JSON Format
+----------------
+
+QXXXQ Write this.
+
 .. _json-guarantees:
 
 JSON Guarantees
-- 
cgit v1.2.3-54-g00ecf