README

Eliom

------------------------------------------------------------------

Requirements:
=============

Compilers:

 * ocaml and camlp4  (need version >= 3.12.1)
 * js_of_ocaml       (need version >= 2.1, with deriving support)
 * a C compiler      (tested with gcc-4.4.5)

Libraries:

 * findlib
 * ocsigenserver     (need version >= 2.4)
 * tyxml             (need version >= 3)
 * react             (tested with 0.9.3)
 * deriving          (need version >= 0.5)
                     See: https://github.com/ocsigen/deriving
 * ocamlssl          (tested with 0.4.6)
 * calendar          (tested with 2.03.1)
 * optcomp
 * ipaddr            (need version >= 2.1)


If OCaml 3.12 and the needed libraries (findlib/react/lwt...) are not
installed on your computer and not available on your favorite linux
distribution, you may use the Ocsigen bunble GODI to install them
automatically, see:

  http://ocsigen.org/install#bundle
  http://godi.camlcity.org/godi/index.html

To run the native code version of ocsigen server, you may need to
generate cmxs files for the libraries you need, if they are not
included in your distribution, see:

  http://ocsigen.org/ocsigenserver/manual/misc

------------------------------------------------------------------

Build instructions:
===================

 * run "sh configure [options]" to generate 'Makefile.config'
 - For the full list of options, run "sh configure --help".

 * verify that 'Makefile.config' suits to your needs.

 * run "make" to compile
 * run "make install" as root to install

 * [optional] run "make doc" to build the ocamldoc
 * [optional] run "make install.doc" as root to install the ocamldoc

 * run "make uninstall" to uninstall (almost) everything

------------------------------------------------------------------

Local testings:
===============

 * run "make run.local" of "make run.opt.local"
   in the ocsigen source directory.

 * open http://localhost:8080/miniwiki in your browser

 * if it does not work, look at the logs (see 'local/var/log/' in the
   ocsgigen source directory) or run ocsigen with options -v or -V
   (verbose and debug mode).

 * sources for this example may be found in the directory
   'examples/miniwiki'. For a full tutorial, see:

      http://ocsigen.org/tutorial

    For testsuite, see:

      http://localhost:8080/

------------------------------------------------------------------

Authors:
========

Vincent Balat
 (project leader, Web server, Ocsigenmod, Eliom, Eliom client, Staticmod, XHTML syntax extension, documentation, Ocsimore, extension mechanism, Ocsidbm, Ocsipersist with DBM, ...)
Jérôme Vouillon
(Lwt, Web server, js_of_ocaml, O'Closure, ...)
Boris Yakobowski
(Ocsimore, module Extendconfiguration, Ocsigen server...)
Benjamin Canou
(O'Browser)
Jérémie Dimino
(Lwt)
Raphaël Proust
(Ocsforge, Eliom client, Comet)
Stéphane Glondu
(Configuration file, Findlib integration, access control, HTTP authentication, Debian package, ...)
Gabriel Kerneis
(XHTML syntax extension for OCaml 3.10, Ocsipersist with SQLite, CGI module, forms in Eliom, deflatemod, ...)
Denis Berthod
(HTTP protocol, Web server)
Grégoire Henry
(safe unmarshalling of client data)
Pierre Chambart
(Comet)
Jaap Boender
(Ocsimore, NetBSD and Godi packages)
Gabriel Scherer
(Macaque)
Gabriel Cardoso
(O'Closure)
Jean-Henri Granarolo
(Ocsforge)
Simon Castellan
(HTML5, OpenID, SVG)
Piero Furiesi
(Ocsimore)
Thorsten Ohl
(most of the functions generating XHTML (xML and xHTML modules))
Mauricio Fernandez
(Xhtmlcompact, static linking of extensions and Eliom modules)
Nataliya Guts
(Web server, HTTPS)
Archibald Pontier
(Atom, Pubsubhubbub)
Jérôme Velleine
(CGI module)
Charles Oran
(O'Closure)
Pierre Clairambault
(Lwt_lib, Gentoo package, configure script, ...)
Cécile Herbelin
 (HTML5, Benchmarks)