imap, doc: documented stuffs on imapsession

I documented some stuffs and now updates the TODO List:

* 
Documentation of each method in IMAPSession.js, parameters and examples, returned data.

* **appendMessage** flags and date parameters should be made more nodeJS friendly + they should be made optional through an option parameter.
* **fetchMessagesByNumber / fetchMessagesByUid** option parameter should also be made more nodeJS friendly.
* remove options parameter of **copyMessages**: use only UID.
* **add tests**(what i added)

LGTY?
Options = {date: optional date, flags: ['seen', 'flagged']}  

Flags should be an array.
I'd like to make flags optional too.

--  
Hoa V. Dinh


On Sunday, June 29, 2014 at 11:26 AM, Yazhong Liu wrote:

> In README.md:
> > +* callback Function > + > +Fetches the messages from you selected folder. > + > +#### imap.search(query, callback) > + > +* query String > +* callback Function > + > +The `SEARCH` command implementation. > + > +#### imap.appendMessage(folder, data, flags, date, callback) > + > +* folder String > +* data String, rfc822 message data > +* flags Array  
> I'm unsure this, just copy from the mailcore2, could you please provide something about me on the flags, shouldn't it be an array? :(
>  
> —
> Reply to this email directly or view it on GitHub (https://github.com/MailCore/mailcore.node/pull/2/files#r14330663).
>  
>  
>