Inline documentation improvements for wp-includes/comment-template.php.

Changes include:
- Existing phpdoc block improvements
- Inclusion of defaults for optional parameters
- Hash-notated argument arrays
- Removal of unnecessary or redundant tagging.

Also standardization of int|WP_Post function parameters.

These changes clear the way toward less redundancy for hook docs in a future ticket.

Still left: Fully documented arguments in `comment_form()` and a pass through Walker_Comment.

See #20495. See #25388.


git-svn-id: https://develop.svn.wordpress.org/trunk@25567 602fd350-edb4-49c9-b593-d223f7449a82