diff options
| author | Emanuele Torre <torreemanuele6@gmail.com> | 2024-01-30 17:38:40 +0100 |
|---|---|---|
| committer | Nico Williams <nico@cryptonector.com> | 2024-01-30 12:23:33 -0600 |
| commit | 13e02ba348b51b60350d142ab16f2ac6f4e5967a (patch) | |
| tree | 146389443038441fae72cdabffd97b922311ebda /jq.1.prebuilt | |
| parent | bd3c828f9844d0f885881041779d6bbdcc1451f6 (diff) | |
docs: rename example jq utility to total
Apparently sum(1) is a BSD and GNU coreutil used to compute the
"16-bit BSD checksum" of a file.
Diffstat (limited to 'jq.1.prebuilt')
| -rw-r--r-- | jq.1.prebuilt | 10 |
1 files changed, 5 insertions, 5 deletions
diff --git a/jq.1.prebuilt b/jq.1.prebuilt index d7117d44..00f35824 100644 --- a/jq.1.prebuilt +++ b/jq.1.prebuilt @@ -1,5 +1,5 @@ . -.TH "JQ" "1" "December 2023" "" "" +.TH "JQ" "1" "January 2024" "" "" . .SH "NAME" \fBjq\fR \- Command\-line JSON processor @@ -3998,8 +3998,8 @@ Backslash continuing the comment on the next line can be useful when writing the .nf #!/bin/sh \-\- -# sum \- Output the sum of the given arguments (or stdin) -# usage: sum [numbers\.\.\.] +# total \- Output the sum of the given arguments (or stdin) +# usage: total [numbers\.\.\.] # \e exec jq \-\-args \-MRnf "$0" \-\- "$@" @@ -4012,7 +4012,7 @@ reduce ( \. as $dot | try tonumber catch false | if not or isnan then - @json "sum: Invalid number \e($dot)\.\en" | halt_error(1) + @json "total: Invalid number \e($dot)\.\en" | halt_error(1) end ) as $n (0; \. + $n) . @@ -4021,7 +4021,7 @@ reduce ( .IP "" 0 . .P -The \fBexec\fR line is considered a comment by jq, so it is ignored\. But it is not ignored by \fBsh\fR, since in \fBsh\fR a backslash at the end of the line does not continue the comment\. With this trick, when the script is invoked as \fBsum 1 2\fR, \fB/bin/sh \-\- /path/to/sum 1 2\fR will be run, and \fBsh\fR will then run \fBexec jq \-\-args \-MRnf /path/to/sum \-\- 1 2\fR replacing itself with a \fBjq\fR interpreter invoked with the specified options (\fB\-M\fR, \fB\-R\fR, \fB\-n\fR, \fB\-\-args\fR), that evaluates the current file (\fB$0\fR), with the arguments (\fB$@\fR) that were passed to \fBsh\fR\. +The \fBexec\fR line is considered a comment by jq, so it is ignored\. But it is not ignored by \fBsh\fR, since in \fBsh\fR a backslash at the end of the line does not continue the comment\. With this trick, when the script is invoked as \fBtotal 1 2\fR, \fB/bin/sh \-\- /path/to/total 1 2\fR will be run, and \fBsh\fR will then run \fBexec jq \-\-args \-MRnf /path/to/total \-\- 1 2\fR replacing itself with a \fBjq\fR interpreter invoked with the specified options (\fB\-M\fR, \fB\-R\fR, \fB\-n\fR, \fB\-\-args\fR), that evaluates the current file (\fB$0\fR), with the arguments (\fB$@\fR) that were passed to \fBsh\fR\. . .SH "MODULES" jq has a library/module system\. Modules are files whose names end in \fB\.jq\fR\. |