[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: SGML Man Pages?

On Mon, Sep 18, 2000 at 04:05:12PM -0700, Colin Mattson wrote:

> On Mon, Sep 18, 2000 at 04:38:43PM -0600, Jason Gunthorpe wrote:
> > Here is an interesting observation I just made while perusing a Solaris
> > install at school. They have SGML man pages. Their man pages are a subset
> > of the standard DocBook DTD which is now being used by the Linux
> > Documentation Project.
> I'm not well-versed in SGML manpages, but if you've ever done a package
> the "New Maintainer's Guide" way (with dh_make), you'll note that there's
> an example SGML manpage in the debian subdirectory of the build dir...
> I would assume this means Debian supports these to some extent, but I've never
> looked into it (I nuke *.ex when I use dh_make since most software I've played
> with includes a manpage, and the Debian-specific stuff I want I can do by
> hand/memory).

It is pretty easy to write manpages in SGML and convert them to nroff at
compile time (as the dh_make example does), but what Sun does is much nicer,
installing the SGML on the system, and converting it SGML->nroff->ASCII for
viewing.  This allows the user performing other renderings, including HTML and
printed documentation, from the installed documentation.

 - mdz

Reply to: