From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.1.3 (2006-06-01) on yquem.inria.fr X-Spam-Level: X-Spam-Status: No, score=0.0 required=5.0 tests=AWL autolearn=disabled version=3.1.3 X-Original-To: caml-list@yquem.inria.fr Delivered-To: caml-list@yquem.inria.fr Received: from mail1-relais-roc.national.inria.fr (mail1-relais-roc.national.inria.fr [192.134.164.82]) by yquem.inria.fr (Postfix) with ESMTP id 2CFDFBBC1 for ; Thu, 1 May 2008 00:16:38 +0200 (CEST) X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AhsCADKNGEjAXQIniGdsb2JhbACRWAEBAQ8gnAU X-IronPort-AV: E=Sophos;i="4.25,730,1199660400"; d="scan'208";a="11709199" Received: from concorde.inria.fr ([192.93.2.39]) by mail1-smtp-roc.national.inria.fr with ESMTP; 01 May 2008 00:16:23 +0200 Received: from mail4-relais-sop.national.inria.fr (mail4-relais-sop.national.inria.fr [192.134.164.105]) by concorde.inria.fr (8.13.6/8.13.6) with ESMTP id m3UMGLqK026825 (version=TLSv1/SSLv3 cipher=RC4-SHA bits=128 verify=OK) for ; Thu, 1 May 2008 00:16:23 +0200 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: ApUBAL2MGEjCpx6wlWdsb2JhbACRWAEBAQEJBQYanAM X-IronPort-AV: E=Sophos;i="4.25,730,1199660400"; d="scan'208";a="25718155" Received: from smtpmin.univ-orleans.fr (HELO min.univ-orleans.fr) ([194.167.30.176]) by mail4-smtp-sop.national.inria.fr with ESMTP; 01 May 2008 00:16:21 +0200 Received: from smtps.univ-orleans.fr (localhost [127.0.0.1]) by min.univ-orleans.fr (Postfix) with ESMTP id 1F4CE12B3F1 for ; Thu, 1 May 2008 00:16:21 +0200 (CEST) Received: from [192.168.0.12] (ras75-4-82-235-58-110.fbx.proxad.net [82.235.58.110]) by smtps.univ-orleans.fr (Postfix) with ESMTP id 9AE1F36E5B for ; Thu, 1 May 2008 00:16:25 +0200 (CEST) Subject: Documenting submodules ? From: David Teller To: OCaml Content-Type: text/plain Date: Thu, 01 May 2008 00:17:44 +0200 Message-Id: <1209593864.6823.36.camel@Blefuscu> Mime-Version: 1.0 X-Mailer: Evolution 2.12.1 Content-Transfer-Encoding: 7bit X-Miltered: at concorde with ID 4818EFB6.000 by Joe's j-chkmail (http://j-chkmail . ensmp . fr)! X-Spam: no; 0.00; submodules:01 univ-orleans:01 ocamldoc:01 ocamldoc:01 mli:01 cheers:01 univ-orleans:01 lifo:01 plug-in:98 plug-in:98 liquidations:98 rewrite:01 modules:02 modules:02 essentially:02 Dear list, As mentioned previously, I'm working on a derivative of ExtLib (promised, I'll submit the changes within a few days). I've put together most of the features I want for now, but I'm faced with a problem of documentation. Essentially, I have a few big modules containing each a few smaller modules -- each smaller module being defined in one file. When invoking ocamldoc, either directly or through ocamlbuild + .odocl, the generated documentation only contains the name of modules, without any of the comments or even the values. Is there any ocamldoc plug-in or ocamlbuild plug-in or anything else that could help me document my code without having to rewrite everything and/or to copy and paste thousands of lines of .mli ? Cheers, David -- David Teller Security of Distributed Systems http://www.univ-orleans.fr/lifo/Members/David.Teller Angry researcher: French Universities need reforms, but the LRU act brings liquidations.