Re-enable the documentation with a bit of cleanup

• use the macros provided by KDocTools from Frameworks to generate the documentation;
• remove/fix few outdated information from the man page.