On Fri, Feb 04, 2005 at 12:13:07PM -0500, Perry E. Metzger wrote:
> We have a set of documented build switches that fill those
> directories.
On Fri, Feb 04, 2005 at 12:15:20PM -0500, Perry E. Metzger wrote:
> Thomas Klausner <wiz@netbsd.org> writes:
> > 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.

You should get your story straight.

Anyway, we seem to agree it's undocumented (since your later
mail says so too).

Thanks for pointing out the MKHTML setting, and that 'make html'
actually does generate html pages.

> > 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 documented some of them in PRs 29233 to 29242.
From looking at the man pages generated for a*(4), I think
it's the base for something useful, but it's not quite there
yet. It definitely needs more work before it can be turned on
by default (if ever -- after all, we don't ship with something
to parse and display HTML code).

I have no problem with re-adding the html directories, now that
there is someone who's working on making them useful.

I disagree with how it was done, though. Didn't you trust
your arguments, or are you suggesting I'm not susceptible
to arguments?
 Thomas