version 1.4, 2014/04/30 12:54:26 |
version 1.8, 2017/06/29 12:11:57 |
|
|
and |
and |
generates |
generates |
.Xr mdoc 7 |
.Xr mdoc 7 |
from the |
and |
.Aq refentry |
.Xr eqn 7 |
section of DocBook source, ignoring other sections. |
from the <refentry> section of DocBook source, ignoring other sections. |
If unspecified or |
If unspecified or |
.Ar \&- , |
.Sq Cm \- , |
.Ar file |
.Ar file |
is taken to be standard input. |
is taken to be standard input. |
|
.Pp |
The arguments are as follows: |
The arguments are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Fl W |
.It Fl W |
Line 46 Output non-fatal warning messages. |
|
Line 47 Output non-fatal warning messages. |
|
.Pp |
.Pp |
.Nm |
.Nm |
supports only well-formed XML DocBook V4.x until V5.1. |
supports only well-formed XML DocBook V4.x until V5.1. |
|
Some earlier DocBook constructs are accepted as well. |
SGML DocBook documents may be parsed unless they contain SGML-specific |
SGML DocBook documents may be parsed unless they contain SGML-specific |
constructs, such as empty end tags |
constructs, such as empty end tags |
.Li </> . |
.Li </> . |
The only non-DocBook construct recognised (and discarded) is |
The only non-DocBook constructs recognised are <xi:include\ /> |
.Aq xi:include \(sl . |
.Pq which is discarded |
|
and <mml:*>, which is accepted and converted to |
|
.Xr eqn 7 . |
.Sh EXIT STATUS |
.Sh EXIT STATUS |
.Ex -std |
.Ex -std |
.Sh EXAMPLES |
.Sh EXAMPLES |
|
|
.Dl % docbook2mdoc foo.xml | mandoc | more |
.Dl % docbook2mdoc foo.xml | mandoc | more |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr mandoc 1 , |
.Xr mandoc 1 , |
|
.Xr eqn 7 , |
.Xr mdoc 7 |
.Xr mdoc 7 |
.Sh AUTHORS |
.Sh AUTHORS |
.Nm |
.Nm |
was written by |
was written by |
.Ar Kristaps Dzonsons , |
.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv . |
.Mt kristaps@bsd.lv . |
|
.Sh CAVEATS |
.Sh CAVEATS |
The |
The |
.Nm |
.Nm |
utility is experimental. |
utility is experimental. |
As such, only a modest subset of the |
As such, only a modest subset of the <refentry> domain is accepted. |
.Aq refentry |
|
domain is accepted. |
|
.Pp |
.Pp |
The output |
The output |
.Xr mdoc 7 |
.Xr mdoc 7 |