===================================================================
RCS file: /cvs/docbook2mdoc/docbook2mdoc.1,v
retrieving revision 1.13
retrieving revision 1.17
diff -u -p -r1.13 -r1.17
--- docbook2mdoc/docbook2mdoc.1	2019/04/23 15:47:23	1.13
+++ docbook2mdoc/docbook2mdoc.1	2019/05/02 12:40:42	1.17
@@ -1,4 +1,4 @@
-.\" $Id: docbook2mdoc.1,v 1.13 2019/04/23 15:47:23 schwarze Exp $
+.\" $Id: docbook2mdoc.1,v 1.17 2019/05/02 12:40:42 schwarze Exp $
 .\"
 .\" Copyright (c) 2014 Kristaps Dzonsons <kristaps@bsd.lv>
 .\" Copyright (c) 2019 Ingo Schwarze <schwarze@openbsd.org>
@@ -15,7 +15,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: April 23 2019 $
+.Dd $Mdocdate: May 2 2019 $
 .Dt DOCBOOK2MDOC 1
 .Os
 .Sh NAME
@@ -24,6 +24,7 @@
 .Sh SYNOPSIS
 .Nm docbook2mdoc
 .Op Fl W
+.Op Fl s Ar section
 .Op Fl T Cm mdoc | tree | lint
 .Op Ar file
 .Sh DESCRIPTION
@@ -37,12 +38,23 @@ and
 .Xr eqn 7 .
 If
 .Ar file
-is
-.Sq Cm \-
-or omitted, standard input is used.
+is omitted, standard input is used.
 .Pp
 The options are as follows:
 .Bl -tag -width 2n
+.It Fl s
+Specify the manual page
+.Ar section
+to be used as the second argument of the
+.Ic \&Dt
+macro.
+Defaults to the content of the first
+.Eo < Ic manvolnum Ec >
+element in the first
+.Eo < Ic refmeta Ec >
+block, if any, or to
+.Qq 1
+otherwise.
 .It Fl T
 Select the output mode.
 The following arguments are supported:
@@ -58,7 +70,8 @@ Child nodes are indented with respect to their parent 
 The columns are:
 .Bl -enum -width 2n
 .It
-A hyphen if the node follows the previous node
+An asterisk if the node starts a new text line,
+or a hyphen if the node follows the previous node
 without intervening whitespace.
 .It
 The node type.
@@ -190,13 +203,3 @@ was written by
 .An Kristaps Dzonsons Aq Mt kristaps@bsd.lv
 and
 .An Ingo Schwarze Aq Mt schwarze@openbsd.org .
-.Sh CAVEATS
-The
-.Nm
-utility is experimental.
-Many elements are not recognized yet.
-.Pp
-The output
-.Xr mdoc 7
-could be much nicer: trailing spaces, superfluous space removal,
-new-line new-sentence, and other niceties are not used.