Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 300969 - mercurial.eclass: Document how versatile EHG_REVISION really is
Summary: mercurial.eclass: Document how versatile EHG_REVISION really is
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Eclasses (show other bugs)
Hardware: All Linux
: High enhancement (vote)
Assignee: Krzysztof Pawlik (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2010-01-14 11:39 UTC by Daniel Mettler
Modified: 2010-01-17 13:42 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Daniel Mettler 2010-01-14 11:39:15 UTC
When debugging the dev-python/python-twitter-9999.ebuild (see http://bugs.gentoo.org/show_bug.cgi?id=300967) lately, we were struggling with finding a way to specify the branch to use.

binki/Nathan then pointed out that, surprisingly, EHG_REVISION is not limited to holding a changeset ID or tag, but can also hold a branch name (in our case: EHG_REVISION="default").

It would be cool (and likely of great help to many) if this fact, i.e. the versatility of EHG_REVISION, could be documented somehow (e.g. in mercurial.eclass).

Thanks!
Comment 1 Krzysztof Pawlik (RETIRED) gentoo-dev 2010-01-17 11:21:18 UTC
EHG_REVISION is passed directly to mercurial as value of --rev parameter and what you've described is documented in `hg help revisions' output:

Any other string is treated as a tag or branch name. A tag name is a symbolic name associated with a revision identifier. A branch name denotes the tipmost revision of that branch. Tag and branch names must not contain the ":" character.

I've modified description to mention `hg help revisions':

 # @DESCRIPTION:
 # Create working directory for specified revision, defaults to tip.
+#
+# EHG_REVISION is passed as a value for --rev parameter, so it can be more than
+# just a revision, please consult `hg help revisions' for more details.
Comment 2 Daniel Mettler 2010-01-17 13:42:49 UTC
Thanks, Krzysiek!