It (almost) works now

Fixed: The file header comments were treated as function header comments.
The issues remaining: 
(a) The Pawn compiler(the pawndoc component) does not handle newlines and indention well.
(b) There's an unaccounted for situation when a parameter does not have an explaination(no hyphen), i temporary resolved it by printing the line where it happens.