Re: generation of ocamldoc HTML documentation for libs (via cdbs)

[Eric Cooper <ecc@cmu.edu>]

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.

BTW, how does this work when using cdbs + OCamlMakefile, which already
has a simple "htdoc" target and OCAMLDOCFLAGS variable?

Right now, my Makefile has
    DEB_MAKE_BUILD_TARGET = htdoc byte-code-library
    ifeq ($(OCAML_HAVE_OCAMLOPT),yes)
	DEB_MAKE_BUILD_TARGET += native-code-library
    endif
and there is a file libfoo-ocaml-dev.docs containing
    doc/foo/html

-- 
Eric Cooper             e c c @ c m u . e d u