|
Size: 1330
Comment: Add keyword expansion page
|
Size: 1542
Comment: add link to crew-mirror+keyword
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 4: | Line 4: |
| It's being developed by Christian Ebert and can be downloaded from its [http://www.blacktrash.org/cgi-bin/hgwebdir.cgi/hgkeyword/ keyword expansion repository]. | ''Author: Christian Ebert'' Download site: [http://www.blacktrash.org/cgi-bin/mercurial/hgkeyword/ keyword expansion repository]. Mirror of crew repo plus keyword extension: [http://www.blacktrash.org/cgi-bin/mercurial/hg-crew-keyword/ Mercurial crew + keyword]. |
| Line 15: | Line 19: |
| hgext.keyword = path/to/keyword.py #or, if keyword.py is in the hgext folder: #hgext.keyword= |
hgext.keyword= #or, if keyword.py is in not the hgext folder: #keyword=/path/to/keyword.py |
| Line 20: | Line 24: |
| Additional configuration is dones in they [keyword] and [keywordmaps] sections in your configuration file: | Additional configuration is done in the [keyword] and [keywordmaps] sections in your configuration file: |
| Line 29: | Line 33: |
| # using {{{key-to-be-expanded = value}}} lines, where values are taken from the avaliable Mercurial template names. | # using "key-to-be-expanded = value" lines, where values are taken from the available Mercurial template names. # an additional filter "utcdate" is provided to get "%Y/%m/%d %H:%M:%S" date format. |
| Line 38: | Line 43: |
---- CategoryExtension |
Keyword Expansion extension
This extension is not being distributed along with Mercurial.
Author: Christian Ebert
Download site: [http://www.blacktrash.org/cgi-bin/mercurial/hgkeyword/ keyword expansion repository].
Mirror of crew repo plus keyword extension: [http://www.blacktrash.org/cgi-bin/mercurial/hg-crew-keyword/ Mercurial crew + keyword].
Overview
This extension allows the expansion of RCS/CVS-like and user defined keys in Mercurial repositories.
Configuration
To enable this extension add it to the '[extensions]' stanza in the hgrc file:
[extensions] hgext.keyword= #or, if keyword.py is in not the hgext folder: #keyword=/path/to/keyword.py
Additional configuration is done in the [keyword] and [keywordmaps] sections in your configuration file:
# filename patterns for expansion are configured in this section
# files matching patterns with value 'ignore' are ignored
[keyword]
**.py =
x* = ignore
...
# in case you prefer your own keyword maps over the cvs-like defaults:
# using "key-to-be-expanded = value" lines, where values are taken from the available Mercurial template names.
# an additional filter "utcdate" is provided to get "%Y/%m/%d %H:%M:%S" date format.
[keywordmaps]
HGdate = {date|rfc822date}
lastlog = {desc} ## same as {desc|firstline} in this context
checked in by = {author}
Usage
The defined keys (or default ones) are automatically expanded, without user interaction.