Massive API documentation update and fixes. This is still a work in progress...

Massive API documentation update and fixes. This is still a work in progress and will take somewhere between few weeks to few months before it is in a decent state. Any new code
MUST adhere to doxygen documentation standards before it can be accepted in KStars.

CCMAIL:kstars-devel@kde.org