octoleo
/
qpdf
mirror of https://github.com/qpdf/qpdf.git
2
1
Fork 0
Code Issues Releases Wiki Activity

Clarify docs around @filename and leading/trailing space

This commit is contained in:
Jay Berkenbilt 2021-12-10 15:52:00 -05:00
parent af2a71aa2c
commit 08bcf6449c
2 changed files with 10 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
manual/qpdf-manual.xml
View File

@ -573,12 +573,14 @@ make
<para>
If <option>@filename</option> appears as a word anywhere in the
command-line, it will be read line by line, and each line will be
treated as a command-line argument. The <option>@-</option> option
allows arguments to be read from standard input. This allows qpdf
to be invoked with an arbitrary number of arbitrarily long
arguments. It is also very useful for avoiding having to pass
passwords on the command line. Note that the
<option>@filename</option> can't appear in the middle of an
treated as a command-line argument. Leading and trailing
whitespace is intentionally not removed from lines, which makes it
possible to handle arguments that start or end with spaces. The
<option>@-</option> option allows arguments to be read from
standard input. This allows qpdf to be invoked with an arbitrary
number of arbitrarily long arguments. It is also very useful for
avoiding having to pass passwords on the command line. Note that
the <option>@filename</option> can't appear in the middle of an
argument, so constructs such as <option>--arg=@option</option>
will not work. You would have to include the argument and its
options together in the arguments file.

3
qpdf/qpdf.cc
View File

@ -1340,7 +1340,8 @@ ArgParser::argHelp()
<< "\n"
<< "If @filename appears anywhere in the command-line, each line of filename\n"
<< "will be interpreted as an argument. No interpolation is done. Line\n"
<< "terminators are stripped. @- can be specified to read from standard input.\n"
<< "terminators are stripped, but leading and trailing whitespace is\n"
<< "intentionally preserved. @- can be specified to read from standard input.\n"
<< "\n"
<< "The output file can be - to indicate writing to standard output, or it can\n"
<< "be --replace-input to cause qpdf to replace the input file with the output.\n"