summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRonny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>2010-09-14 23:52:07 +0200
committerRonny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>2010-09-14 23:52:07 +0200
commitf4ac9b701048becdb749af2ae3fe117ce638f53e (patch)
tree6665efe5d5ba15be4dee07e616b7fd82572a06b9
parentce182dafb548b43798d10b19d72756b0315a139f (diff)
downloadsetuptools-scm-0.10.tar.gz
document the usage as setup requirementv0.10
-rw-r--r--README.txt15
1 files changed, 15 insertions, 0 deletions
diff --git a/README.txt b/README.txt
index 4c58eb9..954da2f 100644
--- a/README.txt
+++ b/README.txt
@@ -4,6 +4,8 @@ hgdistver
This module is a simple drop-in to support setup.py
in mercurial based projects.
+Alternatively it can be a setup time requirement.
+
Its supposed to generate version numbers from mercurials meta-data.
It tries to use the current tag and
falls back to the next reachable tagged ancestor and
@@ -29,3 +31,16 @@ The most simple usage is::
`get_version` takes the optional argument `cachefile`,
which causes it to store the version info in a python script instead
of abusing PKG-INFO from a sdist.
+
+
+The setup requirement usage is::
+
+ from setuptools import setup
+ setup(
+ ...,
+ get_version_from_hg=True,
+ setup_requires=['hgdistver'],
+ ...,
+ )
+
+The requirement usage doesn't yet support cachefile.