From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <mrchebas@gmail.com>
X-Spam-Checker-Version: SpamAssassin 3.1.3 (2006-06-01) on yquem.inria.fr
X-Spam-Level: **
X-Spam-Status: No, score=2.8 required=5.0 tests=DNS_FROM_RFC_POST,SPF_NEUTRAL 
	autolearn=disabled version=3.1.3
X-Original-To: caml-list@yquem.inria.fr
Delivered-To: caml-list@yquem.inria.fr
Received: from mail4-relais-sop.national.inria.fr (mail4-relais-sop.national.inria.fr [192.134.164.105])
	by yquem.inria.fr (Postfix) with ESMTP id 60E6CBBAF
	for <caml-list@yquem.inria.fr>; Fri, 11 Sep 2009 17:54:12 +0200 (CEST)
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: AmEBAAIPqkrRVdvfkWdsb2JhbACSBYkAPwEBAQEJCwoHEwOwOIEqkAMBAwIEhBQFgVRy
X-IronPort-AV: E=Sophos;i="4.44,371,1249250400"; 
   d="scan'208";a="46399182"
Received: from mail-ew0-f223.google.com ([209.85.219.223])
  by mail4-smtp-sop.national.inria.fr with ESMTP; 11 Sep 2009 17:54:11 +0200
Received: by mail-ew0-f223.google.com with SMTP id 23so1144956ewy.26
        for <caml-list@inria.fr>; Fri, 11 Sep 2009 08:54:11 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=gamma;
        h=domainkey-signature:mime-version:received:date:message-id:subject
         :from:to:content-type;
        bh=ENlmZGU9bhDSDyVTVA1qbzafR2e8g2OljUYUY4JP+L4=;
        b=lFeog+Ums+ah3pSURxhDK6C4QZMr0MjhiOmD2Ol9h41BrlIhckdW/ztqeF+pFTvwuo
         2K61q7+44TTpfUg8LJ8VPmulIj+eeeX3KWOknJ2s9YJlCqEvaB5GeByGC82GKuZLW0kh
         EPWZQ4GUODT3efUjg5xXOuY5dN2YWAJ7EcnNM=
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:date:message-id:subject:from:to:content-type;
        b=bHew71iJIwxIH8rFRa2STgIoH+8PhsIFu2Q2vv2ec4nnyOuBeqOSUDR2lqlMeC1Pxk
         FGeQrhhVjs+uiQ40b28F2HObc1CLh3r+iZU9qR1bGVvpt15Tak/6T8ArzY5TKVyfJhO8
         aH9jRFFFQ3PfBEvY1TmP+HguXdQQeFTSjU4Kk=
MIME-Version: 1.0
Received: by 10.210.9.7 with SMTP id 7mr3460758ebi.5.1252684029507; Fri, 11 
	Sep 2009 08:47:09 -0700 (PDT)
Date: Fri, 11 Sep 2009 17:47:09 +0200
Message-ID: <4b39c80a0909110847p9571028t54929c334a449d02@mail.gmail.com>
Subject: Ocamldoc and multiple packages
From: Alexey Rodriguez <mrchebas@gmail.com>
To: OCaml List <caml-list@inria.fr>
Content-Type: text/plain; charset=ISO-8859-1
X-Spam: no; 0.00; ocamldoc:01 ocamldoc:01 ocaml:01 -for-pack:01 -pack:01 -load:01 arises:01 -pack:01 cheers:01 modules:02 modules:02 module:03 module:03 problem:05 long:06 

Dear list,

I am trying to build ocamldoc documentation for an ocaml project that
contains multiple packages (collections of modules built using
-for-pack and -pack). My current setup generates documentation for
each package but it won't generate hyperlinks to modules in other
packages (module not found errors). I tried using the -load and -dump
commands to allow ocamldoc see the ocamldoc-results of the referred to
package, but I still get problems. I suspect that the problem arises
because ocamldoc does not have a -pack option, so it always sees
modules in a flat way. So if you have package Pack1 with module A, and
module B in Pack2 which refers to Pack1.A.t, ocamldoc cannot solve
this reference because it does not know that module A is inside
another module called Pack1.

The solutions I see right now seem to involve more effort than I am
willing to spend. So, before I embark on a task that might take too
long I would like to ask for tips on this. How do you perform ocamldoc
generation for projects with multiple packages? Thanks!

Cheers,

Alexey