diff options
author | Thomas Goirand <thomas@goirand.fr> | 2014-12-02 23:18:18 +0800 |
---|---|---|
committer | Thomas Goirand <thomas@goirand.fr> | 2014-12-02 23:18:18 +0800 |
commit | c8d60483711491fae633cd15c15e951dddacb6f1 (patch) | |
tree | 53311aeb1465f3fb6c009a1787ad2981c4b544a8 | |
parent | e0d267410298eff3b692146c52b963609caddd85 (diff) | |
download | pbr-c8d60483711491fae633cd15c15e951dddacb6f1.tar.gz |
Packagers vs package maintainers
The doc uses a familliar word of "packager", but the real name
should be "package maintainer". This fixes it.
Change-Id: Ieab50fe7ed0d666c9c6eff4c0b986765765f1ac4
-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` |