e65e669148 2008-05-24 drh: <h1>Fossil: Distributed Revision Control, Wiki, and Bug-Tracking</h1> 11976cfdc2 2007-09-02 drh: d87ca60c58 2008-05-15 stephan: <p> c8893c69ac 2008-10-05 drh: Fossil is a 22005927ad 2008-05-16 drh: <a href="http://en.wikipedia.org/wiki/Revision_control"> 22005927ad 2008-05-16 drh: distributed software revision control system</a> that includes an integrated 9d10726d48 2008-07-29 drh: <a href="wikitheory.wiki">wiki</a> and an integrated 6ecc392f1c 2008-07-20 drh: <a href="bugtheory.wiki">bug-tracking system</a> all in a single, 6ecc392f1c 2008-07-20 drh: easy-to-use, stand-alone executable. 22005927ad 2008-05-16 drh: Fossil is ec53d7a738 2008-11-09 drh: <a href="http://www.fossil-scm.org/">self-hosting</a> 06689854ae 2008-05-17 drh: since 2007-07-21 on ec53d7a738 2008-11-09 drh: <a href="http://www.hwaci.com/cgi-bin/fossil">two separate servers</a>. 9eb6ea75c1 2008-11-11 kejoki: You can download the <a href="../../../timeline">latest sources</a> and 6ecc392f1c 2008-07-20 drh: <a href="build.wiki">compile it yourself</a>. d87ca60c58 2008-05-15 stephan: Or you can grab 9eb6ea75c1 2008-11-11 kejoki: <a href="http://www.fossil-scm.org/download.html">pre-compiled binaries</a>. d87ca60c58 2008-05-15 stephan: </p> 11976cfdc2 2007-09-02 drh: c8893c69ac 2008-10-05 drh: <p>Feature Summary:</p> 11976cfdc2 2007-09-02 drh: 11976cfdc2 2007-09-02 drh: <ul> c8893c69ac 2008-10-05 drh: <li>Flexible workflow:<ul> c8893c69ac 2008-10-05 drh: <li>Disconnected, distributed development like c8893c69ac 2008-10-05 drh: <a href="http://kerneltrap.org/node/4982">git</a>, c8893c69ac 2008-10-05 drh: <a href="http://www.monotone.ca/">monotone</a>, c8893c69ac 2008-10-05 drh: <a href="http://www.selenic.com/mercurial/wiki/index.cgi">mercurial</a>, c8893c69ac 2008-10-05 drh: and <a href="http://www.bitkeeper.com/">bitkeeper</a> c8893c69ac 2008-10-05 drh: <li>Or, client/server operation like c8893c69ac 2008-10-05 drh: <a href="http://www.nongnu.org/cvs/">CVS</a> and c8893c69ac 2008-10-05 drh: <a href="http://subversion.tigris.org/">subversion</a>, c8893c69ac 2008-10-05 drh: <li>Or, operations on local repositories, c8893c69ac 2008-10-05 drh: <li>Or, all of the above at the same time</ul></li> c8893c69ac 2008-10-05 drh: <li>Integrated, distributed <a href="bugtheory.wiki">bug tracking</a> and c8893c69ac 2008-10-05 drh: <a href="wikitheory.wiki">wiki</a>.</li> 11976cfdc2 2007-09-02 drh: <li>Built-in web interface that supports deep archaeological digs through adc0b3bfb0 2008-07-15 drh: the project history.</li> 11976cfdc2 2007-09-02 drh: <li>All network communication via 6ecc392f1c 2008-07-20 drh: <a href="http://en.wikipedia.org/wiki/HTTP">HTTP</a> with 6ecc392f1c 2008-07-20 drh: <a href="quickstart.wiki#proxy">proxy support</a> 6ecc392f1c 2008-07-20 drh: so that everything works from behind restrictive firewalls.</li> adc0b3bfb0 2008-07-15 drh: <li>Everything (client, server, and utilities) is included in a adc0b3bfb0 2008-07-15 drh: single self-contained executable - trivial to install</li> c8893c69ac 2008-10-05 drh: <li>Server runs as <a href="quickstart.wiki#cgiserver">CGI</a>, using c8893c69ac 2008-10-05 drh: <a href="quickstart.wiki#inetdserver">inetd/xinetd</a> c8893c69ac 2008-10-05 drh: or using its own 9eb6ea75c1 2008-11-11 kejoki: <a href="quickstart.wiki#serversetup">built-in, stand alone web server</a>.</li> c8893c69ac 2008-10-05 drh: <li>An entire project contained in single disk file c8893c69ac 2008-10-05 drh: (an <a href="http://www.sqlite.org/">SQLite</a> database.)</li> c8893c69ac 2008-10-05 drh: <li>Uses an <a href="fileformat.wiki">enduring file format</a> that is c8893c69ac 2008-10-05 drh: designed to be readable, searchable, and extensible by people not yet born.</li> d87ca60c58 2008-05-15 stephan: <li>Automatic <a href="selfcheck.wiki">self-check</a> 11976cfdc2 2007-09-02 drh: on repository changes makes it exceedingly 11976cfdc2 2007-09-02 drh: unlikely that data will ever be lost because of a software bug.</li> c8893c69ac 2008-10-05 drh: <li>Ridiculously easy to d87ca60c58 2008-05-15 stephan: <a href="build.wiki">install</a> and d87ca60c58 2008-05-15 stephan: <a href="quickstart.wiki">operate</a>.</li> d87ca60c58 2008-05-15 stephan: </ul> d87ca60c58 2008-05-15 stephan: 06689854ae 2008-05-17 drh: <p>User Links:</p> d87ca60c58 2008-05-15 stephan: d87ca60c58 2008-05-15 stephan: <ul> d87ca60c58 2008-05-15 stephan: <li>The <a href="concepts.wiki">concepts</b> behind fossil</li> d87ca60c58 2008-05-15 stephan: <li><a href="build.wiki">Building And Installing</a></li> d87ca60c58 2008-05-15 stephan: <li><a href="quickstart.wiki">Quick Start</a> guide to using fossil 1db8656f68 2008-05-29 drh: <li>Fossil supports <a href="embeddeddoc.wiki">embedded documentation</a> 4b826eed14 2008-05-19 drh: that is versioned along with project source code.</li> d87ca60c58 2008-05-15 stephan: <li>The <a href="selfcheck.wiki">automatic self-check</a> mechanism d87ca60c58 2008-05-15 stephan: helps insure project integrity.</li> 9d10726d48 2008-07-29 drh: <li>Fossil contains a <a href="wikitheory.wiki">built-in wiki</a>.</li> 06689854ae 2008-05-17 drh: <li>There is a 06689854ae 2008-05-17 drh: <a href="http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users"> 06689854ae 2008-05-17 drh: mailing list</a> available for discussing fossil issues.</li> cbc8983685 2008-10-06 drh: <li><a href="qandc.wiki">Questions & Criticisms</a> directed at fossil.</li> 9436bb75c3 2008-11-15 kejoki: <li>Some (unfinished but expanding) extended 9436bb75c3 2008-11-15 kejoki: <a href="reference.wiki">reference documentation</a> for the fossil command line. 11976cfdc2 2007-09-02 drh: </ul> 11976cfdc2 2007-09-02 drh: 06689854ae 2008-05-17 drh: <p>Developer Links: </p> 11976cfdc2 2007-09-02 drh: 11976cfdc2 2007-09-02 drh: <ul> 06689854ae 2008-05-17 drh: <li><a href="pop.wiki">Principles Of Operation</a></li> d87ca60c58 2008-05-15 stephan: <li>The <a href="fileformat.wiki">file format</a> used by every content d87ca60c58 2008-05-15 stephan: file stored in the repository.</li> d87ca60c58 2008-05-15 stephan: <li>The <a href="delta_format.wiki">format of deltas</a> used to d87ca60c58 2008-05-15 stephan: efficiently store changes between file revisions.</li> bfab49ede1 2008-05-15 stephan: <li>The <a href="delta_encoder_algorithm.wiki">encoder algorithm</a> used to d87ca60c58 2008-05-15 stephan: efficiently generate deltas.</li> d87ca60c58 2008-05-15 stephan: <li>The <a href="sync.wiki">synchronization protocol</a>.</li> 11976cfdc2 2007-09-02 drh: </ul> 11976cfdc2 2007-09-02 drh: d87ca60c58 2008-05-15 stephan: <p>Competing Projects:</p> 11976cfdc2 2007-09-02 drh: 11976cfdc2 2007-09-02 drh: <ul> d87ca60c58 2008-05-15 stephan: <li><a href="http://www.ditrack.org/">DITrace</a> d87ca60c58 2008-05-15 stephan: - A Distributed Issue Tracker</li> d87ca60c58 2008-05-15 stephan: <li><a href="http://www.distract.wellquite.org/">DisTract</a> d87ca60c58 2008-05-15 stephan: - Another distributed issue tracker based on d87ca60c58 2008-05-15 stephan: <a href="http://www.monotone.ca/">monotone</a>.</li> d87ca60c58 2008-05-15 stephan: <li><a href="http://www.monotone.ca/">Monotone</a> - distributed d87ca60c58 2008-05-15 stephan: SCM in a single-file executable with a single-file SQLite d87ca60c58 2008-05-15 stephan: database repository.</li> 11976cfdc2 2007-09-02 drh: </ul>