Improve documentation in wp-admin/admin-post.php

[ericlewis]

The description here is a bit vague, and the language is also specific to POST requests, where this is a general request handling file.

Also, I had never realized that WP has a built-in form handler file for this purpose, and actually thought this was a relic of bygone AJAX request handling from looking at it. We should probably add some documentation in the Codex for this somewhere.

[ericlewis]

attachment:25362.diff​ gives more detail in the file-level docblock.

[DrewAPicture]

Notes on 25362.diff​:

• No period in the file header short description
• Use camel-casing in the file header, so "WordPress Generic Request (POST/GET) Handler"

[ericlewis]

Replying to DrewAPicture:

• No period in the file header short description

Following-up to the ​IRC discussion, it actually looks like core is split pretty evenly in this regard - 276 of 544 PHP file headers have a period at the end of their short description.

Should we bring these inline to the new standard?

[ericlewis]

attachment:25362.1.diff​ adds CamelCasing to the file-level header and removes the trailing period

[DrewAPicture]

In 25561:

Improve file header and description in wp-admin/admin-post.php.

Props ericlewis.
Fixes #25362.

[bcworkz]

See new related Codex page: ​http://codex.wordpress.org/Plugin_API/Action_Reference/admin_post_%28action%29