How to use this repo

You can “use” this repo by clicking around and reading code, wiki pages, etc.

But you can also use it to work with your own copy of the code. I suspect this won’t be interesting or useful for 99% of the people reading this. But in the event that you’ve become a patron and want to try using Fossil to work with the code, here’s a quick guide on how to get started.

1. If you don’t already have it download the Fossil executable and put it on your $PATH
2. Clone this repository:

   > fossil clone https://username:password@thelocalyarn.com/cgi-bin/code myclone.fossil

3. You might as well set autosync to 0 (off) or to pullonly. (See below for more info about why):

   > fossil settings autosync 0

4. “Check out” the latest version of the source code into your current directory:

   > fossil open myclone.fossil

5. Fiddle with the source code as you see fit. Read Fossil Quick Start.
6. You can also open your own local copy of the web UI:

   > fossil ui

7. To get the latest version of the code:

   > fossil pull

Some tips for Git users

• If you’re wondering why I’m using Fossil instead of Git, read Why Fossil?
• Fossil has autosync on by default, which means it will sync with the remote repo on every commit. But since you likely won’t have “push” privileges on my repo, it will fail. Turning autosync off will prevent you from having to see it try and fail every time you make a commit.
• There is no “staging” step in Fossil. Doing fossil commit immediately commits all changes in all tracked files into the repository. If you need to, you can specify which file or files you want to be included in the commit.
• There is no selective “patch committing” in Fossil (i.e., git add -p in Git), reportedly because it facilitates check-ins of untested code. So, if you’re in the habit of making unrelated edits to code…stop it!
• There is currently no “pull request” functionality in Fossil; users either have commit privileges or they don’t. This is fine for me since I am not interested in pull requests. If you would like to propose a change you can email me a patch.