Fixes for the docs and #439 

These commits fix small issues in the documentation and the issue #439 

As per suggestion given by @jthurner on the IRC: 
The fixes for #439 will mean that the *text* argument in ```handle()``` method will contain newlines if they are received. This might mean that someone's code which assumes no newlines in *text* argument, might break. Hence, we could have some kind of switchable behaviour which converts these newlines into whitespaces in the text argument, if required.

What do you guys think ?