improving the Manual

Looking forward to it. Please also write the C++ versions of the pages if you have the required knowledge.