summaryrefslogtreecommitdiff
path: root/python/pbr
diff options
context:
space:
mode:
Diffstat (limited to 'python/pbr')
-rw-r--r--python/pbr/README20
-rw-r--r--python/pbr/slack-desc2
2 files changed, 16 insertions, 6 deletions
diff --git a/python/pbr/README b/python/pbr/README
index 45ef2f90b8..0b25866fe4 100644
--- a/python/pbr/README
+++ b/python/pbr/README
@@ -1,6 +1,16 @@
-PBR is a library that injects some useful and sensible default behaviors into your setuptools run.
+pbr (manage setuptools packaging)
-PBR is only mildly configurable. The basic idea is that there's a decent way to run things and if
-you do, you should reap the rewards, because then it's simple and repeatable. If you want to do
-things differently, cool! But you've already got the power of python at your fingertips, so you
-don't really need PBR.
+A library for managing setuptools packaging in a consistent manner.
+
+PBR is a library that injects some useful and sensible default behaviors
+into your setuptools run.
+
+PBR reads and then filters the setup.cfg data through a setup hook to
+fill in default values and provide more sensible behaviors, and then
+feeds the results in as the arguments to a call to setup.py
+
+PBR is only mildly configurable. The basic idea is that there's a decent
+way to run things and if you do, you should reap the rewards, because
+then it's simple and repeatable. If you want to do things differently,
+cool! But you've already got the power of python at your fingertips,
+so you don't really need PBR.
diff --git a/python/pbr/slack-desc b/python/pbr/slack-desc
index d845dc2de4..e70345a462 100644
--- a/python/pbr/slack-desc
+++ b/python/pbr/slack-desc
@@ -6,7 +6,7 @@
# customary to leave one space after the ':' except on otherwise blank lines.
|-----handy-ruler------------------------------------------------------|
-pbr: pbr (managing setuptools packaging)
+pbr: pbr (manage setuptools packaging)
pbr:
pbr: A library for managing setuptools packaging in a consistent manner.
pbr: