Update command documentation based on feedback from docs team.

ticket #158

1 files changed, 7 insertions, 9 deletions

diff --git a/ipalib/plugins/passwd.py b/ipalib/plugins/passwd.py
index f4f722f1e..ef515605e 100644
--- a/ipalib/plugins/passwd.py
+++ b/ipalib/plugins/passwd.py
@@ -17,23 +17,21 @@
 # along with this program; if not, write to the Free Software
 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 """
-User password changes
+Set a user's password
 
-Sets a user password. Normally a user can only change their own password.
-
-If someone other than user changes a password (e.g. helpdesk resets it)
+If someone other than user changes their password (e.g., Helpdesk resets it)
 then the password will need to be changed the first time it is used.
 This is so the end-user is the only one that knows the password.
 
-Password policy will control how often a password may be changed,
-what strength requirements there are and long the password history is.
+The IPA password policy controls how often a password may be changed,
+what strength requirements exist, and the length of the password history.
 
 EXAMPLES:
 
- Reset your own password:
+ To reset your own password:
    ipa passwd
 
- Change another user's password:
+ To change another user's password:
    ipa passwd tuser1
 """
 
@@ -45,7 +43,7 @@ from ipalib import _
 
 class passwd(Command):
     """
-    Change user password.
+    Set a user's password
     """
 
     takes_args = (