Show
Ignore:
Timestamp:
08/27/08 06:45:13 (3 months ago)
Author:
westi
Message:

phpDoc corrections for wp-includes. See #7550 props santosj.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • trunk/wp-includes/deprecated.php

    r8543 r8742  
    11<?php 
    22/** 
    3  * Deprecated functions from past WordPress versions 
     3 * Deprecated functions from past WordPress versions. You shouldn't use these 
     4 * globals and functions and look for the alternatives instead. The functions 
     5 * and globals will be removed in a later version. 
     6 * 
    47 * @package WordPress 
    58 * @subpackage Deprecated 
     
    7780 
    7881/** 
    79  * get_postdata() - Entire Post data 
     82 * Entire Post data. 
    8083 * 
    8184 * @since 0.71 
     
    113116 
    114117/** 
    115  * start_wp() - Sets up the WordPress Loop 
     118 * Sets up the WordPress Loop. 
    116119 * 
    117120 * @since 1.0.1 
     
    130133 
    131134/** 
    132  * the_category_ID() - Return or Print Category ID 
     135 * Return or Print Category ID. 
    133136 * 
    134137 * @since 0.71 
     
    153156 
    154157/** 
    155  * the_category_head() - Print category with optional text before and after 
     158 * Print category with optional text before and after. 
    156159 * 
    157160 * @since 0.71 
     
    179182 
    180183/** 
    181  * previous_post() - Prints link to the previous post 
     184 * Prints link to the previous post. 
    182185 * 
    183186 * @since 1.5 
     
    215218 
    216219/** 
    217  * next_post() - Prints link to the next post 
     220 * Prints link to the next post. 
    218221 * 
    219222 * @since 0.71 
     
    250253 
    251254/** 
    252  * user_can_create_post() - Whether user can create a post 
     255 * Whether user can create a post. 
    253256 * 
    254257 * @since 1.5 
     
    269272 
    270273/** 
    271  * user_can_create_draft() - Whether user can create a post 
     274 * Whether user can create a post. 
    272275 * 
    273276 * @since 1.5 
     
    288291 
    289292/** 
    290  * user_can_edit_post() - Whether user can edit a post 
     293 * Whether user can edit a post. 
    291294 * 
    292295 * @since 1.5 
     
    316319 
    317320/** 
    318  * user_can_delete_post() - Whether user can delete a post 
     321 * Whether user can delete a post. 
    319322 * 
    320323 * @since 1.5 
     
    335338 
    336339/** 
    337  * user_can_set_post_date() - Whether user can set new posts' dates 
     340 * Whether user can set new posts' dates. 
    338341 * 
    339342 * @since 1.5 
     
    353356} 
    354357 
    355 /* returns true if $user_id can edit $post_id's date */ 
    356 /** 
    357  * user_can_edit_post_date() - Whether user can delete a post 
     358/** 
     359 * Whether user can delete a post. 
    358360 * 
    359361 * @since 1.5 
     
    364366 * @param int $post_id 
    365367 * @param int $blog_id Not Used 
    366  * @return bool 
     368 * @return bool returns true if $user_id can edit $post_id's date 
    367369 */ 
    368370function user_can_edit_post_date($user_id, $post_id, $blog_id = 1) { 
     
    373375} 
    374376 
    375 /* returns true if $user_id can edit $post_id's comments */ 
    376 /** 
    377  * user_can_edit_post_comments() - Whether user can delete a post 
     377/** 
     378 * Whether user can delete a post. 
    378379 * 
    379380 * @since 1.5 
     
    384385 * @param int $post_id 
    385386 * @param int $blog_id Not Used 
    386  * @return bool 
     387 * @return bool returns true if $user_id can edit $post_id's comments 
    387388 */ 
    388389function user_can_edit_post_comments($user_id, $post_id, $blog_id = 1) { 
     
    393394} 
    394395 
    395 /* returns true if $user_id can delete $post_id's comments */ 
    396 /** 
    397  * user_can_delete_post_comments() - Whether user can delete a post 
     396/** 
     397 * Whether user can delete a post. 
    398398 * 
    399399 * @since 1.5 
     
    404404 * @param int $post_id 
    405405 * @param int $blog_id Not Used 
    406  * @return bool 
     406 * @return bool returns true if $user_id can delete $post_id's comments 
    407407 */ 
    408408function user_can_delete_post_comments($user_id, $post_id, $blog_id = 1) { 
     
    414414 
    415415/** 
    416  * user_can_edit_user() - Can user can edit other user 
     416 * Can user can edit other user. 
    417417 * 
    418418 * @since 1.5 
     
    436436 
    437437/** 
    438  * get_linksbyname() - Gets the links associated with category $cat_name. 
     438 * Gets the links associated with category $cat_name. 
    439439 * 
    440440 * @since 0.71 
     
    442442 * @see get_links() 
    443443 * 
    444  * @param string   $cat_name   Optional. The category name to use. If no match is found uses all. 
    445  * @param string   $before     Optional. The html to output before the link. 
    446  * @param string   $after      Optional. The html to output after the link. 
    447  * @param string   $between    Optional. The html to output between the link/image and it's description. Not used if no image or $show_images is true. 
    448  * @param bool         $show_images Optional. Whether to show images (if defined). 
    449  * @param string   $orderby    Optional. The order to output the links. E.g. 'id', 'name', 'url', 'description' or 'rating'. Or maybe owner. 
     444 * @param string $cat_name Optional. The category name to use. If no match is found uses all. 
     445 * @param string $before Optional. The html to output before the link. 
     446 * @param string $after Optional. The html to output after the link. 
     447 * @param string $between Optional. The html to output between the link/image and it's description. Not used if no image or $show_images is true. 
     448 * @param bool $show_images Optional. Whether to show images (if defined). 
     449 * @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url', 'description' or 'rating'. Or maybe owner. 
    450450 *      If you start the name with an underscore the order will be reversed. You can also specify 'rand' as the order which will return links in a 
    451451 *      random order. 
    452  * @param bool         $show_description Optional. Whether to show the description if show_images=false/not defined. 
    453  * @param bool         $show_rating Optional. Show rating stars/chars. 
    454  * @param int      $limit     Optional. Limit to X entries. If not specified, all entries are shown. 
    455  * @param int      $show_updated Optional. Whether to show last updated timestamp 
     452 * @param bool $show_description Optional. Whether to show the description if show_images=false/not defined. 
     453 * @param bool $show_rating Optional. Show rating stars/chars. 
     454 * @param int $limit      Optional. Limit to X entries. If not specified, all entries are shown. 
     455 * @param int $show_updated Optional. Whether to show last updated timestamp 
    456456 */ 
    457457function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id', 
     
    469469 
    470470/** 
    471  * wp_get_linksbyname() - Gets the links associated with the named category. 
     471 * Gets the links associated with the named category. 
    472472 * 
    473473 * @since 1.0.1 
     
    492492 
    493493/** 
    494  * get_linkobjectsbyname() - Gets an array of link objects associated with category $cat_name. 
     494 * Gets an array of link objects associated with category $cat_name. 
    495495 * 
    496496 * <code> 
     
    524524 
    525525/** 
    526  * get_linkobjects() - Gets an array of link objects associated with category n. 
     526 * Gets an array of link objects associated with category n. 
    527527 * 
    528528 * Usage: 
     
    578578 
    579579/** 
    580  * get_linksbyname_withrating() - Gets the links associated with category 'cat_name' and display rating stars/chars. 
     580 * Gets the links associated with category 'cat_name' and display rating stars/chars. 
    581581 * 
    582582 * @since 0.71 
     
    605605 
    606606/** 
    607  * get_links_withrating() - Gets the links associated with category n and display rating stars/chars. 
     607 * Gets the links associated with category n and display rating stars/chars. 
    608608 * 
    609609 * @since 0.71 
     
    632632 
    633633/** 
    634  * get_autotoggle() - Gets the auto_toggle setting 
     634 * Gets the auto_toggle setting. 
    635635 * 
    636636 * @since 0.71 
     
    794794 
    795795/** 
    796  * wp_set_post_cats() - Sets the categories that the post id belongs to. 
     796 * Sets the categories that the post id belongs to. 
    797797 * 
    798798 * @since 1.0.1 
     
    830830 
    831831/** 
    832  * get_author_link() - Returns or Prints link to the author's posts 
     832 * Returns or Prints link to the author's posts. 
    833833 * 
    834834 * @since 1.2 
     
    852852 
    853853/** 
    854  * link_pages() - Print list of pages based on arguments 
     854 * Print list of pages based on arguments. 
    855855 * 
    856856 * @since 0.71 
     
    876876 
    877877/** 
    878  * get_settings() - Get value based on option 
     878 * Get value based on option. 
    879879 * 
    880880 * @since 0.71 
     
    892892 
    893893/** 
    894  * permalink_link() - Print the permalink of the current post in the loop 
     894 * Print the permalink of the current post in the loop. 
    895895 * 
    896896 * @since 0.71 
     
    904904 
    905905/** 
    906  * permalink_single_rss() - Print the permalink to the RSS feed 
     906 * Print the permalink to the RSS feed. 
    907907 * 
    908908 * @since 0.71 
     
    918918 
    919919/** 
    920  * wp_get_links() - Gets the links associated with category. 
     920 * Gets the links associated with category. 
    921921 * 
    922922 * @see get_links() for argument information that can be used in $args 
     
    952952 
    953953/** 
    954  * get_links() - Gets the links associated with category by id. 
     954 * Gets the links associated with category by id. 
    955955 * 
    956956 * @since 0.71 
     
    10571057 
    10581058/** 
    1059  * get_links_list() - Output entire list of links by category 
    1060  * 
    1061  * Output a list of all links, listed by category, using the 
    1062  * settings in $wpdb->linkcategories and output it as a nested 
    1063  * HTML unordered list. 
     1059 * Output entire list of links by category. 
     1060 * 
     1061 * Output a list of all links, listed by category, using the settings in 
     1062 * $wpdb->linkcategories and output it as a nested HTML unordered list. 
    10641063 * 
    10651064 * @author Dougal 
     
    11051104 
    11061105/** 
    1107  * links_popup_script() - Show the link to the links popup and the number of links 
     1106 * Show the link to the links popup and the number of links. 
    11081107 * 
    11091108 * @author Fullo 
     
    11491148 
    11501149/** 
    1151  * get_linkcatname() - Gets the name of category by id. 
     1150 * Gets the name of category by id. 
    11521151 * 
    11531152 * @since 0.71 
     
    11781177 
    11791178/** 
    1180  * comment_rss_link() - Print RSS comment feed link 
     1179 * Print RSS comment feed link. 
    11811180 * 
    11821181 * @since 1.0.1 
     
    11931192 
    11941193/** 
    1195  * get_category_rss_link() - Print/Return link to category RSS2 feed 
     1194 * Print/Return link to category RSS2 feed. 
    11961195 * 
    11971196 * @since 1.2 
     
    12151214 
    12161215/** 
    1217  * get_author_rss_link() - Print/Return link to author RSS feed 
     1216 * Print/Return link to author RSS feed. 
    12181217 * 
    12191218 * @since 1.2 
     
    12361235 
    12371236/** 
    1238  * comments_rss() - Return link to the post RSS feed 
     1237 * Return link to the post RSS feed. 
    12391238 * 
    12401239 * @since 1.5 
     
    12511250 
    12521251/** 
    1253  * create_user() - An alias of wp_create_user(). 
     1252 * An alias of wp_create_user(). 
     1253 * 
    12541254 * @param string $username The user's username. 
    12551255 * @param string $password The user's password. 
     
    12651265 
    12661266/** 
    1267  * documentation_link() - Unused Admin function 
     1267 * Unused Admin function. 
     1268 * 
    12681269 * @since 2.0 
    12691270 * @param string $deprecated Unknown 
     
    12761277 
    12771278/** 
    1278  * gzip_compression() - Unused function 
     1279 * Unused function. 
    12791280 * 
    12801281 * @deprecated 2.5 
    12811282*/ 
    1282  
    12831283function gzip_compression() { 
    12841284    return false;