[Caml-list] OCamlDoc: @-tags handled only in the standard elements?

[Kenichi Asai <asai@is.ocha.ac.jp>]

I thought I could provide documents in two languages using custom tags
in OCamlDoc, but there still remains a problem.  It appears that the
custom tags (in my case, @en and @jp) are not handled in

- the very first comment,
- special comments between elements, and
- comments for type constructors, etc.

Is there any way to support custom tags in all the places including
the above?  -- Currently, it seems not, as the OCamlDoc says:

http://caml.inria.fr/pub/docs/manual-ocaml/ocamldoc.html

Section 15.2.1:

> (** Special comments can be placed between elements and are kept
>     by the OCamldoc tool, but are not associated to any element.
>     @-tags in these comments are ignored.*)

Section 15.2.3:

> Some elements support only a subset of all @-tags. Tags that are not
> relevant to the documented element are simply ignored. For instance,
> all tags are ignored when documenting type constructors, record
> fields, and class inheritance clauses. Similarly, a @param tag on a
> class instance variable is ignored.

Why aren't all the comments handled in the same way?  It appears to be
easier to handle all the comments in the same way.  Is there any
chance that it will become as such?

Sincerely,

-- 
Kenichi Asai