Improve manual the methods section.
Add some commmtns to the xml examples.