Page History
This page is intended to get you started with gliss as quickly as possible; you may want to see this short article for more details.
Annotating your commits
A gliss gloss is a simple tagged annotation in a commit message. The basic format of a gliss gloss is three identical characters on a line by themselves, followed by a tag name, followed by the same three identical characters that opened the line, and then the tag text; for example:
===FOO=== This is a gloss tagged FOO
If you need to extend comment text beyond one line, simply indent the second line and ensure that every subsequent line is at least as indented as the second line. Here's what that would look like:
===FOO=== Here's a slightly longer-winded gloss tagged FOO.
Such a gloss will end before the beginning of the first line that is not at least as indented as the second line.
Useful tags
Here are some useful tags for your gliss glosses:
GT
, followed by a ticket number (starting with a pound so gittrac will recognize it), which indicates that this commit is related to a particular ticket.GT:Fixed
, followed by a ticket number (again, starting with a pound); this impliesGT
and indicates that this commit resolves a particular ticket.UpgradeNote
includes a description of a backwards-compatibility issue introduced by this commit (e.g. "This commit changes the wire protocol for the pony server.")VersionHistory
includes a version history entry related to this commit.
Installing a commit message template
Installing gliss
The easiest way to install gliss is to use the RubyGem package.
Inspecting glosses