Join GitHub today
GitHub is home to over 36 million developers working together to host and review code, manage projects, and build software together.Sign up
Ocamldoc in trunk produces multiple copies of a title #7075
Original bug ID: 7075
For example, in Pervasives. See attached screenshot.
The problem is not in the source file. The problem does not occur in 4.02.3.
Comment author: @johnwhitington
If the documentation here...
...was generated by an OCamldoc shipped with 4.02.3, then this bug shows a regression from 4.02.3 to current trunk.
Whereas 0006964 is marked as being present in 4.02.3.
Comment author: @dbuenzli
I would say this is not the case: the documentation comment structure changed:
git blame pervasives.mli
Comment author: @Octachron
As another data point, the documentation for the Scanf module ends up being completely scrambled. Section titles and entire subsections are repeated multiple times. For instance, I count no less than 8 repetitions of the "Introduction" section title.
The problem seems to stem from the presence of consecutive sequences of separated documentation comments. Merging together these documentation comments remove the stuttering.
Moreover, there is also redoubled section title in the following module documentation