odoc
odoc copied to clipboard
404 and canonical
As reported by @lukemaurer:
Getting a 404 out of a pretty simple issue with
@canonical. The repro case is pleasingly small, if janky (compiled aslibrary.ml):(** @canonical Library.Submodule *) module Submodule_ = struct module Export = struct end end module Submodule = Submodule_.ExportThe odoc3 beta gives a page that says
module Submodule = Submodule.Export(note that the double underscore is gone) but the link goes to
/Library/Submodule_/Export/Export/index.htmlwhich is a 404 (extraExport). This also works withSubmodule_renamed toSubmodule__(in which case of courseExportandExport/Exportare both wrong). Obviously that@canonicalis wrong, but there's not much of a way around it (it's generated by Dune). I imagine the best we can do is render it as a broken reference?