Jay Berkenbilt
a372a988fd
Switch build from docbook manual to sphinx
...
Also remove linearization from qpdf-manual.pdf. It's a small file, and
removing the dependency on the qpdf executable significantly shortens
build times.
2021-12-13 11:16:21 -05:00
Jay Berkenbilt
abb6a16ed1
Insert output of pandoc as is
...
pandoc -f docbook -t rst qpdf-manual.xml >| /tmp/a.rst
Insert /tmp/a.rst into existing index.rst
2021-12-12 16:29:13 -05:00
Jay Berkenbilt
22d53f928f
Sphinx docs: tweak output of sphinx-quickstart
2021-12-12 16:29:13 -05:00
Jay Berkenbilt
f8787d9fd8
Create initial sphinx document sources
...
Run sphinx-quickstart. Throw everything away except conf.py and
index.rst. We will incorporate this into our own build system.
2021-12-12 16:29:13 -05:00
Jay Berkenbilt
9a5d16a403
Prepare for docbook -> rst: replace SGML entitles
...
We were using SGML entities for various non-ASCII characters so they
could convert properly for both HTML and print, but this is no longer
necessary as we move from docbook to RST, so just replace them. Note
that the conversions done by sphinx automatically handle "smart
quotes", so it works to just use regular quotes in place of “
and ”.
2021-12-12 16:29:13 -05:00
Jay Berkenbilt
f80a0da3e3
Prepare for docbook -> rst: protect a comment so it survives pandoc
2021-12-12 16:29:13 -05:00
Jay Berkenbilt
78206a4651
Prepare for docbook -> rst: protect some XML elements
...
Pandoc docbook -> rst fails to convert the following elements, so
change them to @1@tag@1@ ... @2@tag@2@ for later processing. This way,
they will survive the conversion, and we can deal with them later.
<application>
<command>
<filename>
<firstterm>
<option>
<replaceable>
2021-12-12 16:29:13 -05:00
Jay Berkenbilt
f721fed9d6
doc: Replace Gajic with Gajić (finally)
...
With docbook, this was not converted properly in the PDF version, but
since we are moving out of docbook, we can just put the Unicode
character in the source.
2021-12-12 16:29:13 -05:00
Jay Berkenbilt
8aa9a66e63
doc: remove unneeded footnote
...
Footnotes are yucky in online documentation, and the one footnote in
the doc is no longer needed, so remove it.
2021-12-12 16:29:13 -05:00
Jay Berkenbilt
e5c2bd8b14
TODO: doc conversion notes
...
Make a list of things that need to be done while converting docbook to
sphinx/rst.
2021-12-12 16:29:13 -05:00
Jay Berkenbilt
29384ecace
TODO
2021-12-12 14:58:22 -05:00
Jay Berkenbilt
08bcf6449c
Clarify docs around @filename and leading/trailing space
2021-12-10 15:52:28 -05:00
Jay Berkenbilt
af2a71aa2c
Handle bitstream overflow errors more gracefully ( fixes #581 )
...
* Make it a runtime error, not a logic error
* Include additional information
* Capture it properly in checkLinearization
2021-12-10 15:37:35 -05:00
Jay Berkenbilt
1c62c2a342
C API: expose functions for indirect objects ( fixes #588 )
2021-12-10 14:57:35 -05:00
Jay Berkenbilt
8e0b153332
Expose QPDFObjectHandle::addTokenFilter ( fixes #580 )
2021-12-10 13:37:07 -05:00
Jay Berkenbilt
72c10d8617
C API: overhaul error handling
...
* Handle error conditions that occur when using the object handle
interfaces. In the past, some exceptions were not correctly
converted to errors or warnings.
* Add more detailed information to qpdf-c.h
* Make it possible to work more explicitly with uninitialized objects
2021-12-10 12:16:02 -05:00
Jay Berkenbilt
3340dbe976
Use a specific error code for type warnings and clarify docs
2021-12-10 11:15:49 -05:00
Jay Berkenbilt
b2b2a175c4
Add missing unit test for register progress reporter in C API
...
It was exercised in the pdf-linearize example but not in qpdf-ctest.
2021-12-10 09:11:56 -05:00
Jay Berkenbilt
09f3737202
Split qpdf-ctest test 24 into multiple tests
...
Thanks for the nudge from m-holger!
2021-12-09 15:21:19 -05:00
Jay Berkenbilt
c5708e9180
Update ABI note about fluent interfaces
2021-12-09 10:33:31 -05:00
Jay Berkenbilt
8acb79fc5e
Remove notes on safe QPDFObjectHandle -- not worth doing
...
The impact on the code would be extremely high, and using it would
clutter the code greatly because it would break chaining like
a.getKey("/B").getKey("/C"). There are better ways to deal with the
issue.
2021-12-09 10:33:31 -05:00
Jay Berkenbilt
1faa21502f
Refactor trap_errors to use std::function
2021-12-09 10:33:31 -05:00
Jay Berkenbilt
a144363653
Add changelog and release note for #587
2021-12-09 10:33:31 -05:00
Jay Berkenbilt
e3cc171d02
C API: qpdf_oh_is_initialized
2021-12-09 10:33:31 -05:00
Jay Berkenbilt
bef2c2222a
C API: qpdf_get_last_string_length
2021-12-09 10:33:31 -05:00
Jay Berkenbilt
73d70902e0
Typos in comments
2021-12-09 10:33:31 -05:00
Jay Berkenbilt
c75577f9d6
Apply spell check to qpdf .h files
2021-12-09 10:25:46 -05:00
m-holger
0c705a882b
Minor documentation updates
2021-12-09 10:24:14 -05:00
m-holger
b4fc9eb700
C-API expose new_object as qpdf_oh_new_object
2021-12-02 13:59:58 -05:00
Jay Berkenbilt
720ce9e8f3
Improve testing and error handling around operating before processing
2021-11-29 07:42:36 -05:00
Jay Berkenbilt
ac17308cf6
Initialize QPDF::Members::file ( fixes #584 )
2021-11-29 07:16:34 -05:00
Jay Berkenbilt
67b0dbe65f
Note about C API enhancement for string length
2021-11-23 16:01:03 -05:00
Jay Berkenbilt
52d6fcf1de
Notes on possible safe QPDFObjectHandle
2021-11-22 17:56:20 -05:00
Jay Berkenbilt
52f1721ebb
Add reminder about trap_errors when updating the C API
2021-11-22 17:56:11 -05:00
Jay Berkenbilt
a63623adce
Update notes on API changes for weak crypto
2021-11-19 15:20:12 -05:00
Jay Berkenbilt
f9fc57d24c
Cosmetic fixes to maintainer notes
2021-11-19 15:20:12 -05:00
Jay Berkenbilt
b97a43e091
Add additional testing around improved array wrapping
2021-11-19 13:33:10 -05:00
m-holger
4630b8567c
Ensure qpdf_oh handles returned by C-API functions are unique.
...
Return new qpdf_oh from qpdf_oh_wrap_in_array when input is already an array.
Update some doc comments in qpdf-c.h.
2021-11-19 13:31:59 +00:00
Jay Berkenbilt
ce7db05d22
Prepare 10.4.0 release
2021-11-16 15:44:09 -05:00
Jay Berkenbilt
07ebfb74f9
Update master -> main in maintainer documentation
2021-11-16 15:44:09 -05:00
Jay Berkenbilt
88a4830015
Spell check
2021-11-16 15:15:48 -05:00
Jay Berkenbilt
750aca5b94
First increment of improving handling of weak crypto ( fixes #358 )
2021-11-11 12:24:15 -05:00
Sven Neuhaus
37916f3925
Fix typo in manual
...
Fix typo in --rotate example
2021-11-08 10:28:14 -05:00
Jay Berkenbilt
f45dacf4cb
Make recovery logic flexible about where objects end ( fixes #573 )
...
Don't assume endobj is at the beginning of the line. This means we are
looking at tokens for every line, but the odds of n n obj appearing in
the middle of the object are likely much lower than endobj not being
at the beginning of the line or missing entirely. This will probably
have a negative impact on recovery time for very large files.
Hopefully it will be worth it.
2021-11-07 15:27:22 -05:00
Jay Berkenbilt
0a71750ee8
Remove master from github workflows
...
Main branch is `main` now
2021-11-07 15:27:22 -05:00
Jay Berkenbilt
8c32f91149
Mention OpenSSL 3 for Windows
2021-11-05 12:58:57 -04:00
Jay Berkenbilt
ecfb3a8606
Fix typo in documentation ( fixes #572 )
...
Thanks @neuhaus!
2021-11-05 11:22:25 -04:00
Jay Berkenbilt
3794f8e2ad
Support OpenSSL 3 ( fixes #568 )
2021-11-04 18:24:54 -04:00
Jay Berkenbilt
043779187e
When specifying pc_*_CFLAGS, use with C++ files as well
2021-11-04 18:24:54 -04:00
Jay Berkenbilt
5eac6c500c
TODO: update fuzz case information
2021-11-04 14:03:24 -04:00