aboutsummaryrefslogtreecommitdiffstats
path: root/manual/qpdf-job.rst
diff options
context:
space:
mode:
authorJay Berkenbilt <ejb@ql.org>2022-02-05 21:32:53 +0100
committerJay Berkenbilt <ejb@ql.org>2022-02-05 21:41:22 +0100
commiteb481eb698947d88be0724e84f518a70a0468cc9 (patch)
tree45fb1acb4c16ab0e9c30780af885fd0d7994db1a /manual/qpdf-job.rst
parentc95f02115c11c1dd16eec6cc806ba2788d9b39bc (diff)
downloadqpdf-eb481eb698947d88be0724e84f518a70a0468cc9.tar.zst
Prepare release notes for 10.6 (so far)
Diffstat (limited to 'manual/qpdf-job.rst')
-rw-r--r--manual/qpdf-job.rst12
1 files changed, 11 insertions, 1 deletions
diff --git a/manual/qpdf-job.rst b/manual/qpdf-job.rst
index 5fd8b37b..d464ef64 100644
--- a/manual/qpdf-job.rst
+++ b/manual/qpdf-job.rst
@@ -14,7 +14,10 @@ executable is available from inside the C++ library using the
- Use from the C++ API with ``QPDFJob::initializeFromArgv``
- - Use from the C API with ``qpdfjob_run_from_argv`` from :file:`qpdfjob-c.h`
+ - Use from the C API with ``qpdfjob_run_from_argv`` from
+ :file:`qpdfjob-c.h`. If you are calling from a Windows-style main
+ and have an argv array of ``wchar_t``, you can use
+ ``qpdfjob_run_from_wide_argv``.
- The job JSON file format
@@ -135,6 +138,13 @@ C++ code:
return 0;
}
+Note the ``QPDFUsage`` exception above. This is thrown whenever a
+configuration error occurs. These exactly correspond to usage messages
+issued by the :command:`qpdf` CLI for things like omitting an output
+file, specifying `--pages` multiple times, or other invalid
+combinations of options. ``QPDFUsage`` is thrown by the argv and JSON
+interfaces as well as the native ``QPDFJob`` interface.
+
It is also possible to mix and match command-line options and JSON
from the CLI. For example, you could create a file called
:file:`my-options.json` containing the following: