Subject: Re: keeping doco up-to-date w/ code
To: None <tech-userlevel@NetBSD.org>
From: David Young <firstname.lastname@example.org>
Date: 05/16/2005 10:19:07
On Mon, May 16, 2005 at 03:58:31PM +0200, Igor Sobrado wrote:
> I am looking for achieving two goals:
> - *snip snip*
> - update (and sometimes fix!) the ``usage'' messages in some
> commands that are either outdated or incorrect. This goal
> will require a lot of work on the mailing list, though!
> Some of these errors are easy to see, in other cases
> perhaps I am wrong. I will submit a detailed description
> of changes as soon as I see the big picture and have a detailed
> list of all changes I will propose.
It would help us keep usage and other doco up-to-date if we had a
high-level language for describing command usage. Two "compilers"
would turn the high-level descriptions either into C code for parsing
the command-line, or into SYNOPSIS and skeletal DESCRIPTION sections
for a manual page.
David Young OJC Technologies
email@example.com Urbana, IL * (217) 278-3933