8000 Merge PR137: fix docs about 'style' config · drinkingjava/python-versioneer@a24a156 · GitHub
[go: up one dir, main page]

Skip to content

Commit a24a156

Browse files
committed
Merge PR137: fix docs about 'style' config
2 parents a2d2337 + 019c4a2 commit a24a156

File tree

2 files changed

+5
-8
lines changed

2 files changed

+5
-8
lines changed

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -146,8 +146,8 @@ that this commit is two revisions ("+2") beyond the "0.11" tag. For released
146146
software (exactly equal to a known tag), the identifier will only contain the
147147
stripped tag, e.g. "0.11".
148148

149-
Other styles are available. See details.md in the Versioneer source tree for
150-
descriptions.
149+
Other styles are available. See [details.md](details.md) in the Versioneer
150+
source tree for descriptions.
151151

152152
## Debugging
153153

details.md

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ It returns `get_versions()["version"]`. See below for what that means.
2222

2323
## What does get_versions() return?
2424

25-
`get_versions()` returns a small dictionary of rendered version information, which always contains four keys:
25+
`get_versions()` returns a small dictionary of rendered version information, which always contains four keys:
2626

2727
| key | description |
2828
| --- | --- |
@@ -61,13 +61,11 @@ if versioneer.get_versions()["dirty"]:
6161

6262
`dirty` is most meaningful in from-vcs mode. In from-file mode, it records the dirty status of the tree from which the setup.py build/sdist command was run, and is not affected by subsequent changes to the generated tree. In from-keyword and from-parentdir mode, it will always be `False`.
6363

64-
## How do I select a 'version-style'?
65-
66-
(note: styles are not yet implemented, and all strings use the `pep440` style)
64+
## How do I select a version `style`?
6765

6866
In from-vcs mode (inside a git checkout), Versioneer can get a lot of data about the state of the tree: the current tag (if any), the closest historical tag, the number of commits since that tag, the exact revision ID, and the 'dirty' state. These pieces are used by a renderer function to compute the `['version']` in the small dictionary that will be returned by `get_versions()`.
6967

70-
The renderer function is controlled by a configuration value called `version-style`. You can use this to select the kind of version string you want to use. The available forms are:
68+
The renderer function is controlled by a configuration value called `style`. You can use this to select the kind of version string you want to use. The available forms are:
7169

7270
| key | description |
7371
| --- | ----------- |
@@ -110,4 +108,3 @@ The from-keywords mode will only produce `exact-tag` and `full-revisionid`. If t
110108
| pep440-old | TAG[.postDIST] | TAG or ? | TAG[.postDIST[.dev0]] | TAG or ? |
111109
| git-describe | TAG[-DIST-gHASH] | TAG or ? | TAG[-DIST-gHASH][-dirty] | TAG or ? |
112110
| long | TAG-DIST-gHASH | TAG-gHASH or ? | TAG-DIST-gHASH[-dirty] | ? |
113-

0 commit comments

Comments
 (0)
0