More API documentation. The OAL classes and namespace was not documented so I added my own documentation stub, but Praksh or anyone familiar with it should expand it to include thorough documentation of the classes.
I reworked How it works a bit in the main API page so please take a look at it a bit to see if it needs further data.

CCMAIL: kstars-devel@kde.org