summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--include/qpdf/Pipeline.hh8
1 files changed, 7 insertions, 1 deletions
diff --git a/include/qpdf/Pipeline.hh b/include/qpdf/Pipeline.hh
index 2de17ad2..41b7a290 100644
--- a/include/qpdf/Pipeline.hh
+++ b/include/qpdf/Pipeline.hh
@@ -44,7 +44,13 @@ class Pipeline
// Subclasses should implement write and finish to do their jobs
// and then, if they are not end-of-line pipelines, call
- // getNext()->write or getNext()->finish.
+ // getNext()->write or getNext()->finish. It would be really nice
+ // if write could take unsigned char const*, but this would make
+ // it much more difficult to write pipelines around legacy
+ // interfaces whose calls don't want pointers to const data. As a
+ // rule, pipelines should generally not be modifying the data
+ // passed to them. They should, instead, create new data to pass
+ // downstream.
QPDF_DLL
virtual void write(unsigned char* data, size_t len) = 0;
QPDF_DLL