======Applications - Version Control - Fossil - Notes=======

See also [[applications:versioncontrol#fossil]]

Create new repository:
<code>
fossil init myrepo.fossil
</code>
You'll get output similar to:
<file>
project-id: /Long number/
server-id:  /Another long number/
admin-user: username (initial password is "123456")
</file>

Set up the server:
<code>
fossil server myrepo.fossil
</code>
You'll get output similar to:
<file>
Listening for HTTP requests on TCP port 8080
Type Ctrl-C to stop the HTTP server
</file>

Prepare the client.
  - Clone the server repository:<code>
fossil clone http://username:123456@host.domain.com:8080/ myclone.fossil
</code>
  - Open the cloned repository:<code>
fossil open myclone.fossil
</code>
  - Check in files, they should be immediately synced to the server by autosync.

To disable autosync:
<code>
fossil setting autosync off
</code>
To enable autosync
<code>
fossil setting autosync on
</code>
To check the current autosync setting:
<code>
fossil setting autosync
</code>
To set Notepad to be the default editor for commit messages (for use on Windows):
<code>
fossil setting editor notepad.exe
</code>

====List users====
List users:
<code>
fossil user list -R file.fossil
</code>
List rights of user:
<code>
fossil user capabilities anonymous -R file.fossil
</code>

====Registered users only====
Remove rights for anonymous and nobody:
<code>
fossil user capabilities anonymous "" -R file.fossil
fossil user capabilities nobody "" -R fea.fossil
</code>

====Add new user====
<code>
fossil user new username contact-info password
</code>

====Grant all rights except create users and super-user====
<code>
fossil user capabilities username bcfhgjmnoruvxz -R file.fossil
</code>

====Set password====
<code>
fossil user password username newpassword -R file.fossil
</code>


=====Bazaar-to-Fossil.cmd=====
Extracts all revisions from a bazaar repository and commits each revision to a fossil repository. \\
Be warned: This script has received only very minimal testing so far. \\

Both bazaar and fossil executables should be in the %PATH%.

As this was for a bazaar repository with .cmd and .vbs files, the following option had to be set to prevent the fossil prompts about CR/LF at commit time:
<code>
fossil setting crnl-glob '*'
</code>

<code>
SET BZRREPODIR=I:\Scripts
SET BZRTMPDIR=C:\Dump\ScriptsTMP
SET FOSSILREPODIR=C:\Dump\Scripts2
SET TMPDIR=C:\Dump
SET STARTREV=1
IF "%1" NEQ "" SET STARTREV=%1
IF NOT EXIST "%TMPDIR%" MKDIR "%TMPDIR%"
CD /D "%BZRREPODIR%"
FOR /F "tokens=*" %%S IN ('bzr revno') DO ( 

	FOR /L %%D IN (%STARTREV%,1,%%S) DO (

		IF EXIST "%BZRTMPDIR%" RD /S /Q %BZRTMPDIR%
		MKDIR "%BZRTMPDIR%"
		CD /D "%BZRREPODIR%"
		bzr log -r%%D > "%TMPDIR%\r%%D.txt"
		bzr export -r %%D --per-file-timestamps "%BZRTMPDIR%"
		"%SYSTEMROOT%\system32\xcopy.exe" /EY "%BZRTMPDIR%" "%FOSSILREPODIR%"
		CD /D "%TMPDIR%"
		CD /D "%FOSSILREPODIR%"
		fossil add *
		fossil commit --message-file "%TMPDIR%\r%%D.txt"

	)

)
IF EXIST "%BZRTMPDIR%" RD /S /Q %BZRTMPDIR%
DEL /Q "%TMPDIR%\r*.txt"
</code>

=====Compile Fossil on Windows with SSL support=====
See [[applications:fossil:compileonwindowswithssl]].