Fixed invalid or outdated function documentation comments.

I checked the available documentation comments for consistency in respect to the respective function's signature. Mostly param tags had to be fixed to reflect function signature changes from code refactoring.

There are a few situations where I'm not sure how to fix it in a correct way, for example in parser.h:484-495: It seems like the comment block has to be moved a function down and slightly adapted.

Please have a look at it. Thanks.