From 9ad6cfd45bbd84d85509327447bee6e9dcaa56c5 Mon Sep 17 00:00:00 2001 From: Jay Berkenbilt Date: Tue, 19 Jan 2021 08:54:47 -0500 Subject: Clarify qpdf_register_progress_reporter's comment --- include/qpdf/qpdf-c.h | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/include/qpdf/qpdf-c.h b/include/qpdf/qpdf-c.h index 4127ef39..e917e90a 100644 --- a/include/qpdf/qpdf-c.h +++ b/include/qpdf/qpdf-c.h @@ -471,7 +471,11 @@ extern "C" { * a value between 0 and 100 representing the approximate write * progress. The data object you pass to * qpdf_register_progress_reporter will be handed back to your - * function. + * function. This function must be called after qpdf_init_write + * (or qpdf_init_write_memory) and before qpdf_write. The + * registered progress reporter applies only to a single write, so + * you must call it again if you perform a subsequent write with a + * new writer. */ QPDF_DLL void qpdf_register_progress_reporter( -- cgit v1.2.3-54-g00ecf