<h2>Installation</h2>

<b>Note:</b> This uses the vcs_info from zshell version 4.3.11. If you
are running 4.3.10, you can copy the vcs_info software from the 4.3.11
distribution of zsh and install that in place of what was shipped with
4.3.10.

The VCS_INFO*fossil files should be copied to
<tt><var>prefix</var>/share/zsh/<var>version</var>/functions/VCS_Info/Backends</tt>.
<var>prefix</var> is probably either <tt>/usr/local</tt> or <tt>/usr</tt>,
depending on your system.  <var>version</var> can be found by running
<tt>zsh --version</tt>.

Then, as root in the <tt><var>prefix</var>/share/zsh/<var>version</var>/functions</tt>
directory, run:

<pre><tt>setopt extendedglob nomark_dirs
zcompile -U -M VCS_Info.zwc VCS_Info/*~*.zwc(^/)
</tt></pre>

<h2>Usage</h2>

Usage is pretty much the same as it is for any other backend for
vcs_info - see the zsh docs for information.

The displayed revision (<tt>%i</tt> or <tt>%r</tt> in
<var>branchformat</var>) is the first 10 digits of the artifact id by
default. You can change this by setting the <var>fsrevformat</var>
variable like so:

<tt>zstyle ':vcs_info:fossil:*' fsrevformat '%.<var><max></var>h'</tt>

<tt>h</tt> is the only valid format character. Change <var><max></var>
to the number of digits you want to display. As stated, the default
format is <tt>%.10h</tt>. Changing the format to <tt>'%h'</tt> will
print the entire artifact id (not recommended).  Open a ticket (see
below) if you think this should change.

The misc field (<tt>%m</tt>) is currently set to the
repository. Suggestions for alternatives are welcome (data from the
<tt>fossil status</tt> command preferred).