Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Duplicate module preambles are generated by ocamldoc #7478

Closed
vicuna opened this issue Feb 9, 2017 · 3 comments
Closed

Duplicate module preambles are generated by ocamldoc #7478

vicuna opened this issue Feb 9, 2017 · 3 comments
Assignees
Milestone

Comments

@vicuna
Copy link

vicuna commented Feb 9, 2017

Original bug ID: 7478
Reporter: @dbuenzli
Assigned to: @Octachron
Status: resolved (set by @Octachron on 2017-08-09T09:44:37Z)
Resolution: fixed
Priority: normal
Severity: minor
Version: 4.04.0
Target version: 4.06.0 +dev/beta1/beta2/rc1
Fixed in version: 4.06.0 +dev/beta1/beta2/rc1
Category: ocamldoc
Tags: github
Monitored by: @gasche @dbuenzli

Bug description

I suspect this is not a doc attachement issue (at least the dupe doesn't happen with odoc on 4.03). With ocamldoc 4.0{4,3}.0, "Hey ho" shows up twice in the generated doc. Note that if you remove the 'open String' this doesn't happen.

Steps to reproduce

cat bla.mli

open String

(** Hey ho *)

ocamldoc -html bla.mli

@vicuna
Copy link
Author

vicuna commented Feb 10, 2017

Comment author: @Octachron

This is indeed not so much an attachment issue, but a problem with the extraction of the module preamble within ocamldoc: ocamldoc considers that the first documentation comment is the module preamble and then skip this comment, if and only if this comment was an unattached documentation comment before any module elements.

As an illustration, the following signature does also generate a duplicated
comment:

(a.mli)
val x: unit
(** This comment will be used as amodule preamble and a documentation comment for x *)

@vicuna
Copy link
Author

vicuna commented Feb 10, 2017

Comment author: @Octachron

A possible fix implemented in #1037 is to only use as module preamble documentation comments that occur before any module elements.

@vicuna
Copy link
Author

vicuna commented Aug 9, 2017

Comment author: @Octachron

Fixed by the integration of the above PR.

@vicuna vicuna closed this as completed Aug 9, 2017
@vicuna vicuna added this to the 4.06.0 milestone Mar 14, 2019
@vicuna vicuna added the bug label Mar 20, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants