BCC = gcc
#### The suffix to add to final executable file. When cross-compiling
# to windows, make this ".exe". Otherwise leave it blank.
#
E =
#### C Compile and options for use in building executables that
# will run on the target platform. This is usually the same
# as BCC, unless you are cross-compiling. This C compiler builds
# the finished binary for fossil. The BCC compiler above is used
# for building intermediate code-generator tools.
#
#TCC = gcc -O6
#TCC = gcc -g -O0 -Wall -fprofile-arcs -ftest-coverage
TCC = gcc -g -Os -Wall
# To add support for HTTPS
TCC += -DFOSSIL_ENABLE_SSL
#### Extra arguments for linking the finished binary. Fossil needs
# to link against the Z-Lib compression library. There are no# other dependencies. We sometimes add the -static option here# so that we can build a static executable that will run in a# chroot jail.#LIB = -lz $(LDFLAGS)
# If using HTTPS:
LIB += -lcrypto -lssl
#### Tcl shell for use in running the fossil testsuite. If you do not
# care about testing the end result, this can be blank.
#

BCC = gcc
#### The suffix to add to final executable file. When cross-compiling
# to windows, make this ".exe". Otherwise leave it blank.
#
E =
#### C Compile and options for use in building executables that
# will run on the target platform. This is usually the same
# as BCC, unless you are cross-compiling. This C compiler builds
# the finished binary for fossil. The BCC compiler above is used
# for building intermediate code-generator tools.
#
#TCC = gcc -O6
#TCC = gcc -g -O0 -Wall -fprofile-arcs -ftest-coverage
TCC = gcc -g -Os -Wall
# To use the included miniz library# FOSSIL_ENABLE_MINIZ = 1# TCC += -DFOSSIL_ENABLE_MINIZ
# To add support for HTTPS
TCC += -DFOSSIL_ENABLE_SSL
#### We sometimes add the -static option here so that we can build a# static executable that will run in a chroot jail.#LIB = -staticTCC += -DFOSSIL_DYNAMIC_BUILD=1
#### Extra arguments for linking the finished binary. Fossil needs
# to link against the Z-Lib compression library unless the miniz# library in the source tree is being used. There are no other# required dependencies.ZLIB_LIB.0 = -lzZLIB_LIB.1 = ZLIB_LIB. = $(ZLIB_LIB.0)# If using zlib:LIB += $(ZLIB_LIB.$(FOSSIL_ENABLE_MINIZ)) $(LDFLAGS)
# If using HTTPS:
LIB += -lcrypto -lssl
#### Tcl shell for use in running the fossil testsuite. If you do not
# care about testing the end result, this can be blank.
#

.TH FOSSIL "1" "February 2015" "http://fossil-scm.org" "User Commands".SH NAMEfossil \- Distributed Version Control System.SH SYNOPSIS.B fossil\fIhelp\fR.br.B fossil\fIhelp COMMAND\fR.br.B fossil\fICOMMAND [OPTIONS]\fR.SH DESCRIPTIONFossil is a distributed version control system (DVCS) with built-inwiki, ticket tracker, CGI/http interface, and http server..SH Common COMMANDs:add clean import pull stash .braddremove clone info purge status.brall commit init push sync.brannotate diff json rebuild tag.brbisect export ls remote-url timeline.brblame extras merge revert ui.brbranch finfo mv rm undo.brbundle fusefs open rss unpublish.brcat gdiff praise settings update.brchanges help publish sqlite3 version.SH FEATURESFeatures as described on the fossil home page..HP1..B Integrated Bug Tracking, Wiki, & Technotes- In addition to doing distributed version control like Git andMercurial, Fossil also supports bug tracking, wiki, and technotes..HP2..B Built-in Web Interface- Fossil has a built-in and intuitive web interface that promotesproject situational awareness. Type "fossil ui" and Fossil automaticallyopens a web browser to a page that shows detailed graphical history andstatus information on that project..HP3..B Self-Contained- Fossil is a single self-contained stand-alone executable. To install,simply download a precompiled binary for Linux, Mac, OpenBSD, or Windowsand put it on your $PATH. Easy-to-compile source code is available forusers on other platforms..HP4..B Simple Networking- No custom protocols or TCP ports. Fossil uses plain old HTTP (or HTTPSor SSH) for all network communications, so it works fine from behindrestrictive firewalls, including proxies. The protocol is bandwidthefficient to the point that Fossil can be used comfortably over dial-up..HP5..B CGI/SCGI Enabled- No server is required, but if you want to set one up, Fossil supportsfour simple server configurations..HP6..B Autosync- Fossil supports "autosync" mode which helps to keep projects movingforward by reducing the amount of needless forking and merging oftenassociated with distributed projects..HP7..B Robust & Reliable- Fossil stores content using an enduring file format in an SQLitedatabase so that transactions are atomic even if interrupted by apower loss or system crash. Automatic self-checks verify that allaspects of the repository are consistent prior to each commit. Inover seven years of operation, no work has ever been lost afterhaving been committed to a Fossil repository..SH DOCUMENTATIONhttp://www.fossil-scm.org/.br.B fossil\fIui\fR

Built-in Skins==============Each subdirectory under this folder describes a built-in "skin".There are four files in each subdirectory for the CSS, the "details"file, the footer, and the header for that skin.To improve an existing built-in skin, simply edit the appropriatefiles and recompile.To add a new skin: 1. Create a new subdirectory under skins/. (The new directory is called "skins/newskin" below but you should use a new original name, of course.) 2. Add files skins/newskin/css.txt, skins/newskin/details.txt, skins/newskin/footer.txt and skins/newskin/header.txt. Be sure to "fossil add" these files. 3. Go to the src/ directory and rerun "tclsh makemake.tcl". This step rebuilds the various makefiles so that they have dependencies on the skin files you just installed. 4. Edit the BuiltinSkin[] array near the top of the src/skins.c source file so that it describes and references the "newskin" skin. 5. Type "make" to rebuild.Development Hints-----------------One way to develop a new skin is to copy the baseline files (css.txt,details.txt, footer.txt, and header.txt) into a working directory $WORKDIR then launch Fossil with a command-line option "--skin $WORKDIR". Example: cp -r skins/default newskin fossil ui --skin ./newskinWhen the argument to --skin contains one or more '/' characters, theappropriate skin files are read from disk from the directory specified.So after launching fossil as shown above, you can edit the newskin/css.txt,newskin/details.txt, newskin/footer.txt, and newskin/header.txt files usingyour favorite text editor, then press Reload on your browser to seeimmediate results.

## Blitz ThemeContributed by James Moger (james.moger@gitblit.com)This theme is inspired by my own project, [Gitblit](http://gitblit.com), and offered to the Fossil project.This theme embeds & uses an unmodified copy of [Normalize 3.0.2](https://necolas.github.io/normalize.css/) which is distributed under an [MIT license](https://github.com/necolas/normalize.css/blob/master/LICENSE.md).This theme uses half of a heavily-modified version of [Skeleton](http://getskeleton.com) which is distributed under an [MIT license](https://github.com/dhg/Skeleton/blob/master/LICENSE.md). None of the responsive elements (media queries) are included at this time.The font used in the included Fossil logo image is [Trillium Web Light](http://www.google.com/fonts/specimen/Titillium+Web) @ 48px HTML color code #456a7a.The RSS feed icon is sourced from [Font-Awesome](https://fortawesome.github.io/Font-Awesome/icons) by Dave Gandy and is distributed under the [SIL OFL 1.1 ](http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL) license.

## Blitz Theme (no logo)Contributed by James Moger (james.moger@gitblit.com)This theme is inspired by my own project, [Gitblit](http://gitblit.com), and offered to the Fossil project.This theme embeds & uses an unmodified copy of [Normalize 3.0.2](https://necolas.github.io/normalize.css/) which is distributed under an [MIT license](https://github.com/necolas/normalize.css/blob/master/LICENSE.md).This theme uses half of a heavily-modified version of [Skeleton](http://getskeleton.com) which is distributed under an [MIT license](https://github.com/dhg/Skeleton/blob/master/LICENSE.md). None of the responsive elements (media queries) are included at this time.The font used in the included Fossil logo image is [Trillium Web Light](http://www.google.com/fonts/specimen/Titillium+Web) @ 48px HTML color code #456a7a.The RSS feed icon is sourced from [Font-Awesome](https://fortawesome.github.io/Font-Awesome/icons) by Dave Gandy and is distributed under the [SIL OFL 1.1 ](http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL) license.

This skin was contributed by Étienne Deparis.On 2015-03-14 this skin was promoted from an option to the default, whichinvolved moving it from its original home in the skins/etienne1 directoryinto skins/default.