Big Upgrade

This commit contain few bug corrections  and improvements, more inline code documentation, examples and README updated.

Be carefull if you update, there is some modifications.