=================================================================== RCS file: /cvs/docbook2mdoc/docbook2mdoc.1,v retrieving revision 1.13 retrieving revision 1.15 diff -u -p -r1.13 -r1.15 --- docbook2mdoc/docbook2mdoc.1 2019/04/23 15:47:23 1.13 +++ docbook2mdoc/docbook2mdoc.1 2019/05/01 09:02:25 1.15 @@ -1,4 +1,4 @@ -.\" $Id: docbook2mdoc.1,v 1.13 2019/04/23 15:47:23 schwarze Exp $ +.\" $Id: docbook2mdoc.1,v 1.15 2019/05/01 09:02:25 schwarze Exp $ .\" .\" Copyright (c) 2014 Kristaps Dzonsons .\" Copyright (c) 2019 Ingo Schwarze @@ -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 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 @@ -43,6 +44,19 @@ or 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 +72,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.