version 1.1, 2014/03/28 11:20:07 |
version 1.2, 2014/04/02 12:27:05 |
|
|
.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 |
|
|
.Xr mdoc 7 |
.Xr mdoc 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. |
It accepts no arguments. |
|
.Pp |
|
.Nm |
|
supports only well-formed XML DocBook V4.x until V5.1. |
|
SGML DocBook documents may be parsed unless they contain SGML-specific |
|
constructs, such as empty end tags |
|
.Li </> . |
.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. |