System.Data.SQLite

Follow these steps to obtain the latest (i.e. unreleased) source code for the System.Data.SQLite project. 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 Fossil open-source 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 PATH. To uninstall Fossil, simply delete the executable file. Detailed instructions for installing and getting started with Fossil are available on the 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 clone https://system.data.sqlite.org/ <repositories>/sds.fossil
4. Please note that the repository itself uses an enduring file format stored in a single SQLite database file with a particular schema.
5. In this case, after executing the 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 open <repositories>/sds.fossil
4. The local source tree should now be ready for use as described in the build procedures and/or 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 update