Mantis Bug Tracker

View Issue Details Jump to Notes ] Issue History ] Print ]
IDProjectCategoryView StatusDate SubmittedLast Update
0006707OCamlocamldocpublic2014-12-12 08:302014-12-12 16:41
Reporterasai 
Assigned Toguesdon 
PrioritynormalSeverityfeatureReproducibilityalways
StatusconfirmedResolutionopen 
PlatformAppleOSMacOS XOS Version10.8
Product Version4.01.0 
Target VersionFixed in Version 
Summary0006707: custom tags not handled for some elements
DescriptionIt appears that custom tags are not handled in:
- the very first comment,
- special comments between elements, and
- comments for type constructors, etc.
cf. Sections 15.2.1 and 15.2.3 of
http://caml.inria.fr/pub/docs/manual-ocaml/ocamldoc.html [^]
I would request that custom tags are handled uniformly in all the elements.
Steps To ReproduceAttached file contains an example where documents are written both in English (after @en tag) and in Japanese (after @ja tag). By passing "-lang en" or "-lang ja" argument to ocamldoc, I want to select the corresponding documents. However, the documents in the html-* directories obtained by executing "make" are not as expected.
- the first text "module header in *" is ignored, but it should appear in index.html. (If I remove "@en", the text appears there.)
- the two "Session header" texts are ignored, but they should appear in Test.html.
- the texts for "A" and "B" are ignored, but they should appear in Test.html.
TagsNo tags attached.
Attached Filesgz file icon test.tar.gz [^] (1,066 bytes) 2014-12-12 08:30

- Relationships

-  Notes
(0012768)
gasche (developer)
2014-12-12 15:50

I reproduced the issue -- I also tried to see how to fix it, but I don't understand ocamldoc's internals well enough for that. It would be interesting to have a workaround of the form "just overload this other method and you'll be able to override this default behavior".

- Issue History
Date Modified Username Field Change
2014-12-12 08:30 asai New Issue
2014-12-12 08:30 asai Status new => assigned
2014-12-12 08:30 asai Assigned To => guesdon
2014-12-12 08:30 asai File Added: test.tar.gz
2014-12-12 15:50 gasche Note Added: 0012768
2014-12-12 15:50 gasche Status assigned => confirmed
2017-02-23 16:46 doligez Category OCamldoc => ocamldoc


Copyright © 2000 - 2011 MantisBT Group
Powered by Mantis Bugtracker