version 1.1, 2014/03/28 11:20:07 |
version 1.6, 2014/10/12 15:08:45 |
|
|
.Nm docbook2mdoc |
.Nm docbook2mdoc |
.Nd Convert DocBook refentry to mdoc |
.Nd Convert DocBook refentry to mdoc |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm docbook2man |
.Nm docbook2mdoc |
.Op Ar file |
.Op Ar file |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
|
|
and |
and |
generates |
generates |
.Xr mdoc 7 |
.Xr mdoc 7 |
|
and |
|
.Xr eqn 7 |
from the |
from the |
.Aq refentry |
.Aq refentry |
section of DocBook source. |
section of DocBook source, ignoring other sections. |
If unspecified or |
If unspecified or |
.Ar \&- , |
.Ar \&- , |
.Ar file |
.Ar file |
is taken to be standard input. |
is taken to be standard input. |
It accepts no arguments. |
The arguments are as follows: |
|
.Bl -tag -width Ds |
|
.It Fl W |
|
Output non-fatal warning messages. |
|
.El |
|
.Pp |
|
.Nm |
|
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 |
|
constructs, such as empty end tags |
|
.Li </> . |
|
The only non-DocBook construct recognised are |
|
.Aq xi:include \(sl |
|
.Pq which is discarded |
|
and |
|
.Aq mml:* , |
|
which is accepted and converted to |
|
.Xr eqn 7 . |
.Sh EXIT STATUS |
.Sh EXIT STATUS |
.Ex -std |
.Ex -std |
.Sh EXAMPLES |
.Sh EXAMPLES |
|
|
The |
The |
.Nm |
.Nm |
utility is experimental. |
utility is experimental. |
As such, only a small subset of the |
As such, only a modest subset of the |
.Aq refentry |
.Aq refentry |
domain is accepted. |
domain is accepted. |
|
.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. |