Original bug ID: 4356
Reporter: acone
Status: closed (set by @damiendoligez on 2017-02-17T15:07:28Z)
Resolution: suspended
Priority: normal
Severity: text
Version: 3.10.0
Category: -for ocamlbuild use https://github.com/ocaml/ocamlbuild/issues
Related to: #5243

Bug description

The last few sections of the ocamlbuild manual need far more examples. It is clear that the _tags file is very expressive, but I have no idea how to use it.

In particular, the following examples are needed (for me, anyway):

1. Using ocamlbuild to make a toplevel executable (with ocamlmktop, for instance)
2. Using ocamlbuild to link with C code
3. Using ocamlbuild for a project with multiple targets

One can probably infer all these things from the text, but I lack the (time*intelligence) to do so.

Additional information

I would really recommend an "examples" section, with at least 10 complete, downloadable examples. I would write them myself if I understood ocamlbuild better.

Other than that, great job with ocamlbuild!