New API docs

["Ilya A. Volynets-Evenbakh" <ilya@total-knowledge.com>]

I think we need few more changes documented.
I.E. now, that CXmlAttributes is based on std::map, things like 
CXmlAttributes::Iterator should
be replaced by CXmlAttributes::iterator. Perhaps full list of affected 
classes should be compiled
for reference?

--
Ilya A. Volynets-Evenbakh
Total Knowledge. CTO
http://www.total-knowledge.com