% 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.

Substitution takes place on every commit and update of the working
repository.

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

no commands defined
% cat
$Id$
$Id$
% default keyword expansion
% commit
adding a
adding b
a
b
overwriting a expanding keywords
% cat
$Id: a,v b803250b3164 1970/01/01 00:00:00 user $
$Id$
% hg cat
$Id: a,v b803250b3164 1970/01/01 00:00:00 user $
$Id$
% update
2 files updated, 0 files merged, 0 files removed, 0 files unresolved
% cat
$Id: a,v b803250b3164 1970/01/01 00:00:00 user $
$Id$
% custom keyword expansion
% cat
$Id: a,v b803250b3164 1970/01/01 00:00:00 user $
$Id$
% hg cat
$Id: a b803250b3164 Thu, 01 Jan 1970 00:00:00 +0000 user $
$Id$
% commit
a
overwriting a expanding keywords
% cat
$Id: a 375046bad9d3 Thu, 01 Jan 1970 00:00:01 +0000 user $
$Xinfo: User Name <user@example.com>: firstline $
$Id$
% hg cat
$Id: a 375046bad9d3 Thu, 01 Jan 1970 00:00:01 +0000 user $
$Xinfo: User Name <user@example.com>: firstline $
$Id$
% switch off expansion
% cat
$Id: a 375046bad9d3 Thu, 01 Jan 1970 00:00:01 +0000 user $
$Xinfo: User Name <user@example.com>: firstline $
$Id$
% hg cat
$Id$
$Xinfo$
$Id$
% update
2 files updated, 0 files merged, 0 files removed, 0 files unresolved
% cat
$Id$
$Xinfo$
$Id$