Installation

Installing the binary:

• Download the binary for your OS from the Fossil site.

• Save it somewhere in your $PATH. E.g., C:\Windows on Windows; on Mac OS X or *nix you can mkdir ~/bin, add it to $PATH in your shell startup script, and save it there.

You can do both of these in one step on Ubuntu 32-bit by just running

wget http://www.fossil-scm.org/download/fossil-linux-x86-20140127173344.zip
unzip fossil-linux-x86-20140127173344.zip
sudo cp fossil /usr/local/bin/fossil

• Run fossil version from a terminal/command-line prompt. If all went well, Fossil should print the current version (1.28).

Installing from source:

(Building from source is recommended if your running a 64-bit Linux.)

• Make sure you have the OpenSSL development libraries installed (sudo apt-get install libssl-dev).

• Download the source tarball

• Extract the source (tar -zxvf fossil-src-20140127173344.tar.gz) and cd into the resulting directory.

• Run ./configure; make

• cp fossil into a directory in your $PATH (e.g., sudo cp fossil /usr/local/bin).

• As above, see if fossil version works.

Cloning this repository

• Create/choose two directories, one to hold the repository database, and one to hold the source tree. These should be disjoint (i.e., don't store the repository in a subdirectory of the source tree). I'll call these paths $FOSSILS and $SRC_TREE.

• Run fossil clone http://username@fossil.twicetwo.com/csci256.pl $FOSSILS/csci256.fossil, where username is your username. You will be prompted for your password.

• Change to the $SRC_TREE directory.

• Run fossil open $FOSSILS/csci256.fossil

• Your source tree directory now contains a working copy of all the source code in the repository.

(Note that in Fossil a repository is a single file, and isn't connected to a particular source tree, as opposed to Git, where a repository is a subdirectory of the source tree, and thus source trees and repositories are one-to-one. In Fossil, you can have multiple source trees pointing to the same repository, perhaps with different trees in different states, checkouts, etc.)