Some docstrings for the Python module.  Need to figure out how to fix the

summary in the help() output.

  python -c 'import cracklib; help(cracklib)'

diff -up cracklib-2.8.10/python/cracklibmodule.c cracklib-2.8.10/python/cracklibmodule.c

--- cracklib-2.8.10/python/cracklibmodule.c	2007-07-19 09:57:04.000000000 -0400

+++ cracklib-2.8.10/python/cracklibmodule.c	2007-07-19 09:57:48.000000000 -0400

@@ -24,7 +24,6 @@ static pthread_mutex_t cracklib_mutex = 

 static PyObject *

 cracklib_FascistCheck(PyObject *self, PyObject *args, PyObject *kwargs)

 {

-    int i;

     char *candidate, *dict;

     const char *result;

     struct stat st;

@@ -96,12 +95,21 @@ cracklib_FascistCheck(PyObject *self, Py

 static PyMethodDef

 cracklibmethods[] =

 {

-    {"FascistCheck", cracklib_FascistCheck, METH_VARARGS | METH_KEYWORDS},

+    {"FascistCheck", cracklib_FascistCheck, METH_VARARGS | METH_KEYWORDS,

+     "Keyword arguments:\n"

+     "  pw - candidate password\n"

+     "  dict - dictionary location (default \""

+     DEFAULT_CRACKLIB_DICT

+     "\")\n"

+     "\n"

+     "Returns:\n"

+     "  None on success, an error string on failure.\n"},

     {NULL, NULL},

 };

 void

 initcracklib(void)

 {

-    Py_InitModule("cracklib", cracklibmethods);

+    Py_InitModule3("cracklib", cracklibmethods,

+                   "Python interface to libcrack's FascistCheck() function.\n");

 }