Subject: Re: CVS commit: src
To: Thomas Klausner <wiz@netbsd.org>
From: Perry E. Metzger <perry@piermont.com>
List: source-changes
Date: 02/04/2005 12:15:20
Thomas Klausner <wiz@netbsd.org> writes:
> On Fri, Feb 04, 2005 at 11:43:27AM -0500, Perry E. Metzger wrote:
>> Go into a directory and type "make html" :)
>> 
>> Apparently some of it has rotted -- bsd.README incorrectly says MKHTML
>> defaults to yes and it doesn't seem to build the pages without
>> explicitly asking -- but the whole infrastructure is there and works.
>
> There is no documentation about this flag in BUILDING.

So what? There is no documentation about lots of options in
options(4), and but if someone removed some of them on that basis alone
they'd probably get lots of hate mail. The right approach is to
document an undocumented but useful facility, not to yank it out by
the roots because it isn't documented.

> The set lists don't support it (i.e. you end up with an
> error if you turn it on).

Yes, and that is easily fixed. There are also some other minor
problems that need fixing.

> I think those should be fixed first...

I'll fix the whole thing. We should also make a decision on whether we
want to ship with the html man pages as well.

Perry