From f8e88bbbd51de4d0533a60db3c9ef63ea81d0982 Mon Sep 17 00:00:00 2001
From: Nalin Dahyabhai <nalin@fedoraproject.org>
Date: Mon, 29 Jan 2007 22:30:35 +0000
Subject: [PATCH] - first cut at adding doc strings

---
 cracklib-2.8.9-docstring.patch | 38 ++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 cracklib-2.8.9-docstring.patch

diff --git a/cracklib-2.8.9-docstring.patch b/cracklib-2.8.9-docstring.patch
new file mode 100644
index 0000000..66a6cb9
--- /dev/null
+++ b/cracklib-2.8.9-docstring.patch
@@ -0,0 +1,38 @@
+Some docstrings for the Python module.  Need to figure out how to fix the
+summary in the help() output.
+
+diff -ur cracklib-2.8.9/python/cracklibmodule.c cracklib-2.8.9/python/cracklibmodule.c
+--- cracklib-2.8.9/python/cracklibmodule.c	2007-01-29 17:28:41.000000000 -0500
++++ cracklib-2.8.9/python/cracklibmodule.c	2007-01-29 17:20:14.000000000 -0500
+@@ -24,7 +24,6 @@
+ 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 @@
+ 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");
+ }