imap: Reworked some function descriptions

  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

   already been checked by the caller. */

/***********************************************************************

 *

 * imap_matchresp()

 *

 * 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)

{

  const char *end = line + len;

  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,

                           int *resp)

{

  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)

{

  struct imap_conn *imapc = &conn->proto.imapc;