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 /manual/qpdf-manual.xml | |
parent | af2a71aa2c0ab7a441cb4210295e3912800df9d0 (diff) | |
download | qpdf-08bcf6449cc0ca37b2223eb8e204eaf5a52fb348.tar.zst |
Clarify docs around @filename and leading/trailing space
Diffstat (limited to 'manual/qpdf-manual.xml')
-rw-r--r-- | manual/qpdf-manual.xml | 14 |
1 files changed, 8 insertions, 6 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. |