diff options
-rw-r--r-- | doc/source/packagers.rst | 25 |
1 files changed, 13 insertions, 12 deletions
diff --git a/doc/source/packagers.rst b/doc/source/packagers.rst index 110043d..e135b57 100644 --- a/doc/source/packagers.rst +++ b/doc/source/packagers.rst @@ -1,6 +1,6 @@ -===================== - Notes for Packagers -===================== +=============================== + Notes for Package maintainers +=============================== If you are maintaining packages of software that uses `pbr`, there are some features you probably want to be aware of that can make your life easier. @@ -12,10 +12,11 @@ Versioning `pbr`, when run in a git repo, derives the version of a package from the git tags. When run in a tarball with a proper egg-info dir, it will happily -pull the version from that. So for the most part, the packager shouldn't need -to care. However, if you are doing something like keeping a git repo with -the sources and the packaging intermixed and it's causing pbr to get confused -about whether its in its own git repo or not, you can set `PBR_VERSION`: +pull the version from that. So for the most part, the package maintainers +shouldn't need to care. However, if you are doing something like keeping a +git repo with the sources and the packaging intermixed and it's causing pbr +to get confused about whether its in its own git repo or not, you can set +`PBR_VERSION`: :: @@ -57,10 +58,10 @@ Tarballs ======== `pbr` includes everything in a source tarball that is in the original `git` -repository. This can again cause havoc if a packager is doing fancy things -with combined `git` repos, and is generating a source tarball using `python -setup.py sdist` from that repo. If that is the workflow the packager is using, -setting `SKIP_GIT_SDIST`: +repository. This can again cause havoc if a package maintainer is doing fancy +things with combined `git` repos, and is generating a source tarball using +`python setup.py sdist` from that repo. If that is the workflow the packager +is using, setting `SKIP_GIT_SDIST`: :: @@ -76,7 +77,7 @@ AUTHORS and ChangeLog ===================== `pbr` generates AUTHORS and ChangeLog files from git information. This -can cause problem in distro packaging if packager is using git +can cause problem in distro packaging if package maintainer is using git repository for packaging source. If that is the case setting `SKIP_GENERATE_AUTHORS` |