Ticket #14783: since-tags.diff

File since-tags.diff, 9.8 KB (added by duck_, 3 years ago)

Alot of @since unkown

  • wp-admin/includes/bookmark.php

     
    77 */ 
    88 
    99/** 
    10  * {@internal Missing Short Description}} 
     10 * Add a link to using values provided in $_POST. 
    1111 * 
    12  * @since unknown 
     12 * @since 2.0.0 
    1313 * 
    14  * @return unknown 
     14 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success. 
    1515 */ 
    1616function add_link() { 
    1717        return edit_link(); 
    1818} 
    1919 
    2020/** 
    21  * {@internal Missing Short Description}} 
     21 * Update or insert a link using values provided in $_POST. 
    2222 * 
    23  * @since unknown 
     23 * @since 2.0.0 
    2424 * 
    25  * @param unknown_type $link_id 
    26  * @return unknown 
     25 * @param int $link_id Optional. ID of the link to edit. 
     26 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success. 
    2727 */ 
    28 function edit_link( $link_id = '' ) { 
    29         if (!current_user_can( 'manage_links' )) 
    30                 wp_die( __( 'Cheatin’ uh?' )); 
     28function edit_link( $link_id = 0 ) { 
     29        if ( !current_user_can( 'manage_links' ) ) 
     30                wp_die( __( 'Cheatin’ uh?' ) ); 
    3131 
    3232        $_POST['link_url'] = esc_html( $_POST['link_url'] ); 
    3333        $_POST['link_url'] = esc_url($_POST['link_url']); 
    … …  
    3939 
    4040        if ( !empty( $link_id ) ) { 
    4141                $_POST['link_id'] = $link_id; 
    42                 return wp_update_link( $_POST); 
     42                return wp_update_link( $_POST ); 
    4343        } else { 
    44                 return wp_insert_link( $_POST); 
     44                return wp_insert_link( $_POST ); 
    4545        } 
    4646} 
    4747 
    4848/** 
    49  * {@internal Missing Short Description}} 
     49 * Retrieve the default link for editing. 
    5050 * 
    51  * @since unknown 
     51 * @since 2.0.0 
    5252 * 
    53  * @return unknown 
     53 * @return object Default link 
    5454 */ 
    5555function get_default_link_to_edit() { 
    5656        if ( isset( $_GET['linkurl'] ) ) 
    57                 $link->link_url = esc_url( $_GET['linkurl']); 
     57                $link->link_url = esc_url( $_GET['linkurl'] ); 
    5858        else 
    5959                $link->link_url = ''; 
    6060 
    6161        if ( isset( $_GET['name'] ) ) 
    62                 $link->link_name = esc_attr( $_GET['name']); 
     62                $link->link_name = esc_attr( $_GET['name'] ); 
    6363        else 
    6464                $link->link_name = ''; 
    6565 
    … …  
    6969} 
    7070 
    7171/** 
    72  * {@internal Missing Short Description}} 
     72 * Delete link specified from database 
    7373 * 
    74  * @since unknown 
     74 * @since 2.0.0 
    7575 * 
    76  * @param unknown_type $link_id 
    77  * @return unknown 
     76 * @param int $link_id ID of the link to delete 
     77 * @return bool True 
    7878 */ 
    7979function wp_delete_link( $link_id ) { 
    8080        global $wpdb; 
    … …  
    9393} 
    9494 
    9595/** 
    96  * {@internal Missing Short Description}} 
     96 * Retrieves the link categories associated with the link specified. 
    9797 * 
    98  * @since unknown 
     98 * @since 2.1.0 
    9999 * 
    100  * @param unknown_type $link_id 
    101  * @return unknown 
     100 * @param int $link_id Link ID to look up 
     101 * @return array The requested link's categories 
    102102 */ 
    103103function wp_get_link_cats( $link_id = 0 ) { 
    104104 
    … …  
    108108} 
    109109 
    110110/** 
    111  * {@internal Missing Short Description}} 
     111 * Retrieve link data based on ID. 
    112112 * 
    113  * @since unknown 
     113 * @since 2.0.0 
    114114 * 
    115  * @param unknown_type $link_id 
    116  * @return unknown 
     115 * @param int $link_id ID of link to retrieve 
     116 * @return object Link for editing 
    117117 */ 
    118118function get_link_to_edit( $link_id ) { 
    119119        return get_bookmark( $link_id, OBJECT, 'edit' ); 
    120120} 
    121121 
    122122/** 
    123  * {@internal Missing Short Description}} 
     123 * This function inserts/updates links into/in the database.  
    124124 * 
    125  * @since unknown 
     125 * @since 2.0.0 
    126126 * 
    127  * @param unknown_type $linkdata 
    128  * @return unknown 
     127 * @param array $linkdata Elements that make up the link to insert. 
     128 * @param bool $wp_error Optional. If true return WP_Error object on failure. 
     129 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success. 
    129130 */ 
    130131function wp_insert_link( $linkdata, $wp_error = false ) { 
    131132        global $wpdb; 
    … …  
    181182                $link_rel = ''; 
    182183 
    183184        // Make sure we set a valid category 
    184         if ( ! isset( $link_category ) ||0 == count( $link_category ) || !is_array( $link_category ) ) { 
     185        if ( ! isset( $link_category ) || 0 == count( $link_category ) || !is_array( $link_category ) ) { 
    185186                $link_category = array( get_option( 'default_link_category' ) ); 
    186187        } 
    187188 
    … …  
    215216} 
    216217 
    217218/** 
    218  * {@internal Missing Short Description}} 
     219 * Update link with the specified link categories. 
    219220 * 
    220  * @since unknown 
     221 * @since 2.1.0 
    221222 * 
    222  * @param unknown_type $link_id 
    223  * @param unknown_type $link_categories 
     223 * @param int $link_id ID of link to update 
     224 * @param array $link_categories Array of categories to  
    224225 */ 
    225226function wp_set_link_cats( $link_id = 0, $link_categories = array() ) { 
    226227        // If $link_categories isn't already an array, make it one: 
    … …  
    233234        wp_set_object_terms( $link_id, $link_categories, 'link_category' ); 
    234235 
    235236        clean_bookmark_cache( $link_id ); 
    236 }       // wp_set_link_cats() 
     237} 
    237238 
    238239/** 
    239  * {@internal Missing Short Description}} 
     240 * Update a link in the database. 
    240241 * 
    241  * @since unknown 
     242 * @since 2.0.0 
    242243 * 
    243  * @param unknown_type $linkdata 
    244  * @return unknown 
     244 * @param array $linkdata Link data to update. 
     245 * @return int|WP_Error Value 0 or WP_Error on failure. The updated link ID on success. 
    245246 */ 
    246247function wp_update_link( $linkdata ) { 
    247248        $link_id = (int) $linkdata['link_id']; 

  • wp-admin/includes/comment.php

     
    99/** 
    1010 * {@internal Missing Short Description}} 
    1111 * 
    12  * @since unknown 
     12 * @since 2.0.0 
    1313 * @uses $wpdb 
    1414 * 
    15  * @param string $comment_author 
    16  * @param string $comment_date 
     15 * @param string $comment_author Author of the comment 
     16 * @param string $comment_date Date of the comment 
    1717 * @return mixed Comment ID on success. 
    1818 */ 
    1919function comment_exists($comment_author, $comment_date) { 
    … …  
    2727} 
    2828 
    2929/** 
    30  * {@internal Missing Short Description}} 
     30 * Update a comment with values provided in $_POST. 
    3131 * 
    32  * @since unknown 
     32 * @since 2.0.0 
    3333 */ 
    3434function edit_comment() { 
    35  
    3635        $comment_post_ID = (int) $_POST['comment_post_ID']; 
    3736 
    3837        if (!current_user_can( 'edit_post', $comment_post_ID )) 
    39                 wp_die( __('You are not allowed to edit comments on this post, so you cannot edit this comment.' )); 
     38                wp_die( __('You are not allowed to edit comments on this post, so you cannot edit this comment.' ) ); 
    4039 
    4140        $_POST['comment_author'] = $_POST['newcomment_author']; 
    4241        $_POST['comment_author_email'] = $_POST['newcomment_author_email']; 
    … …  
    5251                } 
    5352        } 
    5453 
    55         if (!empty ( $_POST['edit_date'] ) ) { 
     54        if ( !empty ( $_POST['edit_date'] ) ) { 
    5655                $aa = $_POST['aa']; 
    5756                $mm = $_POST['mm']; 
    5857                $jj = $_POST['jj']; 
    … …  
    6665                $_POST['comment_date'] = "$aa-$mm-$jj $hh:$mn:$ss"; 
    6766        } 
    6867 
    69         wp_update_comment( $_POST); 
     68        wp_update_comment( $_POST ); 
    7069} 
    7170 
    7271/** 
    7372 * {@internal Missing Short Description}} 
    7473 * 
    75  * @since unknown 
     74 * @since 2.0.0 
    7675 * 
    77  * @param unknown_type $id 
    78  * @return unknown 
     76 * @param int $id ID of comment to retrieve 
     77 * @return bool|object Comment if found. False on failure. 
    7978 */ 
    8079function get_comment_to_edit( $id ) { 
    8180        if ( !$comment = get_comment($id) ) 
    … …  
    9897/** 
    9998 * Get the number of pending comments on a post or posts 
    10099 * 
    101  * @since unknown 
     100 * @since 2.3.0 
    102101 * @uses $wpdb 
    103102 * 
    104103 * @param int|array $post_id Either a single Post ID or an array of Post IDs 

  • wp-admin/includes/dashboard.php

     
    99/** 
    1010 * Registers dashboard widgets. 
    1111 * 
    12  * handles POST data, sets up filters. 
     12 * Handles POST data, sets up filters. 
    1313 * 
    14  * @since unknown 
     14 * @since 2.5.0 
    1515 */ 
    1616function wp_dashboard_setup() { 
    1717        global $wp_registered_widgets, $wp_registered_widget_controls, $wp_dashboard_control_callbacks; 
    … …  
    150150/** 
    151151 * Displays the dashboard. 
    152152 * 
    153  * @since unknown 
     153 * @since 2.5.0 
    154154 */ 
    155155function wp_dashboard() { 
    156156        global $screen_layout_columns; 
    … …  
    517517/** 
    518518 * Display recent comments dashboard widget content. 
    519519 * 
    520  * @since unknown 
     520 * @since 2.5.0 
    521521 */ 
    522522function wp_dashboard_recent_comments() { 
    523523        global $wpdb; 
    … …  
    703703/** 
    704704 * Display incoming links dashboard widget content. 
    705705 * 
    706  * @since unknown 
     706 * @since 2.5.0 
    707707 */ 
    708708function wp_dashboard_incoming_links_output() { 
    709709        $widgets = get_option( 'dashboard_widget_options' ); 
    … …  
    795795/** 
    796796 * {@internal Missing Short Description}} 
    797797 * 
    798  * @since unknown 
     798 * @since 2.5.0 
    799799 * 
    800  * @param int $widget_id 
     800 * @param string $widget_id 
    801801 */ 
    802802function wp_dashboard_rss_output( $widget_id ) { 
    803803        $widgets = get_option( 'dashboard_widget_options' ); 
    … …  
    817817/** 
    818818 * Display secondary dashboard RSS widget feed. 
    819819 * 
    820  * @since unknown 
     820 * @since 2.5.0 
    821821 * 
    822822 * @return unknown 
    823823 */ 
    … …  
    852852/** 
    853853 * Display plugins most popular, newest plugins, and recently updated widget text. 
    854854 * 
    855  * @since unknown 
     855 * @since 2.5.0 
    856856 */ 
    857857function wp_dashboard_plugins_output() { 
    858858        $popular = fetch_feed( 'http://wordpress.org/extend/plugins/rss/browse/popular/' ); 
    … …  
    938938 * echoes out output for this widget. If not cache, echo a "Loading..." stub 
    939939 * which is later replaced by AJAX call (see top of /wp-admin/index.php) 
    940940 * 
    941  * @since unknown 
     941 * @since 2.5.0 
    942942 * 
    943  * @param int $widget_id 
     943 * @param string $widget_id 
    944944 * @param callback $callback 
    945945 * @param array $check_urls RSS feeds 
    946946 * @return bool False on failure. True on success. 
    … …  
    981981/** 
    982982 * Calls widget control callback. 
    983983 * 
    984  * @since unknown 
     984 * @since 2.5.0 
    985985 * 
    986986 * @param int $widget_control_id Registered Widget ID. 
    987987 */ 
    … …  
    999999 * Sets up $args to be used as input to wp_widget_rss_form(). Handles POST data 
    10001000 * from RSS-type widgets. 
    10011001 * 
    1002  * @since unknown 
     1002 * @since 2.5.0 
    10031003 * 
    1004  * @param string widget_id 
    1005  * @param array form_inputs 
     1004 * @param string $widget_id 
     1005 * @param array $form_inputs 
    10061006 */ 
    10071007function wp_dashboard_rss_control( $widget_id, $form_inputs = array() ) { 
    10081008        if ( !$widget_options = get_option( 'dashboard_widget_options' ) )