ocamldoc comments no longer in the cmt_comments field of .cmt files #6972
Original bug ID: 6972
Since the store-ocamldoc-comments-as-attributes-in-the-AST change in 4.02.2, the cmt_comments part of .cmt files only contains non-ocamldoc comments. This broke my program that was looking for ocamldoc comments there.
I'm not sure this was intended, just reporting this in case it was an oversight.
Comment author: @trefis
The only difference I could notice between 4.02.1 and >=4.02.2 is that before 4.02.2 an ocamldoc comment would be stored with a leading star, whereas now you don't have that star anymore (since '(**' is now handled specially).
If you tool relied on that, maybe that explains the breakage?
Comment author: @alainfrisch
My question was rather rhetorical. Since comments are delimited by (...), it seems pretty clear that the "payload" of (*FOO) is "*FOO". The fact that ocamldoc-like comments are recognized in a special way and passed through attribute is an addition, it should not break existing tools that rely on finding "*FOO" in the cmt files (esp. when the new -keep-docs is not used).