odoc (генератор документации для OCaml) удаляет префикс ‘Stdlib’

#ocaml #ocaml-dune #ocamldoc

#ocaml #ocaml-дюна #ocamldoc

Вопрос:

Я использую odoc вместе с dune для создания документации для библиотеки. Это достигается путем выполнения: dune build @doc

Однако при этом генерируются такие сигнатуры, как:

 val print : Stdlib.Format.formatter -> t -> unit
 

В то время как то, что я хотел бы, это:

 val print : Format.formatter -> t -> unit
 

OCamldoc использовался для предоставления опции -hide, которая могла бы сделать именно это. Есть ли у odoc что-то подобное? Если да, то как использовать его из dune?

Возможно, было бы идеально иметь ссылку на модуль форматирования Stdlib, но это, возможно, требует слишком многого

Ответ №1:

Нет, у odoc не было чего-то подобного в то время, когда я задавал вопрос. Однако, похоже, что теперь это (или скоро будет) так, благодаря этому PR, который позволяет вам указывать, какие модули открывать по умолчанию, выполнив:

 odoc compile --open=Stdlib