Ticket #50853: 50853.diff

src/wp-admin/includes/bookmark.php

@@ -142 +142 @@
 }
 
 /**
- * Inserts/updates links into/in the database.
+ * Inserts/updates links into/in the database. It runs all necessary sanitizing, provides default values if arguments are missing and finally saves the link.
  *
  * @since 2.0.0
  *
  * @global wpdb $wpdb WordPress database abstraction object.
  *
- * @param array $linkdata Elements that make up the link to insert.
+ * @param array $linkdata {
+ *     Elements that make up the link to insert.
+ *     
+ *     @type int $link_id    The ID of the existing link if updating.
+ *     @type varchar $link_url    The URL the link points to.
+ *     @type varchar $link_name    The title of the link.
+ *     @type varchar $link_image    A URL of an image.
+ *     @type varchar $link_target    The target element for the anchor tag.
+ *     @type varchar $link_description    A short description of the link.
+ *     @type varchar $link_visible    Y means visible, anything else means not.
+ *     @type int $link_owner    A user ID.
+ *     @type int $link_rating    A rating for the link.
+ *     @type datetime $link_updated    When the link was last updated.
+ *     @type varchar $link_rel    A relationship of the link to you.
+ *     @type text $link_notes    An extended description of or notes on the link.
+ *     @type varchar $link_rss    An URL of an associated RSS feed.
+ *     @type int $link_category    The term ID of the link category. If empty, uses default link.
+ * }
  * @param bool  $wp_error Optional. Whether to return a WP_Error object on failure. Default false.
  * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
  */