ocaml for Debian
----------------

  Package splitting :

  o ocaml-base : contains the rutime stuff (ocamlrun + dlls)
  o ocaml : contains the full ocaml suite
  o ocaml-native-compilers : contains the native built part of the ocaml suite
    (ocamlc.opt, ocamlopt.opt, ocamllex.opt, camlp4o.opt and camlp4r.opt)
  o ocaml-source : contains the full ocaml source for the (few) package which
    need them at build time or for personal use.


  The caml include files are found under /usr/include/ocaml as should be.
    For compatibility reasons, symlink are provided for either
    /usr/include/caml and /usr/lib/ocaml/caml.

  Shared stub libraries are handled automatically by postinst/prerm scripts.
  To achieve that, some modifications were needed :

  o /usr/lib/ocaml/ld.conf : lines starting with # are comments and thus are
    ignored.

  o The /usr/lib/ocaml/ld.conf file is not supposed to be edited by hand
    anymore, it gets generated by a new tool called ocaml-ldconf (see its man
    page (1) for more detail) from the system administrator database
    (/etc/ocaml/ld.conf) and a postinst/prerm handled database
    (/var/lib/ocaml/ld.conf).

  o The syntax of /etc/ocaml/ld.conf is :

      dir command

    where command can either be add, addafter or remove.
    The add command adds a new directory before the dpkg handled ones.
    The addfter command adds a new directory after the dpkg handled ones.
    The remove command removes a directory from the dpkg handled ones.

  o After updating the /etc/ocaml/ld.conf file, the system administrator
    should run ocaml-ldconf to regenerate the /usr/lib/ocaml/ld.conf file.

  o ocaml-ldconf can also be called with the -l argument to show the list of
    currently active shared stub library paths (well those defined in
    /usr/lib/ocaml/ld.conf only for now, not the ones defined by other means).

 -- Sven Luther <luther@lambda.u-strasbg.fr>, Wed, 16 Jan 2002 18:38:38 +0100
