1
0
mirror of https://github.com/stedolan/jq.git synced 2024-05-11 05:55:39 +00:00

Mention -n in IO-section and for input/inputs

This commit is contained in:
Mattias Wadman
2022-01-07 11:08:58 +01:00
committed by Nico Williams
parent c4d39c4d22
commit f2ad9517c7

View File

@ -2924,7 +2924,9 @@ sections:
are provided for this, `input` and `inputs`, that read from the
same sources (e.g., `stdin`, files named on the command-line) as
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
`stderr`. (Recall that a jq program's output values are always
@ -2944,13 +2946,19 @@ sections:
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`"
body: |
Outputs all remaining inputs, one by one.
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`"
body: |