Overview
Artifact ID: | 6975e9e7a6dc0e782f30724a69693e9f3d4c57a2745839b2e8aed5594dd76e2c |
---|---|
Page Name: | How to use Fossil with this repo |
Date: | 2018-11-18 23:46:33 |
Original User: | joel |
Content
You can “use” this repo by clicking around these web pages, reading code, wiki pages, etc.
But you can also use Fossil to check out a version-controlled copy of the code. Below are instructions for getting started quickly. The instructions assume you are familiar with the concepts of version control.
- If you don’t already have it, download the Fossil executable and put it on your
$PATH
- Clone this repository:
> fossil clone -u https://thenotepad.org/repos/bunco bunco.fossil
- You might as well set autosync to 0 (off) or to pullonly. (See below for more info about why):
> fossil settings autosync 0
- “Check out” 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 the web UI for your local copy:
> 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 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.