[Caml-list] ocamldoc and packing

[Caml-list] ocamldoc and packing

[Michaël Grünewald]

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.
-- 
Michaël Grünewald <michael-grunewald@wanadoo.fr>  - 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

Re: [Caml-list] ocamldoc and packing

[Maxence Guesdon]

> 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 <final module name> ...
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 ?

-- 
Maxence Guesdon
-------------------
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

[Caml-list] Re: ocamldoc and packing

[Michaël Grünewald]

Maxence Guesdon <maxence.guesdon@inria.fr> 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 <final module
> 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 <michael-grunewald@wanadoo.fr>  - 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

Re: [Caml-list] Re: ocamldoc and packing

[Maxence Guesdon]

> 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.

Yes, this is not implemented yet, I was just asking if this usage would fit 
the needs. I will add this option.

Cheers,

-- 
Maxence Guesdon
-------------------
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

[Caml-list] Re: ocamldoc and packing

[Michaël Grünewald]

Maxence Guesdon <maxence.guesdon@inria.fr> writes:

> > 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.
> 
> Yes, this is not implemented yet, I was just asking if this usage would fit 
> the needs. I will add this option.

I try to let everyone believe my english is so bad i can not even read the
answers from people ! As you noticed i did not understand it in the right
way. 

Tjanks !
-- 
Michaël Grünewald <michael-grunewald@wanadoo.fr>  - 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