generic-library/curl
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

imap: Reworked some function descriptions

Browse Source
This commit is contained in:
Steve Holme 2013-03-10 12:56:45 +00:00
parent cbea345f61
commit 1fcf52cae4
1 changed files with 23 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
lib/imap.c
View File

@ -326,10 +326,16 @@ static char *imap_atom(const char *str)
return newstr; return newstr;
} }
/* Determines whether the untagged response is related to a specified /***********************************************************************
command by checking if it is in format "* <command-name> ..." or *
"* <number> <command-name> ...". The "* " marker is assumed to have * imap_matchresp()
already been checked by the caller. */ *
* Determines whether the untagged response is related to the specified
* command by checking if it is in format "* <command-name> ..." or
* "* <number> <command-name> ...".
*
* The "* " marker is assumed to have already been checked by the caller.
*/
static bool imap_matchresp(const char *line, size_t len, const char *cmd) static bool imap_matchresp(const char *line, size_t len, const char *cmd)
{ {
const char *end = line + len; const char *end = line + len;
@ -361,8 +367,13 @@ static bool imap_matchresp(const char *line, size_t len, const char *cmd)
return FALSE; return FALSE;
} }
/* Function that checks whether the given string is a valid tagged, untagged /***********************************************************************
or continuation response which can be processed by the response handler. */ *
* imap_endofresp()
*
* Checks whether the given string is a valid tagged, untagged or continuation
* response which can be processed by the response handler.
*/
static bool imap_endofresp(struct connectdata *conn, char *line, size_t len, static bool imap_endofresp(struct connectdata *conn, char *line, size_t len,
int *resp) int *resp)
{ {
@ -458,7 +469,12 @@ static bool imap_endofresp(struct connectdata *conn, char *line, size_t len,
return FALSE; /* Nothing for us */ return FALSE; /* Nothing for us */
} }
/* This is the ONLY way to change IMAP state! */ /***********************************************************************
*
* state()
*
* This is the ONLY way to change IMAP state!
*/
static void state(struct connectdata *conn, imapstate newstate) static void state(struct connectdata *conn, imapstate newstate)
{ {
struct imap_conn *imapc = &conn->proto.imapc; struct imap_conn *imapc = &conn->proto.imapc;