diff options
author | Jay Berkenbilt <ejb@ql.org> | 2022-02-05 21:32:53 +0100 |
---|---|---|
committer | Jay Berkenbilt <ejb@ql.org> | 2022-02-05 21:41:22 +0100 |
commit | eb481eb698947d88be0724e84f518a70a0468cc9 (patch) | |
tree | 45fb1acb4c16ab0e9c30780af885fd0d7994db1a /manual/qpdf-job.rst | |
parent | c95f02115c11c1dd16eec6cc806ba2788d9b39bc (diff) | |
download | qpdf-eb481eb698947d88be0724e84f518a70a0468cc9.tar.zst |
Prepare release notes for 10.6 (so far)
Diffstat (limited to 'manual/qpdf-job.rst')
-rw-r--r-- | manual/qpdf-job.rst | 12 |
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: |