From mboxrd@z Thu Jan 1 00:00:00 1970 Received: (from majordomo@localhost) by pauillac.inria.fr (8.7.6/8.7.3) id WAA19974; Wed, 25 Sep 2002 22:58:29 +0200 (MET DST) X-Authentication-Warning: pauillac.inria.fr: majordomo set sender to owner-caml-list@pauillac.inria.fr using -f Received: (from weis@localhost) by pauillac.inria.fr (8.7.6/8.7.3) id WAA19969 for caml-list@pauillac.inria.fr; Wed, 25 Sep 2002 22:58:24 +0200 (MET DST) Received: from nez-perce.inria.fr (nez-perce.inria.fr [192.93.2.78]) by pauillac.inria.fr (8.7.6/8.7.3) with ESMTP id VAA17743 for ; Wed, 25 Sep 2002 21:02:44 +0200 (MET DST) Received: from main.gmane.org (main.gmane.org [80.91.224.249]) by nez-perce.inria.fr (8.11.1/8.11.1) with ESMTP id g8PJ2fD25112 for ; Wed, 25 Sep 2002 21:02:43 +0200 (MET DST) Received: from list by main.gmane.org with local (Exim 3.35 #1 (Debian)) id 17uHQd-0004kf-00 for ; Wed, 25 Sep 2002 21:02:31 +0200 To: caml-list@inria.fr X-Injected-Via-Gmane: http://gmane.org/ Received: from news by main.gmane.org with local (Exim 3.35 #1 (Debian)) id 17uHQd-0004kW-00 for ; Wed, 25 Sep 2002 21:02:31 +0200 Path: not-for-mail From: "=?iso-8859-1?q?Micha=EBl_Gr=FCnewald?=" Subject: [Caml-list] Re: ocamldoc and packing Date: 25 Sep 2002 21:05:07 +0200 Organization: (none) Message-ID: <87ofalyjoc.fsf@ketanu.dyndns.org> References: <8765wullfw.fsf@ketanu.dyndns.org> <20020925093614.7ef89906.maxence.guesdon@inria.fr> NNTP-Posting-Host: amontpellier-203-1-4-220.abo.wanadoo.fr Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Trace: main.gmane.org 1032980551 18259 80.14.105.220 (25 Sep 2002 19:02:31 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Wed, 25 Sep 2002 19:02:31 +0000 (UTC) User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.2 Sender: owner-caml-list@pauillac.inria.fr Precedence: bulk Maxence Guesdon writes: > > Would it be possible to have a `-pack' option in ocamldoc, that works in > > a consistant way with the homologous option of the compiler ? This is > > not something `vital' but could help in build-automation. > > This is possible. Correct me if I'm wrong : ocamldoc -pack name> ... Although i have read it carefully, i did not spot this option in the documentation for ocamldoc (from the `Ocaml System release 3.06'). I have just read it (what is preterit for `read' ?) a little bit carefully with grep. $ ocamldoc -pack -o pomme.tex -latex misc.ml coding.ml /usr/local/bin/ocamldoc: unknown option `-pack'. Info that helps: $ ocamldoc -version OCamldoc 3.06 > > It should create a single module containing the given modules. All > > absolute module names should be prefixed with the final module name. > Is that the desired behaviour ? It sounds quite right. The desired behaviour is to keep consistence between the description of modules (in documentation), and their hierarchy (from the ocaml's point of view). e.g. Given the source files named channel.ml coding.ml line.ml dialog.ml and ancillary.ml, that describes modules useful in implementing line oriented porotocols on the internet (a la FTP, SMTP, CDDB, and so on). I wish to build a library that provides these modules, but more, with HTTP, FTP, SMTP, etc... There would at end be a plethora of modules, and user could fas be overhelm by them, so i imagined it was good style in packing what could be a library of very tight bounded software components into higher level modules, and distribute them into a library. For instance the above mentioned modules could be packed into the module `Textnet' that would come along in the library with modules Ftp, Http, Smtp, etc ... So the documentation must reflect that modules Channel, Coding, Line, Dialog, ... are in the Textnet module, and this is what (i think) should do the pack option used in this case. It could be also possible to use Makefile and sed/awk script for having a dumb textnet.ml file automtically generated, with these modules into it (and it can be a satisfactory answer for me). -- Michaël Grünewald - RSA PGP Key ID: 0x20D90C12 ------------------- 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