<h1>libfossil: Fossil SCM Library API</h1>

See also: [download], [building], [th1ish], [f-tools],
[DbFunctions], [SQLSnippets], [HackersGuide],
[http://fossil.wanderinghorse.net/repos/libfossil/doxygen/|doxygen docs] (refreshed from current sources relatively frequently)


This source code repository houses an in-development library API for the [http://fossil-scm.org|Fossil SCM]. The primary goal is to port existing behaviour into a library form (the v1 app is extremely monolithic in nature). This effort, officially called "libfossil", intends to introduce no breaking changes, and the intention is to provide an alternative interface into fossil repositories, as opposed to a replacement for the core fossil application.

This code currently doesn't do much which would interest non-Fossil hackers. It might be of interest to those wanting to follow or participate in the design of libfossil.

<strong>License:</strong> same as Fossil: the "2-Clause BSD" a.k.a. "FreeBSD License" with the same license holder (D. Richard Hipp, author of Fossil). To keep this code as "license clean" as possible vis-a-vis Fossil, code contributions require having a Fossil copyright waiver on file. All Fossil committers (those who have a signed a license waiver on file with DRH, whether or not they actually commit code to Fossil) are welcomed as contributors - email me your preferred user name to get access: sgbeal@googlemail.com. Those without a waiver may of course contribute in other ways (ideas, discussions, docs, ...). Getting a waiver is a simple matter of [http://www.fossil-scm.org/index.html/doc/trunk/www/copyright-release.html|filling it out and sending it off to DRH] at the address on the form (please attach a note indicating that the waiver is for libfossil (as opposed to fossil), so that he knows no additional effort is necessary on his part!).
<strong>License:</strong> same as Fossil: the "2-Clause BSD" a.k.a. "FreeBSD License" with the same license holder ([http://en.wikipedia.org/wiki/D._Richard_Hipp|D. Richard Hipp], the primary author and architect of [http://sqlite.org|sqlite] and [http://fossil-scm.org|Fossil]). To keep this code as "license clean" as possible vis-a-vis Fossil, code contributions require having a Fossil copyright waiver on file. All Fossil committers (those who have a signed a license waiver on file with DRH, whether or not they actually commit code to Fossil) are unreservedly welcomed as libfossil contributors - email your preferred user name to get an account: sgbeal@googlemail.com. Getting a waiver is a simple matter of [http://www.fossil-scm.org/index.html/doc/trunk/www/copyright-release.html|filling it out and sending it off to DRH] at the address shown on the form (please attach a note indicating that the waiver is for libfossil (as opposed to fossil), so that he knows no additional effort is necessary on his part!). Those without a waiver may of course contribute in other ways (ideas, discussions, docs, ...).

<h2>Online Demo</h2>

We have an online demonstration of CGI applications implemented using the [th1ish] bindings to libfossil here:

    [http://fossil.wanderinghorse.net/repos/libfossil/cgidemo/index.cgi]