===================================================================
RCS file: /cvs/docbook2mdoc/docbook2mdoc.1,v
retrieving revision 1.12
retrieving revision 1.16
diff -u -p -r1.12 -r1.16
--- docbook2mdoc/docbook2mdoc.1	2019/04/12 19:14:50	1.12
+++ docbook2mdoc/docbook2mdoc.1	2019/05/01 09:14:19	1.16
@@ -1,4 +1,4 @@
-.\" $Id: docbook2mdoc.1,v 1.12 2019/04/12 19:14:50 schwarze Exp $
+.\" $Id: docbook2mdoc.1,v 1.16 2019/05/01 09:14:19 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 12 2019 $
+.Dd $Mdocdate: May 1 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.
@@ -101,6 +114,16 @@ Internal subset declaration to define an XML entity.
 .Ec >
 Internal subset declaration to define an XML entity using an external
 .Ar file .
+.It Eo <!
+.Ic DOCTYPE No ...
+.Bo
+.Eo " <!" Ic ENTITY No % Ar name Cm SYSTEM Qo Ar file Qc Ec >
+.Pf % Ar name No \&
+.Bc
+.Ec >
+Internal subset declaration to include an external
+.Ar file
+that is supposed to contain entity declarations.
 .It Eo < Ic mml : Ns ... Ec >
 Elements from the MathML namespace.
 These are translated to