Package version up
[platform/upstream/libxkbcommon.git] / tools / xkbcli-list.1
index 3211efb..66ea09b 100644 (file)
@@ -1,41 +1,39 @@
-.TH "XKBCLI\-LIST" "1" "" "" "libxkbcommon manual"
+.Dd November 1, 2021
+.Dt XKBCLI\-LIST 1
+.Os
 .
-.SH "NAME"
-\fBxkbcli\-list\fR \- list available XKB rules, models, layouts, variants and options
+.Sh NAME
+.Nm "xkbcli list"
+.Nd list available XKB models, layouts, variants and options
 .
-.SH "SYNOPSIS"
-\fBxkbcli\fR list [\-\-help] [/path/to/xkbbase [/path/to/xkbbase] \.\.\.]
+.Sh SYNOPSIS
+.Nm
+.Op Pa /path/to/xkbbase Oo Pa /path/to/xkbbase Oc ...
 .
-.SH "DESCRIPTION"
-\fBxkbcli list\fR is a commandline tool to list available model, layout, variant and option (MLVO) values from the XKB registry\.
+.Sh DESCRIPTION
+List available model, layout, variant and option (MLVO) values from the XKB registry.
+The output is in YAML 1.2 format.
 .
-.P
-Arguments provided on the commandline are treated as XKB base directory installations\.
+.Pp
+Positional arguments are treated as XKB base directory installations.
 .
-.SH "OPTIONS"
-.
-.TP
-\fB\-\-help\fR
+.Bl -tag -width Ds
+.It Fl \-help
 Print help and exit
 .
-.TP
-\fB\-v, \-\-verbose\fR
+.It Fl \-verbose
 Increase verbosity, use multiple times for debugging output
 .
-.TP
-\fB\-\-ruleset <name>\fR
+.It Fl \-ruleset Ar name
 Load the ruleset with the given name
 .
-.TP
-\fB\-\-skip\-default\-paths\fR
+.It Fl \-skip\-default\-paths
 Do not load the default XKB include paths
 .
-.TP
-\fB\-\-load\-exotic\fR
+.It Fl \-load\-exotic
 Load exotic (extra) layouts
+.El
 .
-.SH "SEE ALSO"
-\fBxkbcli\fR(1)
-.
-.P
-The libxkbcommon online documentation at \fIhttps://xkbcommon\.org\fR
+.Sh SEE ALSO
+.Xr xkbcli 1 ,
+.Lk https://xkbcommon.org "The libxkbcommon online documentation"