Change docstrings from being C programmer oriented to being Python programmer oriented
diff --git a/src/rand/rand.c b/src/rand/rand.c
index ff89ebb..f1c8440 100644
--- a/src/rand/rand.c
+++ b/src/rand/rand.c
@@ -30,11 +30,9 @@
static char rand_add_doc[] = "\n\
Add data with a given entropy to the PRNG\n\
\n\
-Arguments: spam - Always NULL\n\
- args - The Python argument tuple, should be:\n\
- buffer - Buffer with random data\n\
- entropy - The entropy (in bytes) measurement of the buffer\n\
-Returns: None\n\
+@param buffer: Buffer with random data\n\
+@param entropy: The entropy (in bytes) measurement of the buffer\n\
+@return: None\n\
";
static PyObject *
@@ -56,10 +54,8 @@
static char rand_seed_doc[] = "\n\
Alias for rand_add, with entropy equal to length\n\
\n\
-Arguments: spam - Always NULL\n\
- args - The Python argument tuple, should be:\n\
- buffer - Buffer with random data\n\
-Returns: None\n\
+@param buffer: Buffer with random data\n\
+@return: None\n\
";
static PyObject *
@@ -80,9 +76,7 @@
static char rand_status_doc[] = "\n\
Retrieve the status of the PRNG\n\
\n\
-Arguments: spam - Always NULL\n\
- args - The Python argument tuple, should be empty\n\
-Returns: True if the PRNG is seeded enough, false otherwise\n\
+@return: True if the PRNG is seeded enough, false otherwise\n\
";
static PyObject *
@@ -99,9 +93,7 @@
Add the current contents of the screen to the PRNG state. Availability:\n\
Windows.\n\
\n\
-Arguments: spam - Always NULL\n\
- args - The Python argument tuple, should be empty\n\
-Returns: None\n\
+@return: None\n\
";
static PyObject *
@@ -121,12 +113,10 @@
PRNG. I haven't found any problems when the socket is missing, the function\n\
just returns 0.\n\
\n\
-Arguments: spam - Always NULL\n\
- args - The Python argument tuple, should be:\n\
- path - The path to the EGD socket\n\
- bytes - (optional) The number of bytes to read, default is 255\n\
-Returns: The number of bytes read (NB: a value of 0 isn't necessarily an\n\
- error, check rand.status())\n\
+@param path: The path to the EGD socket\n\
+@param bytes: (optional) The number of bytes to read, default is 255\n\
+@returns: The number of bytes read (NB: a value of 0 isn't necessarily an\n\
+ error, check rand.status())\n\
";
static PyObject *
@@ -144,9 +134,7 @@
static char rand_cleanup_doc[] = "\n\
Erase the memory used by the PRNG.\n\
\n\
-Arguments: spam - Always NULL\n\
- args - The Python argument tuple, should be empty\n\
-Returns: None\n\
+@return: None\n\
";
static PyObject *
@@ -164,12 +152,10 @@
static char rand_load_file_doc[] = "\n\
Seed the PRNG with data from a file\n\
\n\
-Arguments: spam - Always NULL\n\
- args - The Python argument tuple, should be:\n\
- filename - The file to read data from\n\
- maxbytes - (optional) The number of bytes to read, default is\n\
- to read the entire file\n\
-Returns: The number of bytes read\n\
+@param filename: The file to read data from\n\
+@param maxbytes: (optional) The number of bytes to read, default is\n\
+ to read the entire file\n\
+@return: The number of bytes read\n\
";
static PyObject *
@@ -187,10 +173,8 @@
static char rand_write_file_doc[] = "\n\
Save PRNG state to a file\n\
\n\
-Arguments: spam - Always NULL\n\
- args - The Python argument tuple, should be:\n\
- filename - The file to write data to\n\
-Returns: The number of bytes written\n\
+@param filename: The file to write data to\n\
+@return: The number of bytes written\n\
";
static PyObject *