#14 Add/standardise code comments

[Paul Walker]

Add and standardise comments in the source code. The format should be such that it can be turned into HTML. NaturalDocs is the best tool I've found so far (it was disucussed on the forum here: [a1671a58])