How to use this repo
You can “use” this repo by clicking around and reading code, wiki pages, etc.
You can also use Fossil to clone your own copy of everything you see here.
- If you don’t already have it, download the Fossil executable and put it on your
$PATH
- Clone this repository:
> fossil clone https://thenotepad.org/repos/rs2019 rs2019.fossil
- You might as well set autosync to 0 (off) or to pullonly. (See below for more info about why):
> fossil settings autosync pullonly
- The
rs2019.fossil
file you just cloned is a Fossil repository. “Open” it to unpack a checkout of the latest version of the source code into your current directory:> fossil open myclone.fossil
- Fiddle with the source code as you see fit. Read Fossil Quick Start.
- You can also open your own local copy of the web UI:
> fossil ui
- To get the latest version of the code:
> fossil pull
Some tips for Git users
- Fossil has
autosync
on by default, which means it will sync with the remote repo immediately before and immediately after every commit. But since you likely won’t have “push” privileges on my repo, it will fail. Setting it topullonly
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. - To create a branch, add
--branch NEW-BRANCH-NAME
when doing a 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! - Instead of “pull requests” you can post patches to the forum. For more complicated changes, Fossil has “bundles”, which are multiple commits that have been exported to a bundle file. The most straightforward approach is to check in your proposed changes on a special branch, then do
fossil bundle export my.bundle --branch mybranch
. If you later make more commits on this branch and want to add them to this bundle, you can dofossil bundle extend my.bundle
. When you’re ready, email the bundle to the repo maintainer.