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?
Yep. You should document it.  

--  
Hoa V. Dinh


On Sunday, June 29, 2014 at 11:23 AM, Yazhong Liu wrote:

> In README.md:
> > +* ssl > +* starttls > +* none/null > + > +The `option.auth` field before just use the plain to request the authentication, and if you want to use `XOAuth2`, then: > + > +```js > +{ > + username: 'yorkiefixer@gmail.com', > + accessToken: 'your access_token' > +} > +``` > + > +(In later version, we can support the auto fetch the token when you specified `clientId`, `clientSecret` and `refreshToken`). > + > +#### imap.connect([callback])  
> No parameters, just a simple function, should i still document more on this function?
>  
> —
> Reply to this email directly or view it on GitHub (https://github.com/MailCore/mailcore.node/pull/2/files#r14330652).
>  
>  
>