ocamlbuild documentation

ocamlbuild documentation

[Sam Steingold]

Hi,

What documentation for ocamlbuild is available in in addition to
http://brion.inria.fr/gallium/index.php/Ocamlbuild &
http://nicolaspouillard.fr/ocamlbuild/ocamlbuild-user-guide.html?

Thanks
Sam

Re: [Caml-list] ocamlbuild documentation

[Romain Bardou]

Sam Steingold a écrit :
> Hi,
> 
> What documentation for ocamlbuild is available in in addition to
> http://brion.inria.fr/gallium/index.php/Ocamlbuild &
> http://nicolaspouillard.fr/ocamlbuild/ocamlbuild-user-guide.html?

Hello,

As far as I know there is none.

-- 
Romain Bardou

Re: [Caml-list] ocamlbuild documentation

[Erick Matsen]

Hi--


This is such a common theme on this list, I wonder if it would be
worth setting up a repository of well-commented Ocamlbuild examples.
That would go a long way towards helping beginners (like myself) out.

Would people be interested in contributing such examples? Any ideas
about where to host them?


Thanks,

Erick

On Wed, Oct 21, 2009 at 1:47 AM, Romain Bardou <Romain.Bardou@lri.fr> wrote:
> Sam Steingold a écrit :
>> Hi,
>>
>> What documentation for ocamlbuild is available in in addition to
>> http://brion.inria.fr/gallium/index.php/Ocamlbuild &
>> http://nicolaspouillard.fr/ocamlbuild/ocamlbuild-user-guide.html?
>
> Hello,
>
> As far as I know there is none.
>
> --
> Romain Bardou
>
> _______________________________________________
> Caml-list mailing list. Subscription management:
> http://yquem.inria.fr/cgi-bin/mailman/listinfo/caml-list
> Archives: http://caml.inria.fr
> Beginner's list: http://groups.yahoo.com/group/ocaml_beginners
> Bug reports: http://caml.inria.fr/bin/caml-bugs
>

Re: [Caml-list] ocamlbuild documentation

[Ashish Agarwal]

[-- Attachment #1: Type: text/plain, Size: 1781 bytes --]

> Any ideas about where to host them?

Why not at the first link given? It is a wiki.
http://brion.inria.fr/gallium/index.php/Ocamlbuild

Personally I think what's most needed is a description of the concepts,
although examples of course would help too.


On Wed, Oct 21, 2009 at 9:36 AM, Erick Matsen <ematsen@gmail.com> wrote:

> Hi--
>
>
> This is such a common theme on this list, I wonder if it would be
> worth setting up a repository of well-commented Ocamlbuild examples.
> That would go a long way towards helping beginners (like myself) out.
>
> Would people be interested in contributing such examples? Any ideas
> about where to host them?
>
>
> Thanks,
>
> Erick
>
> On Wed, Oct 21, 2009 at 1:47 AM, Romain Bardou <Romain.Bardou@lri.fr>
> wrote:
> > Sam Steingold a écrit :
> >> Hi,
> >>
> >> What documentation for ocamlbuild is available in in addition to
> >> http://brion.inria.fr/gallium/index.php/Ocamlbuild &
> >> http://nicolaspouillard.fr/ocamlbuild/ocamlbuild-user-guide.html?
> >
> > Hello,
> >
> > As far as I know there is none.
> >
> > --
> > Romain Bardou
> >
> > _______________________________________________
> > Caml-list mailing list. Subscription management:
> > http://yquem.inria.fr/cgi-bin/mailman/listinfo/caml-list
> > Archives: http://caml.inria.fr
> > Beginner's list: http://groups.yahoo.com/group/ocaml_beginners
> > Bug reports: http://caml.inria.fr/bin/caml-bugs
> >
>
> _______________________________________________
> Caml-list mailing list. Subscription management:
> http://yquem.inria.fr/cgi-bin/mailman/listinfo/caml-list
> Archives: http://caml.inria.fr
> Beginner's list: http://groups.yahoo.com/group/ocaml_beginners
> Bug reports: http://caml.inria.fr/bin/caml-bugs
>

[-- Attachment #2: Type: text/html, Size: 3175 bytes --]

Re: [Caml-list] ocamlbuild documentation

[Rakotomandimby Mihamina]

10/21/2009 04:36 PM, Erick Matsen:
> This is such a common theme on this list, I wonder if it would be
> worth setting up a repository of well-commented Ocamlbuild examples.
> That would go a long way towards helping beginners (like myself) out.

somthing a bit like that: http://pleac.sourceforge.net/pleac_ocaml/ ?

> Would people be interested in contributing such examples? Any ideas
> about where to host them?

ocamlforge?
sourceforge? google code? freshmeat?

-- 
       Architecte Informatique chez Blueline/Gulfsat:
    Administration Systeme, Recherche & Developpement
                                    +261 33 11 207 36

Re: [Caml-list] ocamlbuild documentation

[Gabriel Kerneis]

On Wed, Oct 21, 2009 at 06:36:52AM -0700, Erick Matsen wrote:
> This is such a common theme on this list, I wonder if it would be
> worth setting up a repository of well-commented Ocamlbuild examples.
> That would go a long way towards helping beginners (like myself) out.

Since ocamlbuild is (unofficially) unmaintained, I wonder if this is
such a good idea.  You might prefer to swich to a more perennial system
(like make).

Regards,
-- 
Gabriel, only half-kidding

Re: ocamlbuild documentation

[Sylvain Le Gall]

On 21-10-2009, Erick Matsen <ematsen@gmail.com> wrote:
> Hi--
>
>
> This is such a common theme on this list, I wonder if it would be
> worth setting up a repository of well-commented Ocamlbuild examples.
> That would go a long way towards helping beginners (like myself) out.
>
> Would people be interested in contributing such examples? Any ideas
> about where to host them?
>

OCaml Forge is probably the best place to host this kind of project:
http://forge.ocamlcore.org

Probably a lot of potential contributors are already subscribed and you
will get a good visibility among other OCaml projects.

Regards
Sylvain Le Gall

>
> Thanks,
>
> Erick
>
> On Wed, Oct 21, 2009 at 1:47 AM, Romain Bardou <Romain.Bardou@lri.fr> wrote:
>> Sam Steingold a écrit :
>>> Hi,
>>>
>>> What documentation for ocamlbuild is available in in addition to
>>> http://brion.inria.fr/gallium/index.php/Ocamlbuild &
>>> http://nicolaspouillard.fr/ocamlbuild/ocamlbuild-user-guide.html?
>>
>> Hello,
>>
>> As far as I know there is none.
>>
>> --
>> Romain Bardou
>>
>> _______________________________________________
>> Caml-list mailing list. Subscription management:
>> http://yquem.inria.fr/cgi-bin/mailman/listinfo/caml-list
>> Archives: http://caml.inria.fr
>> Beginner's list: http://groups.yahoo.com/group/ocaml_beginners
>> Bug reports: http://caml.inria.fr/bin/caml-bugs
>>
>

Regards,
Sylvain Le Gall

Re: [Caml-list] ocamlbuild documentation

[Rakotomandimby Mihamina]

10/21/2009 05:02 PM, Gabriel Kerneis:
>> worth setting up a repository of well-commented Ocamlbuild examples.
> You might prefer to swich to a more perennial system

Not wrong...

-- 
       Architecte Informatique chez Blueline/Gulfsat:
    Administration Systeme, Recherche & Developpement
                                    +261 33 11 207 36

Re: ocamlbuild documentation

[Jan Kybic]

>> Instead, I found that ocamlbuild replaces my current build option of choice:
>>   ocamlopt foo.ml -I +lablGL lablgl.cmxa lablglut.cmxa foo.ml -o foo
>> with lots of incidental complexity:

I agree with the previous posters that ocamlbuild is a great project
but the documentation is not yet sufficient for a beginner. Let me
recall my recent experience:

Yesterday, out of curiosity, I have tried to use Ocaml for my current
project. It is not complicated, just a few Ocaml source files with a
few libraries. In Ocamlmake, I only had to list the SOURCES and set

PACKS = lacaml unix extlib str gsl

In ocamlbuild, I spent a long time finding out how to tell Ocaml to
use the required libraries.  I took the ocamlfind plugin from
the Ocamlbuild wiki
(http://brion.inria.fr/gallium/index.php/Using_ocamlfind_with_ocamlbuild)
and created the following _tags file:

<*.ml> or <*.mli>: pkg_extlib, pkg_gsl, pkg_str, pkg_unix
<dList.ml>: ocaml, pp(ocaml+twt), debug
<utils.ml>: ocaml, pp(camlp4o), debug

Now, all files compiled correctly. However, the linking failed with
message "No implementations provided for the following modules". I could
eliminate some of the messages by invoking ocamlbuild as

  ocamlbuild -libs str,unix,bigarray,gsl matvflss.native

but this did not help with gsl and extlib libraries.  Finally, after
many frustrating attempts I could link everything using:

ocamlbuild -lflags -I,/usr/lib/ocaml/site-packages/gsl -lflags -I,/usr/lib/ocaml/site-packages/extlib -libs str,unix,bigarray,gsl,extLib   matvflss.native

So finally yes, ocamlbuild works. But for a beginner, it is currently more
complicated to use than Ocamlmake. Instead of a few lines in a
Makefile, you need to write myocamlbuild.ml, _tags, and a script
automating the command line.  I found the command line more or less by
trial and error and by looking at the examples. It is admittedly my
fault since there is one relevant sentence in the manual ("You may
need to add options such as...") but it is easy to miss.

Why do I have to manually set all the paths and library names
if I have already said "pkg_..." in _tags? Why does not ocamlbuild
uses ocamlfind to find out automatically? I thought the plugin was
supposed to do exactly this.

By the way, how am I supposed to use the caml-types-show-type feature
in Emacs Tuareg mode, if ocamlbuild forces all the annot files into
the _build subdirectory?


I am sure Ocamlbuild will mature with time and become a very useful
tool. Keep up the good work.

Jan


-- 
-------------------------------------------------------------------------
Jan Kybic <kybic@fel.cvut.cz>                       tel. +420 2 2435 5721
http://cmp.felk.cvut.cz/~kybic                      ICQ 200569450