From 95673257d9ada29b4023cd2438e61fe141e8d9b5 Mon Sep 17 00:00:00 2001 From: Thomas Jensen Date: Sat, 3 Apr 2021 14:30:49 +0200 Subject: [PATCH] Document new tag query option in man page #23 --- doc/boxes.1.in | 26 +++++++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) diff --git a/doc/boxes.1.in b/doc/boxes.1.in index c6a50a7..8f1c1e9 100644 --- a/doc/boxes.1.in +++ b/doc/boxes.1.in @@ -171,7 +171,10 @@ top part or a bottom part, the default is yes. config file, along with a sample box and information about it's creator. Also checks syntax of the entire config file. If used in connection with .B \-d\fP, -displays detailed information about the specified design. +displays detailed information about the specified design. If used in +connection with +.B \-q\fP, +displays only the design and alias names, but no further information. .\" - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - .TP 0.6i .B \-m @@ -229,6 +232,27 @@ By default, unless specified otherwise in the config file, no padding is used. .\" - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - .TP 0.6i +.B \-q \fIquery\fP +Query designs by tag. Can only be used in combination with +.B \-l\fP. +If used in other contexts, behavior is undefined. +.br +The +.I query +argument is a comma-separated list of tags which can be present on a design +in order to match. A tag may optionally be prefixed with +.I \+ +in order to require that a tag be present, or with +.I \- +in order to exclude designs which have that tag. +.br +Using this option alters the behavior of +.B \-l +so that only the design names are printed. This is intended for use by scripts. +Alias names are printed below their primary design name, and postfixed with +.I (alias)\fP. +.\" - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +.TP 0.6i .B \-r Remove box. Removes an existing box instead of drawing it. Which design to use is detected automatically. In order to save time or in case the