Mention -n in IO-section and for input/inputs
This commit is contained in:
1 parent
c4d39c4d22
commit
f2ad9517c7
1 file changed
+10
-2
@@ -2924,7 +2924,9 @@ sections:
|
|||||||
are provided for this, `input` and `inputs`, that read from the
|
are provided for this, `input` and `inputs`, that read from the
|
||||||
same sources (e.g., `stdin`, files named on the command-line) as
|
same sources (e.g., `stdin`, files named on the command-line) as
|
||||||
jq itself. These two builtins, and jq's own reading actions, can
|
jq itself. These two builtins, and jq's own reading actions, can
|
||||||
be interleaved with each other.
|
be interleaved with each other. They are commonly used in combination
|
||||||
|
with the null input option `-n` to prevent one input from being read
|
||||||
|
implicitly.
|
||||||
|
|
||||||
Two builtins provide minimal output capabilities, `debug`, and
|
Two builtins provide minimal output capabilities, `debug`, and
|
||||||
`stderr`. (Recall that a jq program's output values are always
|
`stderr`. (Recall that a jq program's output values are always
|
||||||
@@ -2944,13 +2946,19 @@ sections:
|
|||||||
|
|
||||||
Outputs one new input.
|
Outputs one new input.
|
||||||
|
|
||||||
|
Note that when using `input` it is generally be necessary to
|
||||||
|
invoke jq with the -n command-line option, otherwise
|
||||||
|
the first entity will be lost.
|
||||||
|
|
||||||
- title: "`inputs`"
|
- title: "`inputs`"
|
||||||
body: |
|
body: |
|
||||||
|
|
||||||
Outputs all remaining inputs, one by one.
|
Outputs all remaining inputs, one by one.
|
||||||
|
|
||||||
This is primarily useful for reductions over a program's
|
This is primarily useful for reductions over a program's
|
||||||
inputs.
|
inputs. Note that when using `inputs` it is generally necessary
|
||||||
|
to invoke jq with the -n command-line option, otherwise
|
||||||
|
the first entity will be lost.
|
||||||
|
|
||||||
- title: "`debug`"
|
- title: "`debug`"
|
||||||
body: |
|
body: |
|
||||||
|
|||||||
Reference in new issue
Block a user