Commit e813176bc02c32e26e109a1b86333ae181cc0601

Authored by m-holger
Committed by Jay Berkenbilt
1 parent bc640370

Fix some doc typos

examples/pdf-custom-filter.cc
@@ -14,7 +14,7 @@ @@ -14,7 +14,7 @@
14 // uses the pattern of having the stream data provider class use a 14 // uses the pattern of having the stream data provider class use a
15 // second QPDF instance with copies of streams from the original QPDF 15 // second QPDF instance with copies of streams from the original QPDF
16 // so that the stream data provider can access the original stream 16 // so that the stream data provider can access the original stream
17 -// data. This is implement very efficiently inside the qpdf library as 17 +// data. This is implemented very efficiently inside the qpdf library as
18 // the second QPDF instance knows how to read the stream data from the 18 // the second QPDF instance knows how to read the stream data from the
19 // original input file, so no extra copies of the original stream data 19 // original input file, so no extra copies of the original stream data
20 // are made. 20 // are made.
@@ -196,7 +196,7 @@ class StreamReplacer: public QPDFObjectHandle::StreamDataProvider @@ -196,7 +196,7 @@ class StreamReplacer: public QPDFObjectHandle::StreamDataProvider
196 // pipeline and passes nullptr to dict_updates. In this mode, 196 // pipeline and passes nullptr to dict_updates. In this mode,
197 // the stream dictionary has already been altered, and the 197 // the stream dictionary has already been altered, and the
198 // original stream data is no longer directly accessible. Trying 198 // original stream data is no longer directly accessible. Trying
199 - // to retrieve the stream data would be an infinite loop because 199 + // to retrieve the stream data would cause an infinite loop because
200 // it would just end up calling provideStreamData again. This is 200 // it would just end up calling provideStreamData again. This is
201 // why maybeReplace uses a stashed copy of the original stream. 201 // why maybeReplace uses a stashed copy of the original stream.
202 202
generate_auto_job
@@ -54,7 +54,7 @@ from contextlib import contextmanager @@ -54,7 +54,7 @@ from contextlib import contextmanager
54 # developer or user can freely move among those different ways of 54 # developer or user can freely move among those different ways of
55 # interacting with QPDFJob in a predictable fashion. In addition, help 55 # interacting with QPDFJob in a predictable fashion. In addition, help
56 # information for each option appears in manual/cli.rst, and that 56 # information for each option appears in manual/cli.rst, and that
57 -# information is used in creation of the job JSON schema and to supply 57 +# information is used in the creation of the job JSON schema and to supply
58 # help text to QPDFArgParser. This code also ensures that there is an 58 # help text to QPDFArgParser. This code also ensures that there is an
59 # exact match between options in job.yml and options in cli.rst. 59 # exact match between options in job.yml and options in cli.rst.
60 # 60 #
@@ -170,7 +170,7 @@ class Main: @@ -170,7 +170,7 @@ class Main:
170 'json_init': 'libqpdf/qpdf/auto_job_json_init.hh', 170 'json_init': 'libqpdf/qpdf/auto_job_json_init.hh',
171 # Others are added in top 171 # Others are added in top
172 } 172 }
173 - # SUBS contains a checksum for each source and destination and is 173 + # SUMS contains a checksum for each source and destination and is
174 # used to detect whether we're up to date without having to force 174 # used to detect whether we're up to date without having to force
175 # recompilation all the time. This way the build can invoke this 175 # recompilation all the time. This way the build can invoke this
176 # script unconditionally without causing stuff to rebuild every 176 # script unconditionally without causing stuff to rebuild every
include/qpdf/JSON.hh
@@ -25,12 +25,12 @@ @@ -25,12 +25,12 @@
25 // This is a simple JSON serializer and parser, primarily designed for 25 // This is a simple JSON serializer and parser, primarily designed for
26 // serializing QPDF Objects as JSON. While it may work as a 26 // serializing QPDF Objects as JSON. While it may work as a
27 // general-purpose JSON parser/serializer, there are better options. 27 // general-purpose JSON parser/serializer, there are better options.
28 -// JSON objects contain their data as smart pointers. One JSON object 28 +// JSON objects contain their data as smart pointers. When one JSON object
29 // is added to another, this pointer is copied. This means you can 29 // is added to another, this pointer is copied. This means you can
30 // create temporary JSON objects on the stack, add them to other 30 // create temporary JSON objects on the stack, add them to other
31 // objects, and let them go out of scope safely. It also means that if 31 // objects, and let them go out of scope safely. It also means that if
32 -// the json JSON object is added in more than one place, all copies  
33 -// share underlying data. This makes them similar in structure and 32 +// a JSON object is added in more than one place, all copies
  33 +// share the underlying data. This makes them similar in structure and
34 // behavior to QPDFObjectHandle and may feel natural within the QPDF 34 // behavior to QPDFObjectHandle and may feel natural within the QPDF
35 // codebase, but it is also a good reason not to use this as a 35 // codebase, but it is also a good reason not to use this as a
36 // general-purpose JSON package. 36 // general-purpose JSON package.
@@ -105,7 +105,7 @@ class JSON @@ -105,7 +105,7 @@ class JSON
105 // 105 //
106 // * The schema is a nested structure containing dictionaries, 106 // * The schema is a nested structure containing dictionaries,
107 // single-element arrays, and strings only. 107 // single-element arrays, and strings only.
108 - // * Recursively walk the schema 108 + // * Recursively walk the schema.
109 // * If the current value is a dictionary, this object must have 109 // * If the current value is a dictionary, this object must have
110 // a dictionary in the same place with the same keys. If flags 110 // a dictionary in the same place with the same keys. If flags
111 // contains f_optional, a key in the schema does not have to 111 // contains f_optional, a key in the schema does not have to
include/qpdf/qpdfjob-c.h
@@ -56,7 +56,7 @@ extern "C" { @@ -56,7 +56,7 @@ extern "C" {
56 56
57 #ifndef QPDF_NO_WCHAR_T 57 #ifndef QPDF_NO_WCHAR_T
58 /* This function is the same as qpdfjob_run_from_argv except argv 58 /* This function is the same as qpdfjob_run_from_argv except argv
59 - * is encoded with wide characters. This would suitable for 59 + * is encoded with wide characters. This would be suitable for
60 * calling from a Windows wmain function. 60 * calling from a Windows wmain function.
61 */ 61 */
62 QPDF_DLL 62 QPDF_DLL
@@ -259,7 +259,7 @@ json: @@ -259,7 +259,7 @@ json:
259 # other information known by generate_auto_job. This information is 259 # other information known by generate_auto_job. This information is
260 # used to construct a "schema" (as in JSON.hh) for the json input to 260 # used to construct a "schema" (as in JSON.hh) for the json input to
261 # QPDFJob. The leading underscore is removed. *NOTE*: all keys are 261 # QPDFJob. The leading underscore is removed. *NOTE*: all keys are
262 - # converted to camelCase for the schema and must be appear that way 262 + # converted to camelCase for the schema and must appear that way
263 # in the user-supplied json. This makes it more convenient to 263 # in the user-supplied json. This makes it more convenient to
264 # populate JSON objects in some languages. 264 # populate JSON objects in some languages.
265 265