X-Git-Url: https://code.citadel.org/?a=blobdiff_plain;f=webcit%2Ftools.c;h=809afee948cd49c24c3bb09a7f483192a3fc83fb;hb=1e32899153e9e52aaec1e651e0c33a563b8aaed8;hp=86e2d4f5ce6cc616d5127867cb745eec1e05e37e;hpb=8c451428eca6cfe21a76c388984c2d6cae7d33bb;p=citadel.git

diff --git a/webcit/tools.c b/webcit/tools.c
index 86e2d4f5c..809afee94 100644
--- a/webcit/tools.c
+++ b/webcit/tools.c
@@ -3,6 +3,7 @@
  */
 /**
  * \defgroup MiscRout Miscellaneous routines 
+ * \ingroup tools
  */
 
 /*@{*/
@@ -193,10 +194,10 @@ int haschar(char *st,char ch)
 
 /** 
  * \brief Utility function to "readline" from memory
- * \param start position in buf
- * \param buf the buffer to create string in???
- * \param maxlen how big may the buffer get?
- * \return new pointer to read string
+ * \param start Location in memory from which we are reading.
+ * \param buf the buffer to place the string in.
+ * \param maxlen Size of string buffer
+ * \return Pointer to the source memory right after we stopped reading.
  */
 char *memreadline(char *start, char *buf, int maxlen)
 {
@@ -257,9 +258,11 @@ void striplt(char *buf)
 /**
  * \brief Determine whether the specified message number is contained within the
  * specified set.
- * \param mset stringset???
- * \param msgnum a citadel server indexnumber
- * \return yes / no ???
+ *
+ * \param mset Message set string
+ * \param msgnum Message number we are looking for
+ *
+ * \return Nonzero if the specified message number is in the specified message set string.
  */
 int is_msg_in_mset(char *mset, long msgnum) {
 	int num_sets;
@@ -435,10 +438,11 @@ void CtdlEncodeBase64(char *dest, const char *source, size_t sourcelen)
 /**
  * \brief Convert base64-encoded to binary.  
  * It will stop after reading 'length' bytes.
- * \param dest the destination buffer 
- * \param source the encrypted string
- * \param length the maximal length of dest???
- * \return the length actual length of the decoded data.
+ *
+ * \param dest The destination buffer 
+ * \param source The base64 data to be decoded.
+ * \param length The number of bytes to decode.
+ * \return The actual length of the decoded data.
  */
 int CtdlDecodeBase64(char *dest, const char *source, size_t length)
 {
@@ -506,7 +510,8 @@ int CtdlDecodeBase64(char *dest, const char *source, size_t length)
 
 /**
  * \brief Generate a new, globally unique UID parameter for a calendar etc. object
- * \param buf uid to create ????
+ *
+ * \param buf String buffer into which our newly created UUID should be placed
  */
 void generate_uuid(char *buf) {
 	static int seq = 0;