Re: Manual pages

From: Dave Hudson <dave_at_nospam.org>
Date: Tue May 10 1994 - 10:01:44 PDT

Andrew Valencia wrote:
>
> Note, these comments apply exclusively to man pages. The requirements of a
> "tip of the finger" documentation reference system are unique, and I think
> the choices you've outlined here are great for README, Info, papers, and so
> forth.

Having written a few man pages for Linux I found I could pick up roff formats
reasonably well - the other's all look huge. I just downloaded the SGML
tools that the Linux document crowd are using to convert SGML to just about
everything else (HTML coming soon apparently) and the compressed sources
alone were 340k :-( I think there'd be a practical difficulty there as well
as I think it uses flex/lex to build some of the sources (I've no idea about
lex so I don't know how easy/difficult it would be to get it running on
VSTa).

I like the idea that maybe we could find or build a utility to convert roff
to one of these more general (I think) formatting systems.

Anyway if there are no overriding objections to the locations I suggested
I'll start writing a few server man pages.

                Regards,
                Dave
Received on Tue May 10 12:11:54 1994

This archive was generated by hypermail 2.1.8 : Wed Sep 21 2005 - 21:04:28 PDT