From a14a21b2c2f318daa082247d587a273db57ac4b9 Mon Sep 17 00:00:00 2001
From: Ken Dreyer <kdreyer@redhat.com>
Date: Apr 23 2020 23:33:51 +0000
Subject: hub: document createUser arguments


Describe the types of each argument to the createUser() method.

---

diff --git a/hub/kojihub.py b/hub/kojihub.py
index 877b154..960c0c6 100644
--- a/hub/kojihub.py
+++ b/hub/kojihub.py
@@ -11722,7 +11722,16 @@ class RootExports(object):
         update.execute()
 
     def createUser(self, username, status=None, krb_principal=None):
-        """Add a user to the database"""
+        """Add a user to the database
+
+        :param str username: The username for this Koji user.
+        :param int status: This must be one of the values of the
+                           koji.USER_STATUS enum. If unspecified,
+                           the default is koji.USER_STATUS['NORMAL'].
+        :param str krb_principal: a custom Kerberos principal, or None.
+        :raises: GenericError if the user or Kerberos principal already
+                 exists.
+        """
         context.session.assertPerm('admin')
         if get_user(username):
             raise koji.GenericError('user already exists: %s' % username)