Version française
Home     About     Download     Resources     Contact us    

This site is updated infrequently. For up-to-date information, please visit the new OCaml website at

Browse thread
code links in ocamldoc -intro files
[ Home ] [ Index: by date | by threads ]
[ Search: ]

[ Message by date: previous | next ] [ Message in thread: previous | next ] [ Thread: previous | next ]
Date: 2006-07-14 (03:46)
From: Eric Breck <ebreck@c...>
Subject: code links in ocamldoc -intro files
Hi folks,

Is this a bug?

ocamldoc has the "-intro" option, letting you provide a file in  
ocamldoc comment form, which is formatted like a code comment,  
becoming the intro page of your documentation.  But it behaves  
slightly differently from a code comment - code links don't work. is

   let to_string () = "()"

intro.camldoc is

   Reference to {!Test.to_string} is just like intro.camldoc but enclosed in (** / *)


ocamldoc -html

ocamldoc -html -intro intro.camldoc

both format the text in intro.  Apart from navigation info, they're  
formatted the same - except that for, {!Test.to_string}  
turns into a hyperlink to Test.html#VALto_string, and in  
intro.camldoc, it doesn't.

Any idea why?


Eric Breck