The User's Manual discusses items that are part of the "official" OCaml
distribution from Inria. OCamldoc has long served the community and
continues to be widely used. On the other hand, the community has recently
initiated quite a few projects to improve many things, a documentation tool
being one of them. Over time, you're probably right that some topics in the
User's Manual should defer to other resources like ocaml.org (which is
itself being enhanced in many ways).



On Tue, Oct 8, 2013 at 12:59 PM, Matej Kosik <
5764c029b688c1c0d24a2e97cd764f@gmail.com> wrote:

> On 08/10/13 16:24, Ashish Agarwal wrote:
> > OCamldoc has trouble finding references to modules in some cases. I
> wouldn't worry about it. See the opam-doc project [1], which aims to
> provide a more robust documentation tool.
> >
> > [1] http://www.cl.cam.ac.uk/projects/ocamllabs/tasks/platform.html#OPAMDoc
>
> I wonder, why is ocamldoc mentioned in the User's Manual [2] if people, as
> you suggest, are not supposed to be worried about it and, on the other
> hand, there is no trace of OPAM therein.
>
> A puzzle.
>
> [2] http://caml.inria.fr/pub/docs/manual-ocaml/
>