From 4b91b58469091ea63e113b415f0dac8040a57663 Mon Sep 17 00:00:00 2001
From: B. Watson
Date: Sun, 6 Nov 2016 17:12:43 -0500
Subject: python/pbr: Update README, slack-desc.

---
 python/pbr/README     | 20 +++++++++++++++-----
 python/pbr/slack-desc |  2 +-
 2 files changed, 16 insertions(+), 6 deletions(-)

(limited to 'python/pbr')

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: 
-- 
cgit v1.2.3