Skip to content

Commit

Permalink
Mention -n in IO-section and for input/inputs
Browse files Browse the repository at this point in the history
  • Loading branch information
wader authored and nicowilliams committed May 26, 2022
1 parent c4d39c4 commit f2ad951
Showing 1 changed file with 10 additions and 2 deletions.
12 changes: 10 additions & 2 deletions docs/content/manual/manual.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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: |
Expand Down

0 comments on commit f2ad951

Please sign in to comment.