diff options
author | Jay Berkenbilt <ejb@ql.org> | 2021-12-10 21:52:00 +0100 |
---|---|---|
committer | Jay Berkenbilt <ejb@ql.org> | 2021-12-10 21:52:28 +0100 |
commit | 08bcf6449cc0ca37b2223eb8e204eaf5a52fb348 (patch) | |
tree | f79c55a7e261bd6e9a94e2579d18e4128b68d197 | |
parent | af2a71aa2c0ab7a441cb4210295e3912800df9d0 (diff) | |
download | qpdf-08bcf6449cc0ca37b2223eb8e204eaf5a52fb348.tar.zst |
Clarify docs around @filename and leading/trailing space
-rw-r--r-- | manual/qpdf-manual.xml | 14 | ||||
-rw-r--r-- | qpdf/qpdf.cc | 3 |
2 files changed, 10 insertions, 7 deletions
diff --git a/manual/qpdf-manual.xml b/manual/qpdf-manual.xml index 42b1d25c..8c133bce 100644 --- a/manual/qpdf-manual.xml +++ b/manual/qpdf-manual.xml @@ -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. diff --git a/qpdf/qpdf.cc b/qpdf/qpdf.cc index c336455b..c363c087 100644 --- a/qpdf/qpdf.cc +++ b/qpdf/qpdf.cc @@ -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" |