Lambda package docs incorrectly link to compiler-libs instead of the lambda library

[edwintorok]

Following the docs link on this package https://ocaml.org/p/lambda/latest/doc/index.html
leads here: https://ocaml.org/p/ocaml-base-compiler/5.1.1/doc/Lambda/index.html

Which is the Lambda module in compiler-libs, not the Lambda module in the lambda library!

This is what that library actually contains: https://dakk.github.io/lambda/lambda/Lambda/index.html

I'm assuming that page is generated by odoc or a related tool, sorry if I opened this in the wrong place.

[jonludlam]

Thanks for the report Edwin! I believe this will be fixed by the new odoc driver that will soon be used to generate the docs on ocaml.org. In fact you can see this by looking at a preview of the raw data that ocaml.org will be using to render the pages: http://5.102.169.186:8888/p/lambda/0.1.7/doc/

FYI the problem is almost a consequence of the current (odoc 2.4) layout, where we don't try separate the libraries of a package at all - so in the case of ocaml-base-compiler, the unwrapped modules of compiler-libs are all in the same place as stdlib, and it looks like in this case odoc has picked up the lambda module from there by mistake.

In odoc 3, we try much harder to separate modules by library, so this problem won't arise - ie, adding stdlib to the search path will no longer add all the compiler-libs modules. The Lambda module from compiler libs is here: http://5.102.169.186:8888/p/ocaml-base-compiler/5.2.0/doc/compiler-libs.common/Lambda/index.html - so you can see that, in comparison with the URL you posted above, there's an extra directory compiler-libs.common in there

The beta of odoc 3 has been merged to opam repository, so you can see the difference by installing odoc-driver and running odoc_driver lambda.