Using Fossil

Fossil is an open source distributed version control system, designed and developed by the creator of SQLite. A stand-alone Fossil executable has a source control management engine, web interface, issue tracker, wiki, and built-in web server. Fossil is available for Linux, Windows, and macOS.

To use Fossil from Qt Creator, you must install and configure it, as described in the following sections.

Configuring Fossil

1. Download the Fossil SCM client and install the fossil executable file in your PATH.
2. Create or designate a directory to store local Fossil repositories and remote clones. For example: ~/fossils/qt.
3. Select Edit > Preferences > Version Control > Fossil, and set the designated directory in the Default path field.

   

To create a local Fossil repository, select Tools > Fossil > Create Repository.

To clone a remote Fossil repository, select File > New Project > Import Project > Fossil Clone.

Additional Fossil Functions

In addition to the standard version control system functions described in Using Version Control Systems, the Fossil submenu has the following items:

Fossil Preferences

To set Fossil preferences, select Edit > Preferences > Version Control > Fossil:

• Command specifies the path to the command line client executable.
• Default path sets the path to the directory to store local repositories by default.
• Default user specifies an existing user who becomes the author of changes made to the repository.
• SSL/TLS identity sets the SSL/TLS client identity key to use for authentication if the server requests it.
• Log count sets the maximum number of lines the log can have.
• Log width sets the width of log entry lines to 20 or above. The value 0 shows a single line per entry.
• Timeout sets a timeout for version control operations.
• Disable auto sync disables automatic pull before a commit or update and automatic push after a commit or tag or branch creation.