===================================================================
RCS file: /cvs/docbook2mdoc/docbook2mdoc.1,v
retrieving revision 1.7
retrieving revision 1.9
diff -u -p -r1.7 -r1.9
--- docbook2mdoc/docbook2mdoc.1	2014/10/19 19:11:29	1.7
+++ docbook2mdoc/docbook2mdoc.1	2019/03/17 13:53:42	1.9
@@ -1,4 +1,4 @@
-.\"	$Id: docbook2mdoc.1,v 1.7 2014/10/19 19:11:29 kristaps Exp $
+.\"	$Id: docbook2mdoc.1,v 1.9 2019/03/17 13:53:42 schwarze Exp $
 .\"
 .\" Copyright (c) 2014 Kristaps Dzonsons <kristaps@bsd.lv>
 .\"
@@ -14,7 +14,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: October 19 2014 $
+.Dd $Mdocdate: March 17 2019 $
 .Dt DOCBOOK2MDOC 1
 .Os
 .Sh NAME
@@ -22,24 +22,23 @@
 .Nd Convert DocBook refentry to mdoc
 .Sh SYNOPSIS
 .Nm docbook2mdoc
+.Op Fl W
 .Op Ar file
 .Sh DESCRIPTION
 The
 .Nm
 utility reads
 .Ar file
-and
-generates
+and generates
 .Xr mdoc 7
 and
 .Xr eqn 7
-from the
-.Aq refentry
-section of DocBook source, ignoring other sections.
+from the <refentry> section of DocBook source, ignoring other sections.
 If unspecified or
-.Ar \&- ,
+.Sq Cm \- ,
 .Ar file
 is taken to be standard input.
+.Pp
 The arguments are as follows:
 .Bl -tag -width Ds
 .It Fl W
@@ -52,12 +51,9 @@ Some earlier DocBook constructs are accepted as well.
 SGML DocBook documents may be parsed unless they contain SGML-specific
 constructs, such as empty end tags
 .Li </> .
-The only non-DocBook construct recognised are
-.Aq xi:include \(sl
+The only non-DocBook constructs recognised are <xi:include\ />
 .Pq which is discarded
-and
-.Aq mml:* ,
-which is accepted and converted to
+and <mml:*>, which is accepted and converted to
 .Xr eqn 7 .
 .Sh EXIT STATUS
 .Ex -std
@@ -68,7 +64,7 @@ through
 .Xr mandoc 1
 and a pager:
 .Pp
-.Dl % docbook2mdoc foo.xml | mandoc | more
+.Dl $ docbook2mdoc foo.xml | mandoc -l
 .Sh SEE ALSO
 .Xr mandoc 1 ,
 .Xr eqn 7 ,
@@ -76,15 +72,12 @@ and a pager:
 .Sh AUTHORS
 .Nm
 was written by
-.Ar Kristaps Dzonsons ,
-.Mt kristaps@bsd.lv .
+.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv .
 .Sh CAVEATS
 The
 .Nm
 utility is experimental.
-As such, only a modest subset of the
-.Aq refentry
-domain is accepted.
+As such, only a modest subset of the <refentry> domain is accepted.
 .Pp
 The output
 .Xr mdoc 7