Add proper descriptions for the @global and @param tags in the wp_media_attach_action() DocBlock.

See [31619]. See #31888.


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

src/wp-admin/includes/media.php

@@ -3027,9 +3027,11 @@ function wp_read_audio_metadata( $file ) {
  *
  * @since 4.2.0
  *
- * @global wpdb $wpdb
- * @param int    $parent_id
- * @param string $action
+ * @global wpdb $wpdb WordPress database abstraction object.
+ *
+ * @param int    $parent_id Attachment parent ID.
+ * @param string $action    Optional. Attach/detach action. Accepts 'attach' or 'detach'.
+ *                          Default 'attach'.
  */
 function wp_media_attach_action( $parent_id, $action = 'attach' ) {
 	global $wpdb;