From e1271361c59085fc68d75e37faae99f4e595b73e Mon Sep 17 00:00:00 2001 From: Jay Berkenbilt Date: Sat, 19 Jan 2019 15:58:43 -0500 Subject: Add documentation for features since 8.3.0 --- include/qpdf/QPDFWriter.hh | 10 ++++++++++ 1 file changed, 10 insertions(+) (limited to 'include') diff --git a/include/qpdf/QPDFWriter.hh b/include/qpdf/QPDFWriter.hh index 885a3630..1aa4e8a8 100644 --- a/include/qpdf/QPDFWriter.hh +++ b/include/qpdf/QPDFWriter.hh @@ -343,6 +343,16 @@ class QPDFWriter // setting R4 parameters pushes the version to at least 1.5, or if // AES is used, 1.6, and setting R5 or R6 parameters pushes the // version to at least 1.7 with extension level 3. + // + // Note about Unicode passwords: the PDF specification requires + // passwords to be encoded with PDF Doc encoding for R <= 4 and + // UTF-8 for R >= 5. In all cases, these methods take strings of + // bytes as passwords. It is up to the caller to ensure that + // passwords are properly encoded. The qpdf command-line tool + // tries to do this, as discussed in the manual. If you are doing + // this from your own application, QUtil contains many transcoding + // functions that could be useful to you, most notably + // utf8_to_pdf_doc. QPDF_DLL void setR3EncryptionParameters( char const* user_password, char const* owner_password, -- cgit v1.2.3-70-g09d2