From c81937f3f68b4b36e2596ea23515013dae9a5418 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jesper=20R=C3=B8nn-Jensen?= Date: Fri, 15 Sep 2023 16:29:00 +0200 Subject: [PATCH] chore: Improve readability (for Alternative operator '//') The description of the Alternative operator `//` was hard for me to grasp in its wording. I suggest dividing the looong sentence into two parts. Since it is actually an alternative formulation, the sentence can be divided into the first formulation, and the alternative formulation. --- docs/content/manual/manual.yml | 2 +- jq.1.prebuilt | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/content/manual/manual.yml b/docs/content/manual/manual.yml index 5983f3cbb3..b8b1a1e616 100644 --- a/docs/content/manual/manual.yml +++ b/docs/content/manual/manual.yml @@ -2404,7 +2404,7 @@ sections: body: | The `//` operator produces all the values of its left-hand - side that are neither `false` nor `null`, or, if the + side that are neither `false` nor `null`. If the left-hand side produces no values other than `false` or `null`, then `//` produces all the values of its right-hand side. diff --git a/jq.1.prebuilt b/jq.1.prebuilt index bb3a4b3447..24939de28c 100644 --- a/jq.1.prebuilt +++ b/jq.1.prebuilt @@ -1,5 +1,5 @@ . -.TH "JQ" "1" "November 2023" "" "" +.TH "JQ" "1" "December 2023" "" "" . .SH "NAME" \fBjq\fR \- Command\-line JSON processor @@ -2586,7 +2586,7 @@ jq \'[true, false | not]\' .IP "" 0 . .SS "Alternative operator: //" -The \fB//\fR operator produces all the values of its left\-hand side that are neither \fBfalse\fR nor \fBnull\fR, or, if the left\-hand side produces no values other than \fBfalse\fR or \fBnull\fR, then \fB//\fR produces all the values of its right\-hand side\. +The \fB//\fR operator produces all the values of its left\-hand side that are neither \fBfalse\fR nor \fBnull\fR\. If the left\-hand side produces no values other than \fBfalse\fR or \fBnull\fR, then \fB//\fR produces all the values of its right\-hand side\. . .P A filter of the form \fBa // b\fR produces all the results of \fBa\fR that are not \fBfalse\fR or \fBnull\fR\. If \fBa\fR produces no results, or no results other than \fBfalse\fR or \fBnull\fR, then \fBa // b\fR produces the results of \fBb\fR\.