mirror of
https://github.com/qpdf/qpdf.git
synced 2024-06-03 10:50:53 +00:00
Clarify docs around @filename and leading/trailing space
This commit is contained in:
parent
af2a71aa2c
commit
08bcf6449c
|
@ -573,12 +573,14 @@ make
|
||||||
<para>
|
<para>
|
||||||
If <option>@filename</option> appears as a word anywhere in the
|
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
|
command-line, it will be read line by line, and each line will be
|
||||||
treated as a command-line argument. The <option>@-</option> option
|
treated as a command-line argument. Leading and trailing
|
||||||
allows arguments to be read from standard input. This allows qpdf
|
whitespace is intentionally not removed from lines, which makes it
|
||||||
to be invoked with an arbitrary number of arbitrarily long
|
possible to handle arguments that start or end with spaces. The
|
||||||
arguments. It is also very useful for avoiding having to pass
|
<option>@-</option> option allows arguments to be read from
|
||||||
passwords on the command line. Note that the
|
standard input. This allows qpdf to be invoked with an arbitrary
|
||||||
<option>@filename</option> can't appear in the middle of an
|
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>
|
argument, so constructs such as <option>--arg=@option</option>
|
||||||
will not work. You would have to include the argument and its
|
will not work. You would have to include the argument and its
|
||||||
options together in the arguments file.
|
options together in the arguments file.
|
||||||
|
|
|
@ -1340,7 +1340,8 @@ ArgParser::argHelp()
|
||||||
<< "\n"
|
<< "\n"
|
||||||
<< "If @filename appears anywhere in the command-line, each line of filename\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"
|
<< "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"
|
<< "\n"
|
||||||
<< "The output file can be - to indicate writing to standard output, or it can\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"
|
<< "be --replace-input to cause qpdf to replace the input file with the output.\n"
|
||||||
|
|
Loading…
Reference in New Issue
Block a user