From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Original-To: caml-list@yquem.inria.fr Delivered-To: caml-list@yquem.inria.fr Received: from concorde.inria.fr (concorde.inria.fr [192.93.2.39]) by yquem.inria.fr (Postfix) with ESMTP id 703D0BB84 for ; Fri, 14 Jul 2006 05:46:31 +0200 (CEST) Received: from pauillac.inria.fr (pauillac.inria.fr [128.93.11.35]) by concorde.inria.fr (8.13.6/8.13.6) with ESMTP id k6E3kUGU023617 for ; Fri, 14 Jul 2006 05:46:31 +0200 Received: from concorde.inria.fr (concorde.inria.fr [192.93.2.39]) by pauillac.inria.fr (8.7.6/8.7.3) with ESMTP id FAA19238 for ; Fri, 14 Jul 2006 05:46:30 +0200 (MET DST) Received: from exchfe2.cs.cornell.edu (exchfenlb-2.cs.cornell.edu [128.84.97.34]) by concorde.inria.fr (8.13.6/8.13.6) with ESMTP id k6E3kTo3023603 for ; Fri, 14 Jul 2006 05:46:30 +0200 Received: from exchfe2.cs.cornell.edu ([128.84.97.28]) by exchfe2.cs.cornell.edu with Microsoft SMTPSVC(6.0.3790.1830); Thu, 13 Jul 2006 23:46:26 -0400 Received: from [192.168.1.100] ([24.59.194.44]) by exchfe2.cs.cornell.edu over TLS secured channel with Microsoft SMTPSVC(6.0.3790.1830); Thu, 13 Jul 2006 23:46:26 -0400 Mime-Version: 1.0 (Apple Message framework v750) Content-Transfer-Encoding: 7bit Message-Id: <8E45EB16-449E-4464-8E0F-11270568978C@cs.cornell.edu> Content-Type: text/plain; charset=US-ASCII; delsp=yes; format=flowed To: caml-list@inria.fr From: Eric Breck Subject: code links in ocamldoc -intro files Date: Thu, 13 Jul 2006 23:47:13 -0400 X-Mailer: Apple Mail (2.750) X-OriginalArrivalTime: 14 Jul 2006 03:46:26.0604 (UTC) FILETIME=[154BFEC0:01C6A6F8] X-Miltered: at concorde with ID 44B71397.000 by Joe's j-chkmail (http://j-chkmail.ensmp.fr)! X-Miltered: at concorde with ID 44B71395.001 by Joe's j-chkmail (http://j-chkmail.ensmp.fr)! X-Spam: no; 0.00; ocamldoc:01 bug:01 ocamldoc:01 behaves:01 -html:01 -html:01 hyperlink:98 cornell:01 slightly:02 string:02 string:02 let:03 differently:07 folks:07 edu:08 X-Spam-Checker-Version: SpamAssassin 3.0.3 (2005-04-27) on yquem.inria.fr X-Spam-Level: X-Spam-Status: No, score=0.0 required=5.0 tests=none autolearn=disabled version=3.0.3 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. test.ml is let to_string () = "()" intro.camldoc is Reference to {!Test.to_string} intro.ml is just like intro.camldoc but enclosed in (** / *) now ocamldoc -html intro.ml test.ml ocamldoc -html -intro intro.camldoc test.ml both format the text in intro. Apart from navigation info, they're formatted the same - except that for intro.ml, {!Test.to_string} turns into a hyperlink to Test.html#VALto_string, and in intro.camldoc, it doesn't. Any idea why? best, Eric Breck