From e5e8c5577b69ef29176d912ca559ad27b4716072 Mon Sep 17 00:00:00 2001
From: Dolph Mathews <dolph.mathews@gmail.com>
Date: Wed, 13 Jul 2016 20:14:46 +0000
Subject: [PATCH] Improve keystone.conf [shadow_users] documentation

Change-Id: Ic06f63c9d9222867df407c687376afa8c69a3f42
---
 keystone/conf/shadow_users.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/keystone/conf/shadow_users.py b/keystone/conf/shadow_users.py
index ed2da099f..da1636ff6 100644
--- a/keystone/conf/shadow_users.py
+++ b/keystone/conf/shadow_users.py
@@ -19,8 +19,11 @@ driver = cfg.StrOpt(
     'driver',
     default='sql',
     help=utils.fmt("""
-Entrypoint for the shadow users backend driver in the
-keystone.identity.shadow_users namespace.
+Entry point for the shadow users backend driver in the
+`keystone.identity.shadow_users` namespace. This driver is used for persisting
+local user references to externally-managed identities (via federation, LDAP,
+etc). Keystone only provides a `sql` driver, so there is no reason to change
+this option unless you are providing a custom entry point.
 """))