diff options
author | Jay Berkenbilt <ejb@ql.org> | 2022-06-18 20:16:56 +0200 |
---|---|---|
committer | Jay Berkenbilt <ejb@ql.org> | 2022-06-19 14:46:58 +0200 |
commit | 8e361d98f0bb23d58cbc773367ba76dffced7bdb (patch) | |
tree | c3c0aebbe88f51aa43c3eb8a586f8b795b8b5a45 /include | |
parent | 8130d50e3b5aa0235a133c3c5a3018ac01afb5e1 (diff) | |
download | qpdf-8e361d98f0bb23d58cbc773367ba76dffced7bdb.tar.zst |
Add examples for output capture (fixes #691)
Diffstat (limited to 'include')
-rw-r--r-- | include/qpdf/QPDFLogger.hh | 11 | ||||
-rw-r--r-- | include/qpdf/qpdflogger-c.h | 3 |
2 files changed, 13 insertions, 1 deletions
diff --git a/include/qpdf/QPDFLogger.hh b/include/qpdf/QPDFLogger.hh index 54ab7efe..655da668 100644 --- a/include/qpdf/QPDFLogger.hh +++ b/include/qpdf/QPDFLogger.hh @@ -56,6 +56,10 @@ class QPDFLogger // error -- standard error // save -- undefined unless set // + // "info" is used for diagnostic messages, verbose messages, and + // progress messages. "warn" is used for warnings. "error" is used + // for errors. "save" is used for saving output -- see below. + // // On deletion, finish() is called for the standard output and // standard error pipelines, which flushes output. If you supply // any custom pipelines, you must call finish() on them yourself. @@ -64,6 +68,13 @@ class QPDFLogger // // NOTES ABOUT THE SAVE PIPELINE // + // The save pipeline is used by QPDFJob when some kind of binary + // output is being saved. This includes saving attachments and + // stream data and also includes when the output file is standard + // output. If you want to grab that output, you can call setSave. + // See examples/qpdfjob-save-attachment.cc and + // examples/qpdfjob-c-save-attachment.c. + // // You should never set the save pipeline to the same destination // as something else. Doing so will corrupt your save output. If // you want to save to standard output, use the method diff --git a/include/qpdf/qpdflogger-c.h b/include/qpdf/qpdflogger-c.h index 9d31f79c..10ab5bb0 100644 --- a/include/qpdf/qpdflogger-c.h +++ b/include/qpdf/qpdflogger-c.h @@ -25,7 +25,8 @@ /* * This file provides a C API for QPDFLogger. See QPDFLogger.hh for - * information about the logger. + * information about the logger and + * examples/qpdfjob-c-save-attachment.c for an example. */ #include <qpdf/DLL.h> |