post.php Inline Documentation fixes and completion

[jacobsantos]

Corrections and completion of post.php inline documentation.

Corrections for post.php based off of r8662

Massive patch that corrects and completes about 75% of the file.

Oh yeah, as an aside, the file doesn't have the closing php tag.

Replying to jacobsantos:

Oh yeah, as an aside, the file doesn't have the closing php tag.

Lost it in r7907.

Completed post.php phpdoc inline documentation based off of 8665.

Latest patch completes post.php file.

See #3982 and #2473 for historical post.php patches.

(In [8669]) post.php phpdoc. Props santosj. fixes #7538