% help

keyword extension - keyword expansion in local repositories

This extension expands RCS/CVS-like or self-customized keywords in

the text files selected by your configuration.

Keywords are only expanded in local repositories and not logged by

Mercurial internally. The mechanism can be regarded as a convenience

for the current user and may be turned off anytime.

Caveat: "hg import" might fail if the patches were exported from a

repo with a different/no keyword setup, whereas "hg unbundle" is

safe.

Configuration is done in the [keyword] and [keywordmaps] sections of

hgrc files.

Example:

     [keyword]

     # filename patterns for expansion are configured in this section

     # files matching patterns with value 'ignore' are ignored

     **.py =          ## expand keywords in all python files

     x* = ignore      ## but ignore files matching "x*"

     ...

     [keywordmaps]

     # custom hg template maps _replace_ the CVS-like default ones

     HGdate = {date|rfc822date}

     lastlog = {desc} ## same as {desc|firstline} in this context

     checked in by = {author}

     ...

If no [keywordmaps] are configured the extension falls back on the

following defaults:

     Revision: changeset id

     Author: username

     Date: %Y/%m/%d %H:%M:%S      ## [UTC]

     RCSFile: basename,v

     Source: /path/to/basename,v

     Id: basename,v csetid %Y/%m/%d %H:%M:%S username

     Header: /path/to/basename,v csetid %Y/%m/%d %H:%M:%S username

no commands defined

% cat

expand $Id$

expand $Id$

% default keyword expansion

% commit

adding a

adding b

adding sym

a

b

sym

overwriting a expanding keywords

% status

% cat

ignore $Id$

% hg cat

ignore $Id$

a

% update

% cat

ignore $Id$

% custom keyword expansion

% cat

ignore $Id$

% hg cat

ignore $Id$

a

% commit

a

overwriting a expanding keywords

% status

% cat

$Xinfo: User Name <user@example.com>: firstline $

ignore $Id$

% hg cat

$Xinfo: User Name <user@example.com>: firstline $

ignore $Id$

a

requesting all changes

adding changesets

adding manifests

adding file changes

% incoming

searching for changes

tag:         tip

user:        User Name <user@example.com>

date:        Thu Jan 01 00:00:01 1970 +0000

summary:     firstline

% switch off expansion

% cat

$Xinfo: User Name <user@example.com>: firstline $

ignore $Id$

% hg cat

expand $Id$

$Xinfo$

ignore $Id$

expand $Id$

$Xinfo$