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

See [31619]. See #31888.

Built from https://develop.svn.wordpress.org/trunk@32018


git-svn-id: http://core.svn.wordpress.org/trunk@31997 1a063a9b-81f0-0310-95a4-ce76da25c4cd

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;