Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Branch: master
Fetching contributors…

Cannot retrieve contributors at this time

61 lines (42 sloc) 1.855 kB
*** Welcome to Batteries Included ***
OCaml Batteries Included: a community-maintained foundation library
for your OCaml projecs.
Batteries Included serves the following purposes:
* define a standard set of libraries which may be
expected on every compliant installation of OCaml
* organize these libraries into a hierarchy of modules,
with one source of documentation
* provide a consistent API for otherwise independent
*** Building Batteries Included ***
**** Requirements ****
You will need
* OCaml >= 3.11
* OMake (
* Findlib >= 1.2.5 (
* Camomile >= 0.7 (
* OUnit to build and run the tests
**** Configuration and installation ****
To install the full version of OCaml Batteries Included in the default
directory (/usr/local/), execute
$ omake all
$ omake test [ optional ]
$ sudo omake install
$ omake doc [ optional ]
$ sudo omake install-doc [ optional ]
*** Using Batteries ***
To get started using Batteries at the toplevel, copy the ocamlinit
file to ~/.ocamlinit:
$ cp ocamlinit ~/.ocamlinit
If you already have findlib in your ~/.ocamlinit, you only need the
last line in our ocamlinit to load batteries.
*** ExtLib Compatibility ***
If your project currently uses ExtLib, most likely you can just change
[-package extlib] to [-package batteries] and add [open Extlibcompat]
to the top of any extlib-using modules. Batteries' modules are all
named BatFoo to differentiate them from extlib's modules, so one can
use Batteries and ExtLib in the same project.
COMPATIBILITY NOTE: If you're using ExtLib's Unzip module, it does not
have a corresponding module in batteries at the moment.
*** Extending Batteries Included ***
See doc/batteries/GUIDELINES
Jump to Line
Something went wrong with that request. Please try again.