Updated the function description comments following commit 4838d196.

Moved the blocking state machine to the disconnect functions so that the
logout / quit functions are only responsible for sending the actual
command needed to logout or quit.

Additionally removed the hard return on failure.

Added comments and simplified convoluted dophase_done comparison.

Added an exception, for the STORE command, to the untagged response
processor in imap_endofresp() as servers will back respones containing
the FETCH keyword instead.

GCC specific adjustments:

- check __ILP32__ before 32 and 64bit processor architectures in
  order to detect ILP32 programming model on 64 bit processors
  which, of course, also support LP64 programming model, when using
  gcc 4.7 or newer.

- keep 32bit processor architecture checks in order to support gcc
  versions older than 4.7 which don't define __ILP32__

- check __LP64__ for gcc 3.3 and newer, while keeping 64bit processor
  architecture checks for older versions which don't define __LP64__

Bug: http://curl.haxx.se/bug/view.cgi?id=1205
Reported by: technion

Removed unwanted braces and added variable initialisation.

Optimised the result test in each of the block_statemach() functions.

Added examples of the list command and clarified existing example URLs
following recent changes.

Updated the imap features list, corrected a typo in the smtp features
and clarified a pop3 feature.

The list of unsafe functions currently consists of sprintf, vsprintf,
strcat, strncat and gets.

Subsequently, some existing code needed updating to avoid warnings on
this.

With all the recent imap changes it wasn't clear what new features and
fixes should be included in the release notes.

Just a folder list would be retrieved if UID was not specified now.

Commit 198012ee inadvertently broke LIST_imap().

Removed unnecessary state changes on failure and setting of result codes
on success.

Removed unnecessary state change on failure and setting of result code on
success.

Reworked comments as they referenced custom commands, removed
unnecessary state change on failure and setting of result code on
success.

Removed imap_state_custom_resp() as imap_state_list_resp() provides the
same functionality.

Enriched IMAP capabilities of ftpserver.pl in order to be able to
add tests for the new IMAP features.

* Added support for APPEND - Saves uploaded data to log/upload.$testno
* Added support for LIST - Returns the contents of <reply/> section in
  the current test, like e.g FETCH.
* Added support for STORE - Returns hardcoded updated flags
* Changed handling of SELECT - Returns much more information in the
  usual set of untagged responses; uses hardcoded data from an example
  in the IMAP RFC
* Changed handling of FETCH - Fixed response format

As the UID has to be specified by the user for the FETCH command to work
correctly, added a check to imap_fetch(), although strictly speaking it
is protected by the call from imap_perform().

The option needs to be set on the SSL socket.  Setting it on the model
takes no effect.  Note that the non-blocking mode is still not enabled
for the handshake because the code is not yet ready for that.

imap.c:694:21: error: unused variable 'imapc' [-Werror=unused-variable]

Updated the style of imap_select() before adding the LIST command.

In preparation for the addition of the LIST command, moved the mailbox
check from imap_do() to imap_select() and imap_append().

Commit 26eaa838 introduces the use of S_ISDIR() yet some compilers,
such as MSVC don't support it, so we must define a substitute using
file flags and mask.

Commit f4cc54cb (shipped as part of the 7.29.0 release) was a
bug fix that introduced a regression in that while trying to avoid
allowing directory names, it also forbade "special" files like character
devices and more. like "/dev/null" as was used by Oliver who reported
this regression.

Reported by: Oliver Gondža
Bug: http://curl.haxx.se/mail/archive-2013-02/0040.html