diff --git a/libxo/libxo-csv.7 b/libxo/libxo-csv.7
index 6e043820..0321524e 100644
--- a/libxo/libxo-csv.7
+++ b/libxo/libxo-csv.7
@@ -2,11 +2,11 @@
.\" # Copyright (c) 2021, Juniper Networks, Inc.
.\" # All rights reserved.
.\" # This SOFTWARE is licensed under the LICENSE provided in the
-.\" # ../Copyright file. By downloading, installing, copying, or
+.\" # ../Copyright file. By downloading, installing, copying, or
.\" # using the SOFTWARE, you agree to be bound by the terms of that
.\" # LICENSE.
.\" # Phil Shafer, May 2021
-.\"
+.\"
.Dd May 13, 2021
.Dt LIBXO-CSV 7
.Os
@@ -17,7 +17,8 @@
The
.Nm libxo
library supports a "pluggable" encoder mechanism, and ships with an
-encoder for CSV (comma separated values) files. The encoder allows
+encoder for CSV (comma separated values) files.
+The encoder allows
paths and fields to be selected out of the output contents:
.Bd -literal -offset indent
% df --libxo @csv
@@ -48,7 +49,8 @@ To allow support for additional encodings, libxo includes a
.Nm libxo -based
applications can automatically use any installed encoder.
.Pp
-Use the "encoder=XXX" option to access encoders. The following
+Use the "encoder=XXX" option to access encoders.
+The following
example uses the "cbor" encoder, saving the output into a file:
.Bd -literal -offset indent
df --libxo encoder=cbor > df-output.cbor
@@ -81,12 +83,14 @@ The string "@" can be used in place of the string "encoder=".
.Sh The CSV (Comma Separated Values) Encoder
.Nm libxo
ships with a custom encoder for "CSV" files, a common format for
-comma separated values. The output of the CSV encoder can be loaded
+comma separated values.
+The output of the CSV encoder can be loaded
directly into spreadsheets or similar applications.
.Pp
A standard for CSV files is provided in RFC 4180, but since the
format predates that standard by decades, there are many minor
-differences in CSV file consumers and their expectations. The CSV
+differences in CSV file consumers and their expectations.
+The CSV
encoder has a number of options to tailor output to those
expectations.
.Pp
@@ -150,7 +154,8 @@ In some cases, this may be unacceptable, and a specific list may be
desired.
.Pp
Use the "path" option to limit the processing of output to a specific
-hierarchy. The path should be one or more names of containers or
+hierarchy.
+The path should be one or more names of containers or
lists.
.Pp
For example, if the "list-items" application generates other lists,
@@ -164,19 +169,23 @@ the user can give "path=top/data/item" as a path:
.Ed
.Pp
Paths are "relative", meaning they need not be a complete set
-of names to the list. This means that "path=item" may be sufficient
+of names to the list.
+This means that "path=item" may be sufficient
for the above example.
.Sh The "leafs" Option
The CSV encoding requires that all lines of output have the same
-number of fields with the same order. In contrast, XML and JSON allow
+number of fields with the same order.
+In contrast, XML and JSON allow
any order (though libxo forces key leafs to appear before other
leafs).
.Pp
To maintain a consistent set of fields inside the CSV file, the same
-set of leafs must be selected from each list item. By default, the
+set of leafs must be selected from each list item.
+By default, the
CSV encoder records the set of leafs that appear in the first list
instance it processes, and extract only those leafs from future
-instances. If the first instance is missing a leaf that is desired by
+instances.
+If the first instance is missing a leaf that is desired by
the consumer, the "leaf" option can be used to ensure that an empty
value is recorded for instances that lack a particular leaf.
.Pp
@@ -184,7 +193,7 @@ The "leafs" option can also be used to exclude leafs, limiting the
output to only those leafs provided.
.Pp
In addition, the order of the output fields follows the order in which
-the leafs are listed. "leafs=one.two" and "leafs=two.one" give
+the leafs are listed; "leafs=one.two" and "leafs=two.one" give
distinct output.
.Pp
So the "leafs" option can be used to expand, limit, and order the set
@@ -207,7 +216,7 @@ separated by a period ("."):
.Pp
Note that since libxo uses terminology from YANG (:RFC:`7950`), the
data modeling language for NETCONF (:RFC:`6241`), which uses "leafs"
-as the plural form of "leaf". libxo follows that convention.
+as the plural form of "leaf", libxo follows that convention.
.Sh The "no-header" Option
CSV files typical begin with a line that defines the fields included
in that file, in an attempt to make the contents self-defining:
@@ -225,16 +234,19 @@ The csv encoder defaults to producing the header line, but the
"no-header" option can be included to avoid the header line.
.Sh The "no-quotes" Option
RFC 4180 specifies that fields containing spaces should be quoted, but
-many CSV consumers do not handle quotes. The "no-quotes" option
+many CSV consumers do not handle quotes.
+The "no-quotes" option
instruct the CSV encoder to avoid the use of quotes.
.Sh The "dos" Option
RFC 4180 defines the end-of-line marker as a carriage return
-followed by a newline. This "CRLF" convention dates from the distant
+followed by a newline.
+This "CRLF" convention dates from the distant
past, but its use was anchored in the 1980s by the `DOS` operating
system.
.Pp
The CSV encoder defaults to using the standard Unix end-of-line
-marker, a simple newline. Use the "dos" option to use the `CRLF`
+marker, a simple newline.
+Use the "dos" option to use the `CRLF`
convention.
.Sh Option Handling
The handling of command-line options is complex, since there are three
@@ -268,7 +280,7 @@ library first appeared in
The CSV encoder first appeared in
.Fx 13.0 .
.Sh AUTHORS
+The
.Nm libxo
-was written by
+library was written by
.An Phil Shafer Aq Mt phil@freebsd.org .
-
diff --git a/libxo/libxo.3 b/libxo/libxo.3
index 95c00598..04722515 100644
--- a/libxo/libxo.3
+++ b/libxo/libxo.3
@@ -2,11 +2,11 @@
.\" # Copyright (c) 2014, Juniper Networks, Inc.
.\" # All rights reserved.
.\" # This SOFTWARE is licensed under the LICENSE provided in the
-.\" # ../Copyright file. By downloading, installing, copying, or
+.\" # ../Copyright file. By downloading, installing, copying, or
.\" # using the SOFTWARE, you agree to be bound by the terms of that
.\" # LICENSE.
.\" # Phil Shafer, July 2014
-.\"
+.\"
.Dd December 8, 2014
.Dt LIBXO 3
.Os
@@ -285,8 +285,9 @@ These functions are mildly compatible with their standard libc
namesakes, but use the format string defined in
.Xr xo_format 5 .
While there is an increased cost for converting the strings, the
-output provided can be richer and more useful. See also
-.Xr xo_err 3
+output provided can be richer and more useful.
+See also
+.Xr xo_err 3 .
.It Fn xo_warn
.It Fn xo_warnx
.It Fn xo_warn_c
@@ -380,7 +381,6 @@ Instructs
to use an alternative set of low-level output functions.
.El
.Sh SEE ALSO
-.Xr libxo-csv 7,
.Xr xo 1 ,
.Xr xolint 1 ,
.Xr xo_attr 3 ,
@@ -393,7 +393,6 @@ to use an alternative set of low-level output functions.
.Xr xo_no_setlocale 3 ,
.Xr xo_open_container 3 ,
.Xr xo_open_list 3 ,
-.Xr xo_options 7,
.Xr xo_parse_args 3 ,
.Xr xo_set_allocator 3 ,
.Xr xo_set_flags 3 ,
@@ -401,14 +400,16 @@ to use an alternative set of low-level output functions.
.Xr xo_set_options 3 ,
.Xr xo_set_style 3 ,
.Xr xo_set_writer 3 ,
-.Xr xo_format 5
+.Xr xo_format 5 ,
+.Xr libxo-csv 7 ,
+.Xr xo_options 7
.Sh HISTORY
The
.Nm libxo
library first appeared in
.Fx 11.0 .
.Sh AUTHORS
+The
.Nm libxo
-was written by
+library was written by
.An Phil Shafer Aq Mt phil@freebsd.org .
-
diff --git a/libxo/xo_attr.3 b/libxo/xo_attr.3
index 4f1465b1..bde0705c 100644
--- a/libxo/xo_attr.3
+++ b/libxo/xo_attr.3
@@ -2,11 +2,11 @@
.\" # Copyright (c) 2014, Juniper Networks, Inc.
.\" # All rights reserved.
.\" # This SOFTWARE is licensed under the LICENSE provided in the
-.\" # ../Copyright file. By downloading, installing, copying, or
+.\" # ../Copyright file. By downloading, installing, copying, or
.\" # using the SOFTWARE, you agree to be bound by the terms of that
.\" # LICENSE.
.\" # Phil Shafer, July 2014
-.\"
+.\"
.Dd July, 2014
.Dt LIBXO 3
.Os
@@ -26,7 +26,8 @@
.Sh DESCRIPTION
The
.Fn xo_attr
-function emits attributes for the XML output style. The attribute
+function emits attributes for the XML output style.
+The attribute
value is recorded in the
.Fa handle
and is attached to the next field that is emitted via a
@@ -35,7 +36,8 @@ call.
.Pp
The
.Fa name
-parameter give the name of the attribute to be encoded. The
+parameter give the name of the attribute to be encoded.
+The
.Fa fmt
parameter gives a printf-style format string used to format the
value of the attribute using any remaining arguments, or the
@@ -56,15 +58,15 @@ Since attributes are only emitted in XML, their use should be limited
to meta-data and additional or redundant representations of data
already emitted in other form.
.Sh SEE ALSO
-.Xr xo_emit 3 ,
-.Xr libxo 3
+.Xr libxo 3 ,
+.Xr xo_emit 3
.Sh HISTORY
The
.Nm libxo
library first appeared in
.Fx 11.0 .
.Sh AUTHORS
+The
.Nm libxo
-was written by
+library was written by
.An Phil Shafer Aq Mt phil@freebsd.org .
-
diff --git a/libxo/xo_create.3 b/libxo/xo_create.3
index ea811c27..7bf5e711 100644
--- a/libxo/xo_create.3
+++ b/libxo/xo_create.3
@@ -2,11 +2,11 @@
.\" # Copyright (c) 2014, Juniper Networks, Inc.
.\" # All rights reserved.
.\" # This SOFTWARE is licensed under the LICENSE provided in the
-.\" # ../Copyright file. By downloading, installing, copying, or
+.\" # ../Copyright file. By downloading, installing, copying, or
.\" # using the SOFTWARE, you agree to be bound by the terms of that
.\" # LICENSE.
.\" # Phil Shafer, July 2014
-.\"
+.\"
.Dd December 4, 2014
.Dt LIBXO 3
.Os
@@ -62,16 +62,16 @@ with a
handle will release any
resources associated with the default handle.
.Sh SEE ALSO
+.Xr libxo 3 ,
.Xr xo_emit 3 ,
-.Xr xo_set_options 3 ,
-.Xr libxo 3
+.Xr xo_set_options 3
.Sh HISTORY
The
.Nm libxo
library first appeared in
.Fx 11.0 .
.Sh AUTHORS
+The
.Nm libxo
-was written by
+library was written by
.An Phil Shafer Aq Mt phil@freebsd.org .
-
diff --git a/libxo/xo_emit.3 b/libxo/xo_emit.3
index cbf9d2b1..ac2e1c5b 100644
--- a/libxo/xo_emit.3
+++ b/libxo/xo_emit.3
@@ -2,11 +2,11 @@
.\" # Copyright (c) 2014, Juniper Networks, Inc.
.\" # All rights reserved.
.\" # This SOFTWARE is licensed under the LICENSE provided in the
-.\" # ../Copyright file. By downloading, installing, copying, or
+.\" # ../Copyright file. By downloading, installing, copying, or
.\" # using the SOFTWARE, you agree to be bound by the terms of that
.\" # LICENSE.
.\" # Phil Shafer, July 2014
-.\"
+.\"
.Dd December 4, 2014
.Dt LIBXO 3
.Os
@@ -51,7 +51,7 @@ source code:
"{:characters/%7ju} {d:filename/%s}\\n",
linect, wordct, charct, file);
.Ed
-Output can then be generated in various style, using
+Output can then be generated in various style, using
the "--libxo" option:
.Bd -literal -offset indent
% wc /etc/motd
@@ -92,25 +92,26 @@ the "--libxo" option:
.Ed
.Sh RETURN CODE
.Nm
-returns a negative value on error. If the
+returns a negative value on error.
+If the
.Nm XOF_COLUMNS
flag has been turned on for the specific handle using
.Xr xo_set_flags 3 ,
then the number of display columns consumed by the output will be returned.
.Sh SEE ALSO
-.Xr xo_open_container 3 ,
-.Xr xo_open_list 3 ,
+.Xr libxo 3 ,
.Xr xo_emit_f 3 ,
.Xo xo_emit_field 3 ,
-.Xr xo_format 5 ,
-.Xr libxo 3
+.Xr xo_open_container 3 ,
+.Xr xo_open_list 3 ,
+.Xr xo_format 5
.Sh HISTORY
The
.Nm libxo
library first appeared in
.Fx 11.0 .
.Sh AUTHORS
+The
.Nm libxo
-was written by
+library was written by
.An Phil Shafer Aq Mt phil@freebsd.org .
-
diff --git a/libxo/xo_emit_err.3 b/libxo/xo_emit_err.3
index eae44b74..a3066760 100644
--- a/libxo/xo_emit_err.3
+++ b/libxo/xo_emit_err.3
@@ -2,11 +2,11 @@
.\" # Copyright (c) 2014, Juniper Networks, Inc.
.\" # All rights reserved.
.\" # This SOFTWARE is licensed under the LICENSE provided in the
-.\" # ../Copyright file. By downloading, installing, copying, or
+.\" # ../Copyright file. By downloading, installing, copying, or
.\" # using the SOFTWARE, you agree to be bound by the terms of that
.\" # LICENSE.
.\" # Phil Shafer, July 2014
-.\"
+.\"
.Dd December 4, 2014
.Dt LIBXO 3
.Os
@@ -66,17 +66,17 @@ parameter.
xo_err(1, "cannot open file '%s'", filename);
.Ed
.Sh SEE ALSO
+.Xr libxo 3 ,
.Xr xo_emit 3 ,
-.Xr xo_format 5 ,
.Xr xo_err 3 ,
-.Xr libxo 3
+.Xr xo_format 5
.Sh HISTORY
The
.Nm libxo
library first appeared in
.Fx 11.0 .
.Sh AUTHORS
+The
.Nm libxo
-was written by
+library was written by
.An Phil Shafer Aq Mt phil@freebsd.org .
-
diff --git a/libxo/xo_emit_f.3 b/libxo/xo_emit_f.3
index f8ac0132..d3893e29 100644
--- a/libxo/xo_emit_f.3
+++ b/libxo/xo_emit_f.3
@@ -2,11 +2,11 @@
.\" # Copyright (c) 2016, Juniper Networks, Inc.
.\" # All rights reserved.
.\" # This SOFTWARE is licensed under the LICENSE provided in the
-.\" # ../Copyright file. By downloading, installing, copying, or
+.\" # ../Copyright file. By downloading, installing, copying, or
.\" # using the SOFTWARE, you agree to be bound by the terms of that
.\" # LICENSE.
.\" # Phil Shafer, April 2016
-.\"
+.\"
.Dd April 15, 2016
.Dt LIBXO 3
.Os
@@ -30,7 +30,8 @@
.Sh DESCRIPTION
These functions allow callers to pass a set of flags to
.Nm
-emitting functions. These processing of arguments, except for
+emitting functions.
+These processing of arguments, except for
.Fa flags ,
is identical to the base functions.
See
@@ -55,7 +56,8 @@ The format string must be immutable across multiple calls to
.Xn xo_emit_f ,
since the library retains the string.
Typically this is done by using
-static constant strings, such as string literals. If the string is not
+static constant strings, such as string literals.
+If the string is not
immutable, the
.Dv XOEF_RETAIN
flag must not be used.
@@ -100,22 +102,23 @@ In this example, the caller desires to clear the retained information.
.Ed
.Sh RETURN CODE
The return values for these functions is identical to those of their
-traditional counterparts. See
+traditional counterparts.
+See
.Xr xo_emit 3
for details.
.Sh SEE ALSO
+.Xr libxo 3 ,
.Xr xo_emit 3 ,
.Xr xo_open_container 3 ,
.Xr xo_open_list 3 ,
-.Xr xo_format 5 ,
-.Xr libxo 3
+.Xr xo_format 5
.Sh HISTORY
The
.Nm libxo
library first appeared in
.Fx 11.0 .
.Sh AUTHORS
+The
.Nm libxo
-was written by
+library was written by
.An Phil Shafer Aq Mt phil@freebsd.org .
-
diff --git a/libxo/xo_emit_field.3 b/libxo/xo_emit_field.3
index 4f9636ce..78dbf96c 100644
--- a/libxo/xo_emit_field.3
+++ b/libxo/xo_emit_field.3
@@ -2,11 +2,11 @@
.\" # Copyright (c) 2021, Juniper Networks, Inc.
.\" # All rights reserved.
.\" # This SOFTWARE is licensed under the LICENSE provided in the
-.\" # ../Copyright file. By downloading, installing, copying, or
+.\" # ../Copyright file. By downloading, installing, copying, or
.\" # using the SOFTWARE, you agree to be bound by the terms of that
.\" # LICENSE.
.\" # Phil Shafer, July 2014
-.\"
+.\"
.Dd December 4, 2014
.Dt LIBXO 3
.Os
@@ -20,7 +20,7 @@
.Ft xo_ssize_t
.Fn xo_emit_field "const char *rolmod" "const char *content" "const char *fmt" "const char *efmt" "..."
.Ft xo_ssize_t
-.Fn xo_emit_field_h "xo_handle_t *xop" "const char *rolmod" "const char *content" "const char *fmt" const char *efmt" "..."
+.Fn xo_emit_field_h "xo_handle_t *xop" "const char *rolmod" "const char *content" "const char *fmt" "const char *efmt" "..."
.Ft xo_ssize_t
.Fn xo_emit_field_hv "xo_handle_t *xop" "const char *rolmod" "const char *content" "const char *fmt" "const char *efmt" "va_list vap"
.Sh DESCRIPTION
@@ -56,7 +56,8 @@ in pieces, rather than having to use something like
.Xr snprintf 3
to build the format string required by
.Fn xo_emit .
-The arguments are each NUL-terminated strings. The
+The arguments are each NUL-terminated strings.
+The
.Fa rolmod
argument contains the "role" and "modifier" portions of
the field description, the
@@ -94,20 +95,22 @@ source code:
.Ed
.Sh RETURN CODE
.Nm
-returns a negative value on error. If the
+returns a negative value on error.
+If the
.Nm XOF_COLUMNS
flag has been turned on for the specific handle using
.Xr xo_set_flags 3 ,
then the number of display columns consumed by the output will be returned.
.Sh SEE ALSO
-.Xr xo_format 5 ,
-.Xr libxo 3
+.Xr libxo 3 ,
+.Xr xo_format 5
.Sh HISTORY
The
.Nm libxo
library first appeared in
.Fx 11.0 .
.Sh AUTHORS
+The
.Nm libxo
-was written by
+library was written by
.An Phil Shafer Aq Mt phil@freebsd.org .
diff --git a/libxo/xo_err.3 b/libxo/xo_err.3
index 87cf2010..6ed58e71 100644
--- a/libxo/xo_err.3
+++ b/libxo/xo_err.3
@@ -2,11 +2,11 @@
.\" # Copyright (c) 2014, Juniper Networks, Inc.
.\" # All rights reserved.
.\" # This SOFTWARE is licensed under the LICENSE provided in the
-.\" # ../Copyright file. By downloading, installing, copying, or
+.\" # ../Copyright file. By downloading, installing, copying, or
.\" # using the SOFTWARE, you agree to be bound by the terms of that
.\" # LICENSE.
.\" # Phil Shafer, July 2014
-.\"
+.\"
.Dd December 4, 2014
.Dt LIBXO 3
.Os
@@ -49,7 +49,8 @@ argument is one compatible with
.Xr printf 3
rather than
.Xr xo_emit 3
-to aid in simple conversion. This means
+to aid in simple conversion.
+This means
these functions make unstructured data.
To generate structured data,
use the
@@ -69,16 +70,16 @@ parameter.
xo_err(1, "cannot open file '%s'", filename);
.Ed
.Sh SEE ALSO
+.Xr libxo 3 ,
.Xr xo_emit 3 ,
-.Xr xo_emit_err 3 ,
-.Xr libxo 3
+.Xr xo_emit_err 3
.Sh HISTORY
The
.Nm libxo
library first appeared in
.Fx 11.0 .
.Sh AUTHORS
+The
.Nm libxo
-was written by
+library was written by
.An Phil Shafer Aq Mt phil@freebsd.org .
-
diff --git a/libxo/xo_error.3 b/libxo/xo_error.3
index 0330af41..4470eee4 100644
--- a/libxo/xo_error.3
+++ b/libxo/xo_error.3
@@ -2,11 +2,11 @@
.\" # Copyright (c) 2014, Juniper Networks, Inc.
.\" # All rights reserved.
.\" # This SOFTWARE is licensed under the LICENSE provided in the
-.\" # ../Copyright file. By downloading, installing, copying, or
+.\" # ../Copyright file. By downloading, installing, copying, or
.\" # using the SOFTWARE, you agree to be bound by the terms of that
.\" # LICENSE.
.\" # Phil Shafer, July 2014
-.\"
+.\"
.Dd December 4, 2014
.Dt LIBXO 3
.Os
@@ -23,7 +23,7 @@
Use the
.Fn xo_error
function to generate error messages to standard error.
-The
+The
.Fa fmt
argument is a string containing printf-style formatting
instructions that describe the remaining arguments.
@@ -31,21 +31,21 @@ instructions that describe the remaining arguments.
When converting an application to
.Nm libxo ,
one can replace
-.Em "fprintf(stderr,...)"
+.Em "fprintf(stderr, ...)"
calls with
.Fn xo_error
calls.
.Sh SEE ALSO
+.Xr libxo 3 ,
.Xr printf 3 ,
-.Xr xo_emit 3 ,
-.Xr libxo 3
+.Xr xo_emit 3
.Sh HISTORY
The
.Nm libxo
library first appeared in
.Fx 11.0 .
.Sh AUTHORS
+The
.Nm libxo
-was written by
+library was written by
.An Phil Shafer Aq Mt phil@freebsd.org .
-
diff --git a/libxo/xo_finish.3 b/libxo/xo_finish.3
index a61d5276..9da60588 100644
--- a/libxo/xo_finish.3
+++ b/libxo/xo_finish.3
@@ -2,11 +2,11 @@
.\" # Copyright (c) 2014, Juniper Networks, Inc.
.\" # All rights reserved.
.\" # This SOFTWARE is licensed under the LICENSE provided in the
-.\" # ../Copyright file. By downloading, installing, copying, or
+.\" # ../Copyright file. By downloading, installing, copying, or
.\" # using the SOFTWARE, you agree to be bound by the terms of that
.\" # LICENSE.
.\" # Phil Shafer, July 2014
-.\"
+.\"
.Dd December 4, 2014
.Dt LIBXO 3
.Os
@@ -35,15 +35,15 @@ Calling this function is
to the proper operation of libxo,
especially for the non-TEXT output styles.
.Sh SEE ALSO
-.Xr xo_emit 3 ,
-.Xr libxo 3
+.Xr libxo 3 ,
+.Xr xo_emit 3
.Sh HISTORY
The
.Nm libxo
library first appeared in
.Fx 11.0 .
.Sh AUTHORS
+The
.Nm libxo
-was written by
+library was written by
.An Phil Shafer Aq Mt phil@freebsd.org .
-
diff --git a/libxo/xo_flush.3 b/libxo/xo_flush.3
index d1375223..c7dece6d 100644
--- a/libxo/xo_flush.3
+++ b/libxo/xo_flush.3
@@ -2,11 +2,11 @@
.\" # Copyright (c) 2014, Juniper Networks, Inc.
.\" # All rights reserved.
.\" # This SOFTWARE is licensed under the LICENSE provided in the
-.\" # ../Copyright file. By downloading, installing, copying, or
+.\" # ../Copyright file. By downloading, installing, copying, or
.\" # using the SOFTWARE, you agree to be bound by the terms of that
.\" # LICENSE.
.\" # Phil Shafer, July 2014
-.\"
+.\"
.Dd December 4, 2014
.Dt LIBXO 3
.Os
@@ -31,15 +31,15 @@ The
.Fn xo_flush
function is used for this.
.Sh SEE ALSO
-.Xr xo_emit 3 ,
-.Xr libxo 3
+.Xr libxo 3 ,
+.Xr xo_emit 3
.Sh HISTORY
The
.Nm libxo
library first appeared in
.Fx 11.0 .
.Sh AUTHORS
+The
.Nm libxo
-was written by
+library was written by
.An Phil Shafer Aq Mt phil@freebsd.org .
-
diff --git a/libxo/xo_format.5 b/libxo/xo_format.5
index 3c7ddc9d..79950aea 100644
--- a/libxo/xo_format.5
+++ b/libxo/xo_format.5
@@ -300,7 +300,7 @@ Units can also be rendered in HTML as the "data\-units" attribute:
data\-xpath="/top/data/distance">50
.Ed
.Ss "The Value Role ({V:} and {:})"
-The value role is used to represent the a data value that is
+The value role is used to represent the data value that is
interesting for the non\-display output styles (XML and JSON).
Value
is the default role; if no other role designation is given, the field
@@ -318,7 +318,7 @@ format descriptors default to "%s".
.Bd -literal -offset indent
xo_emit("{:length/%02u}x{:width/%02u}x{:height/%02u}\\n",
length, width, height);
- xo_emit("{:author} wrote \"{:poem}\" in {:year/%4d}\\n,
+ xo_emit("{:author} wrote \"{:poem}\" in {:year/%4d}\\n",
author, poem, year);
.Ed
.Ss "The Anchor Roles ({[:} and {]:})"
@@ -531,8 +531,9 @@ for the HTML output style when
is set, but other uses are likely in the near future.
.Ss "The Leaf\-List Modifier ({l:})"
The leaf\-list modifier is used to distinguish lists where each
-instance consists of only a single value. In XML, these are
-rendered as single elements, where JSON renders them as arrays.
+instance consists of only a single value.
+In XML, these are
+rendered as single elements, whereas JSON renders them as arrays.
.Bd -literal -offset indent
EXAMPLE:
xo_open_list("user");
@@ -969,8 +970,8 @@ use only one of the field names.
If there is a difference, change the
names to make that difference more obvious.
.Sh SEE ALSO
-.Xr libxo 3 ,
.Xr xolint 1 ,
+.Xr libxo 3 ,
.Xr xo_emit 3
.Sh HISTORY
The
@@ -978,7 +979,7 @@ The
library first appeared in
.Fx 11.0 .
.Sh AUTHORS
+The
.Nm libxo
-was written by
+library was written by
.An Phil Shafer Aq Mt phil@freebsd.org .
-
diff --git a/libxo/xo_message.3 b/libxo/xo_message.3
index ce979a51..d559939d 100644
--- a/libxo/xo_message.3
+++ b/libxo/xo_message.3
@@ -2,11 +2,11 @@
.\" # Copyright (c) 2014, Juniper Networks, Inc.
.\" # All rights reserved.
.\" # This SOFTWARE is licensed under the LICENSE provided in the
-.\" # ../Copyright file. By downloading, installing, copying, or
+.\" # ../Copyright file. By downloading, installing, copying, or
.\" # using the SOFTWARE, you agree to be bound by the terms of that
.\" # LICENSE.
.\" # Phil Shafer, July 2014
-.\"
+.\"
.Dd December 4, 2014
.Dt LIBXO 3
.Os
@@ -28,13 +28,18 @@
.Ft void
.Fn xo_message_hcv "xo_handle_t *xop" "int code" "const char *fmt" "va_list vap"
.Sh DESCRIPTION
+The
.Nm xo_message
-generates text message which lack any sort of structure.
+function generates text messages which lack any sort of structure.
These functions should not be used under normal conditions, since
-they completely defeat the value of using libxo. They are provided
+they completely defeat the value of using libxo.
+They are provided
for scenarios when the output's content is genuinely unknown and
unusable.
-It is used in converting programs where err/warn where not used,
+It is used in converting programs where
+.Xr err 3 /
+.Xr warn 3
+were not used,
and error messages went to
.Nm stdout ,
not
@@ -46,14 +51,17 @@ the error in a useful form.
.Pp
The
.Nm xo_message
-function generates output strings using the printf-style format string
+function generates output strings using the
+.Xr printf 3 Ns
+-style format string
and arguments provided.
If the format string does not end in a newline,
.Nm xo_message_e
-will appear a colon, a space, and the error associated with the current
+will emit a colon, a space, and the error associated with the current
.Nm errno
value.
-.Nm xo_message_c behaves similarly for the value passed in the
+.Nm xo_message_c
+behaves similarly for the value passed in the
.Fa code
parameter.
.Nm xo_message_hc
@@ -62,17 +70,20 @@ accepts a
as opened by
.Xr xo_create 3
and
-.Nm xo_message_hcv accepts a va_list parameter of arguments.
+.Nm xo_message_hcv
+accepts a
+.Vt va_list
+of arguments.
.Sh SEE ALSO
-.Xr xo_emit 3 ,
-.Xr libxo 3
+.Xr libxo 3 ,
+.Xr xo_emit 3
.Sh HISTORY
The
.Nm libxo
library first appeared in
.Fx 11.0 .
.Sh AUTHORS
+The
.Nm libxo
-was written by
+library was written by
.An Phil Shafer Aq Mt phil@freebsd.org .
-
diff --git a/libxo/xo_no_setlocale.3 b/libxo/xo_no_setlocale.3
index da3e8a34..5081baa3 100644
--- a/libxo/xo_no_setlocale.3
+++ b/libxo/xo_no_setlocale.3
@@ -2,11 +2,11 @@
.\" # Copyright (c) 2014, Juniper Networks, Inc.
.\" # All rights reserved.
.\" # This SOFTWARE is licensed under the LICENSE provided in the
-.\" # ../Copyright file. By downloading, installing, copying, or
+.\" # ../Copyright file. By downloading, installing, copying, or
.\" # using the SOFTWARE, you agree to be bound by the terms of that
.\" # LICENSE.
.\" # Phil Shafer, July 2014
-.\"
+.\"
.Dd December 4, 2014
.Dt LIBXO 3
.Os
@@ -36,18 +36,18 @@ can do so by calling the
.Fn xo_no_setlocale
function.
.Sh SEE ALSO
+.Xr libxo 3 ,
.Xr xo_emit 3 ,
.Xr xo_open_container 3 ,
.Xr xo_open_list 3 ,
-.Xr xo_format 5 ,
-.Xr libxo 3
+.Xr xo_format 5
.Sh HISTORY
The
.Nm libxo
library first appeared in
.Fx 11.0 .
.Sh AUTHORS
+The
.Nm libxo
-was written by
+library was written by
.An Phil Shafer Aq Mt phil@freebsd.org .
-
diff --git a/libxo/xo_open_container.3 b/libxo/xo_open_container.3
index 303f3f06..27d376f1 100644
--- a/libxo/xo_open_container.3
+++ b/libxo/xo_open_container.3
@@ -2,11 +2,11 @@
.\" # Copyright (c) 2014, Juniper Networks, Inc.
.\" # All rights reserved.
.\" # This SOFTWARE is licensed under the LICENSE provided in the
-.\" # ../Copyright file. By downloading, installing, copying, or
+.\" # ../Copyright file. By downloading, installing, copying, or
.\" # using the SOFTWARE, you agree to be bound by the terms of that
.\" # LICENSE.
.\" # Phil Shafer, July 2014
-.\"
+.\"
.Dd December 4, 2014
.Dt LIBXO 3
.Os
@@ -63,7 +63,7 @@ functions.
Each open call should have a matching close call.
If the
.Dv XOF_WARN
-flag is set and the name given does not match the name of
+flag is set and the name given does not match the name of
the currently open
container, a warning will be generated.
.Bd -literal -offset indent -compact
@@ -184,15 +184,15 @@ containers, lists, and instances.
A warning is generated when the name given to the close function
and the name recorded do not match.
.Sh SEE ALSO
-.Xr xo_emit 3 ,
-.Xr libxo 3
+.Xr libxo 3 ,
+.Xr xo_emit 3
.Sh HISTORY
The
.Nm libxo
library first appeared in
.Fx 11.0 .
.Sh AUTHORS
+The
.Nm libxo
-was written by
+library was written by
.An Phil Shafer Aq Mt phil@freebsd.org .
-
diff --git a/libxo/xo_open_list.3 b/libxo/xo_open_list.3
index e61e1593..5e2fd114 100644
--- a/libxo/xo_open_list.3
+++ b/libxo/xo_open_list.3
@@ -2,11 +2,11 @@
.\" # Copyright (c) 2014, Juniper Networks, Inc.
.\" # All rights reserved.
.\" # This SOFTWARE is licensed under the LICENSE provided in the
-.\" # ../Copyright file. By downloading, installing, copying, or
+.\" # ../Copyright file. By downloading, installing, copying, or
.\" # using the SOFTWARE, you agree to be bound by the terms of that
.\" # LICENSE.
.\" # Phil Shafer, July 2014
-.\"
+.\"
.Dd December 4, 2014
.Dt LIBXO 3
.Os
@@ -144,7 +144,8 @@ function using the ""l"" modifier:
.Pp
The name of the field must match the name of the leaf list.
.Pp
-In JSON, leaf lists are rendered as arrays of values. In XML, they
+In JSON, leaf lists are rendered as arrays of values.
+In XML, they
are rendered as multiple leaf elements.
.Bd -literal -offset indent -compact
JSON:
@@ -154,15 +155,15 @@ are rendered as multiple leaf elements.