Version française
Home     About     Download     Resources     Contact us    
Browse thread
[Caml-list] strange behaviour of ocamldoc
[ Home ] [ Index: by date | by threads ]
[ Search: ]

[ Message by date: previous | next ] [ Message in thread: previous | next ] [ Thread: previous | next ]
Date: -- (:)
From: Eugene Ossintsev <eugos@g...>
Subject: [Caml-list] strange behaviour of ocamldoc
Hello,

In OCaml 3.08.0 and 3.08.1 (not tested with the other versions) it seems 
that ocamldoc behaves strangely in the following case:

foo.mli:
--------
(** Supported URL schemes. *)
type url_scheme =
   | Http  (** Hypertext Transfer Protocol *)
   | Ftp   (** File Transfer protocol *)
   | File  (** Local file access *)

ocamldoc foo.mli writes the error message:

        foo.mli : lexing: empty token.

That error occurs if in the (** *)-comment of an enumerated type there 
exists a word (or, more exactly, a combination of letters) matching the 
name of the following enumerated type or a part of the name of that 
type. In the above example it is "File".

In other words, any of those combinations gives the error:

(** Comments *)
type my_type =
   | Aaa (** foo Bbb bar *)
   | Bbb (** blah-blah *)

(** Comments *)
type my_type =
   | Aaa (** foo Bbb bar *)
   | Bb  (** blah-blah *)

(** Comments *)
type my_type =
   | Aaa (** foo Bbb bar *)
   | B   (** blah-blah *)

Could you help me solve the problem? What am I doing wrong?

-- 
Eugene Ossintsev

-------------------
To unsubscribe, mail caml-list-request@inria.fr Archives: http://caml.inria.fr
Bug reports: http://caml.inria.fr/bin/caml-bugs FAQ: http://caml.inria.fr/FAQ/
Beginner's list: http://groups.yahoo.com/group/ocaml_beginners