<h1>The f-tools</h1>

The source tree contains a few test/demo apps which are named <tt>f-something</tt> (the "f" is for "fossil", of course). Collectively, these apps demonstrate the functionality which is currently ported in from fossil(1) (or is new) and working. If a fossil(1) feature is not represented here, it's probably not yet ported.

In alphabetical order:

   *  <tt>[/finfo?name=f-apps/f-acat.c|f-acat]</tt> ("artifact cat") can output arbitrary artifacts from a repository.
   *  <tt>[/finfo?name=f-apps/f-add.c|f-add]</tt> queues file for addition in the next commit.
   *  <tt>[/finfo?name=f-apps/f-adiff.c|f-adiff]</tt> ("artifact diff") can output diffs of any two arbitrary blobs from a repository. It does not do checkin-level diffs. Supports various diff generation options.
   *  <tt>[/finfo?name=f-apps/f-checkin.c|f-checkin]</tt> checks in file changes to a repository. It basically works but the lack of network supports means fossil(1) is still needed for synching. There is one known lingering (cosmetic) bug in the calculation of leaves after the commit, but it's a (still hidden) program logic but as opposed to a metadata-level bug, meaning that it doesn't really break anything.
   *  <tt>[/finfo?name=f-apps/f-checkin.c|f-checkin]</tt> checks in file changes to a repository. It basically works but the lack of network supports means fossil(1) is still needed for synching. There is one known lingering (cosmetic) bug in the calculation of leaves after the commit, but it's a (still hidden) program logic bug, as opposed to a metadata-level bug, meaning that it doesn't really break anything.
   *  <tt>[/finfo?name=f-apps/f-config.c|f-config]</tt> lists and modifies the contents of the various configuration tables (global, repo, and local checkout).
   *  <tt>[/finfo?name=f-apps/f-ls.c|f-ls]</tt> lists files from a repository.
   *  <tt>[/finfo?name=f-apps/f-mfparse.c|f-mfparse]</tt> reads in Fossil control artifacts, converts them to its internal high-level form, and saves them back out to a file. This is used for testing both the manifest parsing and generation code, to test round-trip fidelity and compatibility with fossil(1) manifests.
   *  <tt>[/finfo?name=f-apps/f-new.c|f-new]</tt> creates new/empty repository databases.
   *  <tt>[/finfo?name=f-apps/f-query.c|f-query]</tt> runs SQL commands against a repo/checkout db. SQL run this way has access to the [DbFunctions|fossil-specific SQL functions]. Be careful!
   *  <tt>[/finfo?name=f-apps/f-resolve.c|f-resolve]</tt> resolves symbolic checkin names (like "trunk", "current", and "prev") and partial UUIDs to their full UUIDs and RIDs.
   *  <tt>[/finfo?name=f-apps/f-rm.c|f-rm]</tt> queues files for removal at the next commit or cancels uncommitted "add" commands.