Re: mdocml: Unify mdoc and man enums and structs into mandoc.h.

[Kristaps Dzonsons <kristaps@bsd.lv>]

> Many, and conflicting ones; so i cannot present final solutions,
> but some thoughts indeed.

Ingo, yeah, by the large I agree---for the time being I'll revert the 
changes.

> Regarding libmandoc.a, sure.  Actually, i don't see much of a point
> in having libraries at all in this context; i doubt that anybody will
> ever want to use the parsers outside the mandoc program, or, put
> the other way round, all functionality that can reasonably be based
> on the mdoc language can probably reasonably be included into the
> mandoc binary program.
> 
> Regarding makewhatis, apropos and man.cgi, i do not have much hope.
> Remember that those must be able to work on the -Tascii output,
> at least in OpenBSD, because that's the only version of the manuals
> getting installed, and there is next to no hope to have that changed,
> based on what Theo and Bob say.  Besides, i don't really see a need
> to install manual source code either.  On a typical production
> system, you don't need manual source code, just as you don't need
> program source code; besides, the src.tar.gz ball is readily
> available for each release, and anonymous CVS is not rocket science
> either, in case you need the sources for some reason.

I agree, but this is not relevant: if OpenBSD doesn't want to use the 
libraries, the object files can be linked directly into mandoc.

> Regarding mandoc.h, actually, i still don't see the point.
> Why should a file like mdoc_macro.c, or even mdoc_term.c,
> be forced to include man data structures and function prototypes?
> In the current implementation, there is not a single file
> including both man.h and mdoc.h or both libman.h and libmdoc.h,
> except main.c and tree.c.  And even if there were one or two
> such files:  What is the advantage of a frontend file including
> just mandoc.h instead of man.h and mdoc.h?

Yep, this is the reason for my patch reversion.  Pushing libmdoc, 
libman, and libroff tighter together can occur without header merging of 
the {man,mdoc,roff}.h headers.

Kristaps
--
 To unsubscribe send an email to tech+unsubscribe@mdocml.bsd.lv