Re: generation of ocamldoc HTML documentation for libs (via cdbs)
On Sat, 2007-08-25 at 15:32 -0400, Eric Cooper wrote:
> On Sat, Aug 25, 2007 at 08:38:32PM +0200, Stefano Zacchiroli wrote:
> > I've just committed an addition to our CDBS class: automatic generation
> > of HTML documentation for libraries using ocamldoc.
> [...]
> > The default I've just committed is that no packages will use ocamldoc
> > per default.
>
> I think the default should be to attempt to run ocamldoc, so that
> maintainers will see the error message and either disable it or add
> support for it in their packages.
In fact I go much further .. I'd mandate regression/unit tests
for the library and force maintainers to disable them if not
provided :) And of course, bounce the package if any tests failed.
[My package does that, much to Mike Furr's annoyance at the
horrendous build times .. but it has found 2 bugs in Ocaml itself
so far]
--
John Skaller <skaller at users dot sf dot net>
Felix, successor to C++: http://felix.sf.net
Reply to: