Follow these steps to obtain the latest (i.e. unreleased) source code for the System.Data.SQLite project. To obtain the latest officially released source code instead, refer to the [./downloads.wiki | downloads page]. Unless otherwise noted, all steps need to be performed in the order specified.

Assumptions & Prerequisites

The string "<root>" represents the directory where the local working copy of the source tree (a.k.a. the working check-out directory) for the System.Data.SQLite project is to reside. This should be a completely empty directory.

The string "<repositories>" represents the directory where the local clone of the repository for the System.Data.SQLite project (and potentially other projects) is to reside.

Obtain & Install Fossil Itself

The [http://www.fossil-scm.org | Fossil] open-source [http://en.wikipedia.org/wiki/Distributed_revision_control | distributed version control] system is a computer program that must be installed on your machine before you use it. Fortunately, installing Fossil is very easy. Fossil consists of a single executable file that you simply download and run. For convenience, the Fossil executable file should be placed in a directory present in your [http://en.wikipedia.org/wiki/PATH_%28variable%29 | PATH]. To uninstall Fossil, simply delete the executable file. [http://www.fossil-scm.org/index.html/doc/tip/www/quickstart.wiki | Detailed instructions] for installing and getting started with Fossil are available on the [http://www.fossil-scm.org/ | Fossil website].

Clone Repository (Windows)

  1. Open a Windows command prompt using "cmd.exe".
  2. Change the current directory to "<root>" using a command similar to:

    cd /D <root>
  3. Enter the following command to create a complete clone (i.e. local copy) of the entire source code repository for the System.Data.SQLite project, including the entire check-in history:

    fossil [http://www.fossil-scm.org/index.html/help/clone | clone] http://system.data.sqlite.org/ <repositories>/sds.fossil
  4. Please note that the repository itself uses an [http://www.fossil-scm.org/index.html/doc/trunk/www/fileformat.wiki | enduring file format] stored in a single [http://www.fossil-scm.org/index.html/doc/trunk/www/tech_overview.wiki | SQLite database file] with a particular schema.
  5. In this case, after executing the [http://www.fossil-scm.org/index.html/help/clone | clone] command, the local clone of the repository will be placed into the "sds.fossil" file in the <repositories> directory.

Working Copy (Windows)

  1. Open a Windows command prompt using "cmd.exe".
  2. Change the current directory to "<root>" using a command similar to:

    cd /D <root>
  3. Enter the following command to create a local working copy of all the files that are currently part of the System.Data.SQLite project:

    fossil [http://www.fossil-scm.org/index.html/help/open | open] <repositories>/sds.fossil
  4. The local source tree should now be ready for use as described in the [./build.wiki | build procedures] and/or [./test.wiki | test procedures].
  5. In the future, to update the local working copy with the latest changes from the official System.Data.SQLite repository (i.e. instead of having to re-clone the entire thing), enter the following command from the same directory where the working copy is located:  fossil [http://www.fossil-scm.org/index.html/help/update | update]