Skip to content

Commit 4b9fa3d

Browse files
committed
libxo.7: fall cleaning
+ set section to section given by file name + clear arguements to name macro and fix a typo + give crossreferences section numbers and align order
1 parent fd5db1b commit 4b9fa3d

1 file changed

Lines changed: 12 additions & 15 deletions

File tree

libxo/libxo.7

Lines changed: 12 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -8,14 +8,13 @@
88
.\" # Phil Shafer, July 2014
99
.\"
1010
.Dd February 23, 2023
11-
.Dt LIBXO 3
11+
.Dt LIBXO 7
1212
.Os
1313
.Sh NAME
1414
.Nm libxo
1515
.Nd description of libxo usage
1616
.Sh DESCRIPTION
17-
.Pp
18-
.Nm libxo
17+
.Nm
1918
is a software component that allows other software to generate a
2019
variety of output styles, including
2120
.Em text ,
@@ -24,7 +23,7 @@ variety of output styles, including
2423
and
2524
.Em HTML .
2625
Using
27-
.Nm libxo ,
26+
.Nm ,
2827
a single section of code provides formatting and structural
2928
information, allowing a run-time choice of which format to emit.
3029
Using a single section of code allows
@@ -38,16 +37,16 @@ parsing of the output content in reliable and robust ways, and
3837
future-proofs by allowing the addition of new fields without impacting
3938
parsing.
4039
.Pp
41-
.Nm libxo
40+
.Nm
4241
supports "plug-in" encoders, which allow new output styles to be
4342
developed independently, such as the "CSV" encoder, which creates
4443
Comma-Separated Values, suitable for spreadsheets and other common
4544
uses.
4645
See
47-
.Xr xo_csv
46+
.Xr xo_csv 7 .
4847
.Pp
4948
Command-line options are used to control
50-
.NM libxo 's
49+
.Nm Ap s
5150
operation and output style and features.
5251
These options begin with
5352
.Em --libxo
@@ -78,7 +77,7 @@ For example, the brief "X" option and the word "xml" both trigger XML
7877
output, while the "P" and "pretty" options will "pretty-print" the
7978
output, using indentation and multiple lines.
8079
Any of the following will execute
81-
.Xr df
80+
.Xr df 1
8281
with both the "xml" and "pretty" options:
8382
.Bl -bullet
8483
.It
@@ -93,7 +92,6 @@ df \-\-libxo=xml \-\-libxo pretty
9392
df \-\-libxo:XP
9493
.El
9594
.Sh EXAMPLES
96-
.Pp
9795
The following example shows the same content generated using multiple
9896
style options: text, XML, JSON, and HTML:
9997
.Bd -literal
@@ -163,17 +161,16 @@ applications with a suitable CSS file, such as
163161
/usr/share/libxo/xohtml.css which is used by
164162
.Xr xohtml 1 .
165163
.Sh SEE ALSO
166-
.Xr xo_options 7 ,
167-
.Xr libxo 3 ,
168164
.Xr xolint 1 ,
169-
.Xr xo_emit 3
165+
.Xr libxo 3 ,
166+
.Xr xo_emit 3 ,
167+
.Xr xo_options 7
170168
.Sh HISTORY
171169
The
172-
.Nm libxo
170+
.Nm
173171
library first appeared in
174172
.Fx 11.0 .
175173
.Sh AUTHORS
176-
.Nm libxo
174+
.Nm
177175
was written by
178176
.An Phil Shafer Aq Mt phil@freebsd.org .
179-

0 commit comments

Comments
 (0)