discuss: man program able to use docbook files instead man-pages
Subject:
Re: man program able to use docbook files instead man-pages
From:
Hal Burgiss ####@####.####
Date:
14 Jul 2002 02:25:29 -0000
Message-Id: <20020713222528.L2027@feenix.burgiss.net>
On Sat, Jul 13, 2002 at 07:58:37PM -0600, Charles Curley wrote:
> [root@charlesc jhereg]# ls /usr/bin/docbook2*
> /usr/bin/docbook2dvi /usr/bin/docbook2pdf /usr/bin/docbook2tex
> /usr/bin/docbook2html /usr/bin/docbook2ps /usr/bin/docbook2texi
> /usr/bin/docbook2man /usr/bin/docbook2rtf /usr/bin/docbook2txt
>
>
> Hmmm, these may be worth looking into.
These I think have different origins. They are basically wrappers of
jw (itself a wrapper :), this one wiggles around to:
# Backend to convert a DocBook file into a man page
# Send any comments to Jochem Huhmann ####@####.####
# This program is under GPL license. See LICENSE file for details.
# Convert to *roff
nsgmls $SGML_FILE | sgmlspl \
$SGML_BASE_DIR/docbook/utils-0.6.9/helpers/docbook2man-spec.pl
if [ $? -ne 0 ]
then exit 1
fi
exit 0
and that perl script does all the real work. Which is from cygnus. It
is mostly usable, but does have some shortcomings. It completely
chokes on some common character entities like and ©. Also,
I think I tried the pdf one, and it produced fairly lousy pdf.
--
Hal Burgiss