Update since phpdoc. Props demetris. fixes #15445

git-svn-id: http://svn.automattic.com/wordpress/trunk@16660 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
ryan 2010-12-01 19:24:38 +00:00
parent e999b49423
commit 3f72e340d6
22 changed files with 185 additions and 157 deletions

View File

@ -19,7 +19,7 @@ class Custom_Background {
* Callback for administration header.
*
* @var callback
* @since unknown
* @since 3.0.0
* @access private
*/
var $admin_header_callback;

View File

@ -411,7 +411,7 @@ class WP_Posts_List_Table extends WP_List_Table {
* Given a top level page ID, display the nested hierarchy of sub-pages
* together with paging support
*
* @since unknown
* @since 3.1.0 (Standalone function exists since 2.6.0)
*
* @param unknown_type $children_pages
* @param unknown_type $count

View File

@ -9,7 +9,7 @@
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @return unknown
*/
@ -27,7 +27,7 @@ function media_upload_tabs() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param unknown_type $tabs
* @return unknown
@ -59,7 +59,7 @@ add_filter('media_upload_tabs', 'update_gallery_tab');
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*/
function the_media_upload_tabs() {
global $redir_tab;
@ -89,7 +89,7 @@ function the_media_upload_tabs() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param unknown_type $id
* @param unknown_type $alt
@ -117,7 +117,7 @@ function get_image_send_to_editor($id, $caption, $title, $align, $url='', $rel =
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.6.0
*
* @param unknown_type $html
* @param unknown_type $id
@ -159,7 +159,7 @@ add_filter( 'image_send_to_editor', 'image_add_caption', 20, 8 );
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param unknown_type $html
*/
@ -180,7 +180,7 @@ win.send_to_editor('<?php echo addslashes($html); ?>');
*
* This handles the file upload POST itself, creating the attachment post.
*
* @since unknown
* @since 2.5.0
*
* @param string $file_id Index into the {@link $_FILES} array of the upload
* @param int $post_id The post ID the media is associated with
@ -241,7 +241,7 @@ function media_handle_upload($file_id, $post_id, $post_data = array(), $override
/**
* This handles a sideloaded file in the same way as an uploaded file is handled by {@link media_handle_upload()}
*
* @since 2.6
* @since 2.6.0
*
* @param array $file_array Array similar to a {@link $_FILES} upload array
* @param int $post_id The post ID the media is associated with
@ -295,7 +295,7 @@ function media_handle_sideload($file_array, $post_id, $desc = null, $post_data =
* Wrap iframe content (produced by $content_func) in a doctype, html head/body
* etc any additional function args will be passed to content_func.
*
* @since unknown
* @since 2.5.0
*
* @param unknown_type $content_func
*/
@ -401,7 +401,7 @@ function get_upload_iframe_src($type) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @return unknown
*/
@ -488,7 +488,7 @@ function media_upload_form_handler() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @return unknown
*/
@ -547,7 +547,7 @@ function media_upload_image() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.6.0
*
* @param unknown_type $file
* @param unknown_type $post_id
@ -593,7 +593,7 @@ function media_sideload_image($file, $post_id, $desc = null) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @return unknown
*/
@ -651,7 +651,7 @@ function media_upload_audio() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @return unknown
*/
@ -709,7 +709,7 @@ function media_upload_video() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @return unknown
*/
@ -764,7 +764,7 @@ function media_upload_file() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @return unknown
*/
@ -787,7 +787,7 @@ function media_upload_gallery() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @return unknown
*/
@ -808,7 +808,7 @@ function media_upload_library() {
/**
* Retrieve HTML for the image alignment radio buttons with the specified one checked.
*
* @since unknown
* @since 2.7.0
*
* @param unknown_type $post
* @param unknown_type $checked
@ -836,7 +836,7 @@ function image_align_input_fields( $post, $checked = '' ) {
/**
* Retrieve HTML for the size radio buttons with the specified one checked.
*
* @since unknown
* @since 2.7.0
*
* @param unknown_type $post
* @param unknown_type $check
@ -891,7 +891,7 @@ function image_size_input_fields( $post, $check = '' ) {
/**
* Retrieve HTML for the Link URL buttons with the default link type as specified.
*
* @since unknown
* @since 2.7.0
*
* @param unknown_type $post
* @param unknown_type $url_type
@ -922,7 +922,7 @@ function image_link_input_fields($post, $url_type = '') {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param unknown_type $form_fields
* @param unknown_type $post
@ -961,7 +961,7 @@ add_filter('attachment_fields_to_edit', 'image_attachment_fields_to_edit', 10, 2
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param unknown_type $form_fields
* @param unknown_type $post
@ -972,6 +972,15 @@ function media_single_attachment_fields_to_edit( $form_fields, $post ) {
return $form_fields;
}
/**
* {@internal Missing Short Description}}
*
* @since 2.8.0
*
* @param unknown_type $form_fields
* @param unknown_type $post
* @return unknown
*/
function media_post_single_attachment_fields_to_edit( $form_fields, $post ) {
unset($form_fields['image_url']);
return $form_fields;
@ -980,7 +989,7 @@ function media_post_single_attachment_fields_to_edit( $form_fields, $post ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param unknown_type $post
* @param unknown_type $attachment
@ -1002,7 +1011,7 @@ add_filter('attachment_fields_to_save', 'image_attachment_fields_to_save', 10, 2
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param unknown_type $html
* @param unknown_type $attachment_id
@ -1029,7 +1038,7 @@ add_filter('media_send_to_editor', 'image_media_send_to_editor', 10, 3);
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param unknown_type $post
* @param unknown_type $errors
@ -1119,7 +1128,7 @@ function get_attachment_fields_to_edit($post, $errors = null) {
* component. Will also create link for showing and hiding the form to modify
* the image attachment.
*
* @since unknown
* @since 2.5.0
*
* @param int $post_id Optional. Post ID.
* @param array $errors Errors for attachment, if any.
@ -1153,7 +1162,7 @@ function get_media_items( $post_id, $errors ) {
/**
* Retrieve HTML form for modifying the image attachment.
*
* @since unknown
* @since 2.5.0
*
* @param int $attachment_id Attachment ID for modification.
* @param string|array $args Optional. Override defaults.
@ -1376,7 +1385,7 @@ function get_media_item( $attachment_id, $args = null ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*/
function media_upload_header() {
?>
@ -1390,7 +1399,7 @@ function media_upload_header() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param unknown_type $errors
*/
@ -1545,7 +1554,7 @@ SWFUpload.onload = function() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param unknown_type $type
* @param unknown_type $errors
@ -1603,7 +1612,7 @@ if ( $id ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.7.0
*
* @param unknown_type $type
* @param unknown_type $errors
@ -1721,7 +1730,7 @@ var addExtImage = {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param unknown_type $errors
*/
@ -1863,7 +1872,7 @@ jQuery(function($){
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param unknown_type $errors
*/
@ -2025,7 +2034,7 @@ jQuery(function($){
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.7.0
*
* @return unknown
*/
@ -2107,7 +2116,7 @@ function type_url_form_image() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.7.0
*
* @return unknown
*/
@ -2137,7 +2146,7 @@ function type_url_form_audio() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.7.0
*
* @return unknown
*/
@ -2167,7 +2176,7 @@ function type_url_form_video() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.7.0
*
* @return unknown
*/
@ -2224,7 +2233,7 @@ function _insert_into_post_button($type) {
*
* Support a GET parameter for disabling the flash uploader.
*
* @since unknown
* @since 2.6.0
*
* @param unknown_type $flash
* @return unknown
@ -2240,7 +2249,7 @@ add_filter('flash_uploader', 'media_upload_use_flash');
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.6.0
*/
function media_upload_flash_bypass() {
echo '<p class="upload-flash-bypass">';
@ -2251,7 +2260,7 @@ function media_upload_flash_bypass() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.6.0
*/
function media_upload_html_bypass($flash = true) {
echo '<p class="upload-html-bypass hide-if-no-js">';
@ -2272,7 +2281,7 @@ add_action('post-html-upload-ui', 'media_upload_html_bypass');
*
* Make sure the GET parameter sticks when we submit a form.
*
* @since unknown
* @since 2.6.0
*
* @param unknown_type $url
* @return unknown

View File

@ -9,7 +9,7 @@
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.0.0
*
* @return unknown
*/
@ -21,7 +21,7 @@ function got_mod_rewrite() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 1.5.0
*
* @param unknown_type $filename
* @param unknown_type $marker
@ -57,7 +57,7 @@ function extract_from_markers( $filename, $marker ) {
* BEGIN and END markers. Replaces existing marked info. Retains surrounding
* data. Creates file if none exists.
*
* @since unknown
* @since 1.5.0
*
* @param unknown_type $filename
* @param unknown_type $marker
@ -117,7 +117,7 @@ function insert_with_markers( $filename, $marker, $insertion ) {
* Always writes to the file if it exists and is writable to ensure that we
* blank out old rules.
*
* @since unknown
* @since 1.5.0
*/
function save_mod_rewrite_rules() {
if ( is_multisite() )
@ -169,7 +169,7 @@ function iis7_save_url_rewrite_rules(){
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 1.5.0
*
* @param unknown_type $file
*/
@ -191,7 +191,7 @@ function update_recently_edited( $file ) {
/**
* If siteurl or home changed, flush rewrite rules.
*
* @since unknown
* @since 2.1.0
*
* @param unknown_type $old_value
* @param unknown_type $value
@ -234,7 +234,7 @@ function url_shorten( $url ) {
* in the $vars array to the value of $_POST[$var] or $_GET[$var] or ''
* if neither is defined.
*
* @since unknown
* @since 2.0.0
*
* @param array $vars An array of globals to reset.
*/
@ -257,7 +257,7 @@ function wp_reset_vars( $vars ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.1.0
*
* @param unknown_type $message
*/

View File

@ -198,7 +198,7 @@ function get_plugin_files($plugin) {
* be split for maintainability. Keep everything in one file for extreme
* optimization purposes.
*
* @since unknown
* @since 1.5.0
*
* @param string $plugin_folder Optional. Relative path to single plugin folder.
* @return array Key is the plugin file path and the value is an array of the plugin data.
@ -481,7 +481,7 @@ function is_network_only_plugin( $plugin ) {
* If any errors are found or text is outputted, then it will be captured to
* ensure that the success redirection will update the error redirection.
*
* @since unknown
* @since 2.5.0
*
* @param string $plugin Plugin path to main plugin file with plugin data.
* @param string $redirect Optional. URL to redirect to.
@ -544,7 +544,7 @@ function activate_plugin( $plugin, $redirect = '', $network_wide = false, $silen
* The deactivation hook is disabled by the plugin upgrader by using the $silent
* parameter.
*
* @since unknown
* @since 2.5.0
*
* @param string|array $plugins Single plugin or list of plugins to deactivate.
* @param bool $silent Prevent calling deactivation hooks. Default is false.
@ -596,7 +596,7 @@ function deactivate_plugins( $plugins, $silent = false ) {
*
* The execution will be halted as soon as one of the plugins has an error.
*
* @since unknown
* @since 2.6.0
*
* @param string|array $plugins
* @param string $redirect Redirect to page after successful activation.
@ -629,7 +629,7 @@ function activate_plugins( $plugins, $redirect = '', $network_wide = false, $sil
* If the plugins parameter list is empty, false will be returned. True when
* completed.
*
* @since unknown
* @since 2.6.0
*
* @param array $plugins List of plugin
* @param string $redirect Redirect to page when complete.
@ -721,7 +721,7 @@ function delete_plugins($plugins, $redirect = '' ) {
* Validate all active plugins, deactivates invalid and
* returns an array of deactivated ones.
*
* @since unknown
* @since 2.5.0
* @return array invalid plugins, plugin as key, error as value
*/
function validate_active_plugins() {
@ -758,7 +758,7 @@ function validate_active_plugins() {
*
* Checks that the file exists and {@link validate_file() is valid file}.
*
* @since unknown
* @since 2.5.0
*
* @param string $plugin Plugin Path
* @return WP_Error|int 0 on success, WP_Error on failure.
@ -1597,7 +1597,7 @@ function unregister_setting( $option_group, $option_name, $sanitize_callback = '
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.7.0
*
* @param unknown_type $options
* @return unknown
@ -1615,7 +1615,7 @@ add_filter( 'whitelist_options', 'option_update_filter' );
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.7.0
*
* @param unknown_type $new_options
* @param unknown_type $options
@ -1646,7 +1646,7 @@ function add_option_whitelist( $new_options, $options = '' ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.7.0
*
* @param unknown_type $del_options
* @param unknown_type $options

View File

@ -125,7 +125,7 @@ function _wp_translate_postdata( $update = false, $post_data = null ) {
/**
* Update an existing post with values provided in $_POST.
*
* @since unknown
* @since 1.5.0
*
* @param array $post_data Optional.
* @return int Post ID.
@ -434,7 +434,7 @@ function get_default_page_to_edit() {
/**
* Get an existing post and format it for editing.
*
* @since unknown
* @since 2.0.0
*
* @param unknown_type $id
* @return unknown
@ -452,7 +452,7 @@ function get_post_to_edit( $id ) {
/**
* Determine if a post exists based on title, content, and date
*
* @since unknown
* @since 2.0.0
*
* @param string $title Post title
* @param string $content Optional post content
@ -493,7 +493,7 @@ function post_exists($title, $content = '', $date = '') {
/**
* Creates a new post from the "Write Post" form using $_POST information.
*
* @since unknown
* @since 2.1.0
*
* @return unknown
*/
@ -590,7 +590,7 @@ function wp_write_post() {
/**
* Calls wp_write_post() and handles the errors.
*
* @since unknown
* @since 2.0.0
*
* @return unknown
*/
@ -609,7 +609,7 @@ function write_post() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 1.2.0
*
* @param unknown_type $post_ID
* @return unknown
@ -652,7 +652,7 @@ function add_meta( $post_ID ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 1.2.0
*
* @param unknown_type $mid
* @return unknown
@ -674,7 +674,7 @@ function delete_meta( $mid ) {
/**
* Get a list of previously defined keys.
*
* @since unknown
* @since 1.2.0
*
* @return unknown
*/
@ -693,7 +693,7 @@ function get_meta_keys() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.1.0
*
* @param unknown_type $mid
* @return unknown
@ -713,7 +713,7 @@ function get_post_meta_by_id( $mid ) {
*
* Some postmeta stuff.
*
* @since unknown
* @since 1.2.0
*
* @param unknown_type $postid
* @return unknown
@ -730,7 +730,7 @@ function has_meta( $postid ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 1.2.0
*
* @param unknown_type $meta_id
* @param unknown_type $meta_key Expect Slashed
@ -773,7 +773,7 @@ function update_meta( $meta_id, $meta_key, $meta_value ) {
/**
* Replace hrefs of attachment anchors with up-to-date permalinks.
*
* @since unknown
* @since 2.3.0
* @access private
*
* @param unknown_type $post_ID
@ -829,7 +829,7 @@ function _fix_attachment_links_replace_cb($match) {
/**
* Move child posts to a new parent.
*
* @since unknown
* @since 2.3.0
* @access private
*
* @param unknown_type $old_ID
@ -950,7 +950,7 @@ function get_post_mime_types() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param unknown_type $type
* @return unknown
@ -965,7 +965,7 @@ function get_available_post_mime_types($type = 'attachment') {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param unknown_type $q
* @return unknown
@ -1008,7 +1008,7 @@ function _edit_attachments_query_helper($where) {
* {@internal Missing Short Description}}
*
* @uses get_user_option()
* @since unknown
* @since 2.5.0
*
* @param unknown_type $id
* @param unknown_type $page
@ -1031,7 +1031,7 @@ function postbox_classes( $id, $page ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param int|object $id Post ID or post object.
* @param string $title (optional) Title
@ -1095,7 +1095,7 @@ function get_sample_permalink($id, $title = null, $name = null) {
*
* intended to be used for the inplace editor of the permalink post slug on in the post (and page?) editor.
*
* @since unknown
* @since 2.5.0
*
* @param int|object $id Post ID or post object.
* @param string $new_title (optional) New title

View File

@ -13,7 +13,7 @@
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.0.0
*
* @param unknown_type $cat_name
* @return unknown
@ -28,7 +28,7 @@ function category_exists($cat_name, $parent = 0) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.0.0
*
* @param unknown_type $id
* @return unknown
@ -41,7 +41,7 @@ function get_category_to_edit( $id ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.0.0
*
* @param unknown_type $cat_name
* @param unknown_type $parent
@ -57,7 +57,7 @@ function wp_create_category( $cat_name, $parent = 0 ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.0.0
*
* @param unknown_type $categories
* @param unknown_type $post_id
@ -173,7 +173,7 @@ function wp_update_category($catarr) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.3.0
*
* @param unknown_type $tag_name
* @return unknown
@ -185,7 +185,7 @@ function tag_exists($tag_name) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.3.0
*
* @param unknown_type $tag_name
* @return unknown
@ -239,7 +239,7 @@ function get_terms_to_edit( $post_id, $taxonomy = 'post_tag' ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.8.0
*
* @param unknown_type $tag_name
* @return unknown

View File

@ -16,7 +16,7 @@
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.1
*/
class Walker_Category_Checklist extends Walker {
var $tree_type = 'category';
@ -54,7 +54,7 @@ class Walker_Category_Checklist extends Walker {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.1
*
* @param unknown_type $post_id
* @param unknown_type $descendants_and_self
@ -76,6 +76,8 @@ function wp_category_checklist( $post_id = 0, $descendants_and_self = 0, $select
/**
* Taxonomy independent version of wp_category_checklist
*
* @since 3.0.0
*
* @param int $post_id
* @param array $args
*/
@ -142,7 +144,7 @@ function wp_terms_checklist($post_id = 0, $args = array()) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param unknown_type $taxonomy
* @param unknown_type $default
@ -190,7 +192,7 @@ function wp_popular_terms_checklist( $taxonomy, $default = 0, $number = 10, $ech
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.1
*
* @param unknown_type $link_id
*/
@ -259,7 +261,7 @@ function get_hidden_columns( $screen ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.7.0
*
* @param unknown_type $post
*/
@ -314,7 +316,7 @@ function get_inline_data($post) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.7.0
*
* @param unknown_type $position
* @param unknown_type $checkbox
@ -408,7 +410,7 @@ function wp_comment_trashnotice() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 1.2.0
*
* @param unknown_type $meta
*/
@ -451,7 +453,7 @@ function list_meta( $meta ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param unknown_type $entry
* @param unknown_type $count
@ -506,7 +508,7 @@ function _list_meta_row( $entry, &$count ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 1.2.0
*/
function meta_form() {
global $wpdb;
@ -567,7 +569,7 @@ function meta_form() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 0.71
*
* @param unknown_type $edit
* @param unknown_type $for_post
@ -641,7 +643,7 @@ function touch_time( $edit = 1, $for_post = 1, $tab_index = 0, $multi = 0 ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 1.5.0
*
* @param unknown_type $default
*/
@ -660,7 +662,7 @@ function page_template_dropdown( $default = '' ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 1.5.0
*
* @param unknown_type $default
* @param unknown_type $parent
@ -696,7 +698,7 @@ function parent_dropdown( $default = 0, $parent = 0, $level = 0 ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.0.0
*
* @param unknown_type $id
* @return unknown
@ -748,7 +750,7 @@ function the_attachment_links( $id = false ) {
/**
* Print out <option> html elements for role selectors
*
* @since 2.1
* @since 2.1.0
*
* @param string $selected slug for the role that should be already selected
*/
@ -771,7 +773,7 @@ function wp_dropdown_roles( $selected = false ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.3.0
*
* @param unknown_type $size
* @return unknown
@ -791,7 +793,7 @@ function wp_convert_hr_to_bytes( $size ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.3.0
*
* @param unknown_type $bytes
* @return unknown
@ -807,7 +809,7 @@ function wp_convert_bytes_to_hr( $bytes ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @return unknown
*/
@ -821,7 +823,7 @@ function wp_max_upload_size() {
/**
* Outputs the form used by the importers to accept the data to be imported
*
* @since 2.0
* @since 2.0.0
*
* @param string $action The action attribute for the form.
*/
@ -994,7 +996,7 @@ function remove_meta_box($id, $page, $context) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.7.0
*
* @param unknown_type $screen
*/
@ -1029,7 +1031,7 @@ function meta_box_prefs($screen) {
/**
* Get Hidden Meta Boxes
*
* @since 2.7
* @since 2.7.0
*
* @param string|object $screen Screen identifier
* @return array Hidden Meta Boxes
@ -1139,7 +1141,7 @@ function add_settings_field($id, $title, $callback, $page, $section = 'default',
*
* @global $wp_settings_sections Storage array of all settings sections added to admin pages
* @global $wp_settings_fields Storage array of settings fields and info about their pages/sections
* @since unknown
* @since 2.7.0
*
* @param string $page The slug name of the page whos settings sections you want to output
*/
@ -1169,7 +1171,7 @@ function do_settings_sections($page) {
*
* @global $wp_settings_fields Storage array of settings fields and their pages/sections
*
* @since unknown
* @since 2.7.0
*
* @param string $page Slug title of the admin page who's settings fields you want to show.
* @param section $section Slug title of the settings section who's fields you want to show.
@ -1206,6 +1208,8 @@ function do_settings_fields($page, $section) {
* Additional calls to settings_errors() can be used to show errors even when the settings
* page is first accessed.
*
* @since 3.0.0
*
* @global array $wp_settings_errors Storage array of errors registered during this pageload
*
* @param string $setting Slug title of the setting to which this error applies
@ -1242,6 +1246,8 @@ function add_settings_error( $setting, $code, $message, $type = 'error' ) {
* This is useful if you have errors or notices you want to show even when the user
* hasn't submitted data (i.e. when they first load an options page, or in admin_notices action hook)
*
* @since 3.0.0
*
* @global array $wp_settings_errors Storage array of errors registered during this pageload
*
* @param string $setting Optional slug title of a specific setting who's errors you want.
@ -1294,6 +1300,8 @@ function get_settings_errors( $setting = '', $sanitize = FALSE ) {
* shown in the default error reporting after submission. This is useful to show general errors like missing
* settings when the user arrives at the settings page.
*
* @since 3.0.0
*
* @param string $setting Optional slug title of a specific setting who's errors you want.
* @param boolean $sanitize Whether to re-sanitize the setting value before returning errors.
* @param boolean $hide_on_update If set to true errors will not be shown if the settings page has already been submitted.
@ -1320,7 +1328,7 @@ function settings_errors( $setting = '', $sanitize = FALSE, $hide_on_update = FA
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.7.0
*
* @param unknown_type $found_action
*/
@ -1378,7 +1386,7 @@ function the_post_password() {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.7.0
*/
function favorite_actions( $screen = null ) {
$default_action = false;

View File

@ -9,7 +9,7 @@
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.0.0
*
* @return unknown
*/
@ -106,7 +106,7 @@ function delete_theme($template) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 1.5.0
*
* @return unknown
*/
@ -159,7 +159,7 @@ function get_allowed_themes() {
/**
* Get the Page Templates available in this theme
*
* @since unknown
* @since 1.5.0
*
* @return array Key is template name, Value is template name
*/

View File

@ -24,7 +24,7 @@ if ( !function_exists('wp_install') ) :
*
* {@internal Missing Long Description}}
*
* @since unknown
* @since 2.1.0
*
* @param string $blog_title Blog title.
* @param string $user_name User's username.
@ -98,7 +98,7 @@ if ( !function_exists('wp_install_defaults') ) :
*
* {@internal Missing Long Description}}
*
* @since unknown
* @since 2.1.0
*
* @param int $user_id User ID.
*/
@ -300,7 +300,7 @@ if ( !function_exists('wp_new_blog_notification') ) :
*
* {@internal Missing Long Description}}
*
* @since unknown
* @since 2.1.0
*
* @param string $blog_title Blog title.
* @param string $blog_url Blog url.
@ -336,7 +336,7 @@ if ( !function_exists('wp_upgrade') ) :
*
* {@internal Missing Long Description}}
*
* @since unknown
* @since 2.1.0
*
* @return null
*/
@ -375,7 +375,7 @@ endif;
*
* {@internal Missing Long Description}}
*
* @since unknown
* @since 1.0.1
*/
function upgrade_all() {
global $wp_current_db_version, $wp_db_version, $wp_rewrite;
@ -1187,7 +1187,7 @@ function upgrade_network() {
*
* {@internal Missing Long Description}}
*
* @since unknown
* @since 1.0.0
*
* @param string $table_name Database table name to create.
* @param string $create_ddl SQL statement to create table.
@ -1210,7 +1210,7 @@ function maybe_create_table($table_name, $create_ddl) {
*
* {@internal Missing Long Description}}
*
* @since unknown
* @since 1.0.1
*
* @param string $table Database table name.
* @param string $index Index name to drop.
@ -1233,7 +1233,7 @@ function drop_index($table, $index) {
*
* {@internal Missing Long Description}}
*
* @since unknown
* @since 1.0.1
*
* @param string $table Database table name.
* @param string $index Database table index column.
@ -1296,7 +1296,7 @@ function get_alloptions_110() {
/**
* Version of get_option that is private to install/upgrade.
*
* @since unknown
* @since 1.5.1
* @access private
*
* @param string $setting Option name.
@ -1333,7 +1333,7 @@ function __get_option($setting) {
*
* {@internal Missing Long Description}}
*
* @since unknown
* @since 1.5.0
*
* @param string $content
* @return string
@ -1360,7 +1360,7 @@ function deslash($content) {
*
* {@internal Missing Long Description}}
*
* @since unknown
* @since 1.5.0
*
* @param unknown_type $queries
* @param unknown_type $execute
@ -1567,7 +1567,7 @@ function dbDelta($queries, $execute = true) {
*
* {@internal Missing Long Description}}
*
* @since unknown
* @since 1.5.0
*/
function make_db_current() {
global $wp_queries;
@ -1583,7 +1583,7 @@ function make_db_current() {
*
* {@internal Missing Long Description}}
*
* @since unknown
* @since 1.5.0
*/
function make_db_current_silent() {
global $wp_queries;
@ -1596,7 +1596,7 @@ function make_db_current_silent() {
*
* {@internal Missing Long Description}}
*
* @since unknown
* @since 1.5.0
*
* @param unknown_type $theme_name
* @param unknown_type $template
@ -1675,7 +1675,7 @@ function make_site_theme_from_oldschool($theme_name, $template) {
*
* {@internal Missing Long Description}}
*
* @since unknown
* @since 1.5.0
*
* @param unknown_type $theme_name
* @param unknown_type $template
@ -1741,7 +1741,7 @@ function make_site_theme_from_default($theme_name, $template) {
*
* {@internal Missing Long Description}}
*
* @since unknown
* @since 1.5.0
*
* @return unknown
*/
@ -1789,7 +1789,7 @@ function make_site_theme() {
/**
* Translate user level to user role name.
*
* @since unknown
* @since 2.0.0
*
* @param int $level User level.
* @return string User role name.
@ -1820,7 +1820,7 @@ function translate_level_to_role($level) {
*
* {@internal Missing Long Description}}
*
* @since unknown
* @since 2.1.0
*/
function wp_check_mysql_version() {
global $wpdb;
@ -1834,7 +1834,7 @@ function wp_check_mysql_version() {
*
* {@internal Missing Long Description}}
*
* @since unknown
* @since 2.2.0
*/
function maybe_disable_automattic_widgets() {
$plugins = __get_option( 'active_plugins' );
@ -1850,6 +1850,8 @@ function maybe_disable_automattic_widgets() {
/**
* Runs before the schema is upgraded.
*
* @since 2.9.0
*/
function pre_schema_upgrade() {
global $wp_current_db_version, $wp_db_version, $wpdb;

View File

@ -216,7 +216,7 @@ function get_editable_roles() {
/**
* Retrieve user data and filter it.
*
* @since unknown
* @since 2.0.5
*
* @param int $user_id User ID.
* @return object WP_User object with user data.
@ -241,7 +241,7 @@ function get_user_to_edit( $user_id ) {
/**
* Retrieve the user's drafts.
*
* @since unknown
* @since 2.0.0
*
* @param int $user_id User ID.
* @return array
@ -261,7 +261,7 @@ function get_users_drafts( $user_id ) {
* being deleted will be run after the posts are either reassigned or deleted.
* The user meta will also be deleted that are for that User ID.
*
* @since unknown
* @since 2.0.0
*
* @param int $id User ID.
* @param int $reassign Optional. Reassign posts and links to new User ID.
@ -316,7 +316,7 @@ function wp_delete_user( $id, $reassign = 'novalue' ) {
/**
* Remove all capabilities from user.
*
* @since unknown
* @since 2.1.0
*
* @param int $id User ID.
*/
@ -328,6 +328,9 @@ function wp_revoke_user($id) {
}
add_action('admin_init', 'default_password_nag_handler');
/**
* @since 2.8.0
*/
function default_password_nag_handler($errors = false) {
global $user_ID;
if ( ! get_user_option('default_password_nag') ) //Short circuit it.
@ -341,6 +344,9 @@ function default_password_nag_handler($errors = false) {
}
add_action('profile_update', 'default_password_nag_edit_user', 10, 2);
/**
* @since 2.8.0
*/
function default_password_nag_edit_user($user_ID, $old_data) {
if ( ! get_user_option('default_password_nag', $user_ID) ) //Short circuit it.
return;
@ -354,6 +360,9 @@ function default_password_nag_edit_user($user_ID, $old_data) {
}
add_action('admin_notices', 'default_password_nag');
/**
* @since 2.8.0
*/
function default_password_nag() {
global $pagenow;
if ( 'profile.php' == $pagenow || ! get_user_option('default_password_nag') ) //Short circuit it.

View File

@ -60,7 +60,7 @@ function _sort_name_callback( $a, $b ) {
* Show the widgets and their settings for a sidebar.
* Used in the the admin widget config screen.
*
* @since unknown
* @since 2.5.0
*
* @param string $sidebar id slug of the sidebar
*/
@ -84,7 +84,7 @@ function wp_list_widget_controls( $sidebar ) {
/**
* {@internal Missing Short Description}}
*
* @since unknown
* @since 2.5.0
*
* @param array $params
* @return array
@ -128,7 +128,7 @@ function next_widget_id_number($id_base) {
*
* Called from dynamic_sidebar().
*
* @since unknown
* @since 2.5.0
*
* @param array $sidebar_args
* @return array

View File

@ -27,7 +27,7 @@ $map = $opml_map;
/**
* XML callback function for the start of a new XML tag.
*
* @since unknown
* @since 0.71
* @access private
*
* @uses $updated_timestamp Not used inside function.
@ -68,7 +68,7 @@ function startElement($parser, $tagName, $attrs) {
/**
* XML callback function that is called at the end of a XML tag.
*
* @since unknown
* @since 0.71
* @access private
* @package WordPress
* @subpackage Dummy

View File

@ -9,7 +9,7 @@
/**
* This is a profile page.
*
* @since unknown
* @since 2.5.0
* @var bool
*/
define('IS_PROFILE_PAGE', true);

View File

@ -9,7 +9,7 @@
/**
* We are upgrading WordPress.
*
* @since unknown
* @since 1.5.1
* @var bool
*/
define( 'WP_INSTALLING', true );

View File

@ -1624,7 +1624,7 @@ class WP_HTTP_Proxy {
* hosts that won't be sent through the proxy.
*
* @uses WP_PROXY_BYPASS_HOSTS
* @since unknown
* @since 2.8.0
*
* @param string $uri URI to check.
* @return bool True, to send through the proxy and false if, the proxy should not be used.

View File

@ -204,7 +204,7 @@ function comments_link_feed() {
*
* @package WordPress
* @subpackage Feed
* @since unknown
* @since 2.5.0
*
* @param int|object $comment_id Optional comment object or id. Defaults to global comment object.
*/
@ -217,7 +217,7 @@ function comment_guid($comment_id = null) {
*
* @package WordPress
* @subpackage Feed
* @since unknown
* @since 2.5.0
*
* @param int|object $comment_id Optional comment object or id. Defaults to global comment object.
* @return bool|string false on failure or guid for comment on success.

View File

@ -1642,7 +1642,7 @@ function status_header( $header ) {
* The several different headers cover the different ways cache prevention is handled
* by different browsers
*
* @since 2.8
* @since 2.8.0
*
* @uses apply_filters()
* @return array The associative array of header names and field values.
@ -2216,7 +2216,7 @@ function wp_upload_dir( $time = null ) {
* The callback is passed three parameters, the first one is the directory, the
* second is the filename, and the third is the extension.
*
* @since 2.5
* @since 2.5.0
*
* @param string $dir
* @param string $filename

View File

@ -199,7 +199,7 @@ function wp_loginout($redirect = '', $echo = true) {
*
* Returns the URL that allows the user to log out of the site
*
* @since 2.7
* @since 2.7.0
* @uses wp_nonce_url() To protect against CSRF
* @uses site_url() To generate the log in URL
* @uses apply_filters() calls 'logout_url' hook on final logout url
@ -223,7 +223,7 @@ function wp_logout_url($redirect = '') {
*
* Returns the URL that allows the user to log in to the site
*
* @since 2.7
* @since 2.7.0
* @uses site_url() To generate the log in URL
* @uses apply_filters() calls 'login_url' hook on final login url
*
@ -2252,7 +2252,7 @@ function get_the_generator( $type = '' ) {
*
* Compares the first two arguments and if identical marks as checked
*
* @since 1.0
* @since 1.0.0
*
* @param mixed $checked One of the values to compare
* @param mixed $current (true) The other value to compare if not just true
@ -2268,7 +2268,7 @@ function checked( $checked, $current = true, $echo = true ) {
*
* Compares the first two arguments and if identical marks as selected
*
* @since 1.0
* @since 1.0.0
*
* @param mixed $selected One of the values to compare
* @param mixed $current (true) The other value to compare if not just true
@ -2300,7 +2300,7 @@ function disabled( $disabled, $current = true, $echo = true ) {
*
* Compares the first two arguments and if identical marks as $type
*
* @since 2.8
* @since 2.8.0
* @access private
*
* @param any $helper One of the values to compare

View File

@ -870,7 +870,7 @@ function get_tag_template() {
* template is used. If none of the files exist, then it will fall back on to
* index.php.
*
* @since unknown (2.6.0 most likely)
* @since 2.5.0
* @uses apply_filters() Calls 'taxonomy_template' filter on found path.
*
* @return string
@ -1235,7 +1235,7 @@ function preview_theme_ob_filter_callback( $matches ) {
/**
* Switches current theme to new template and stylesheet names.
*
* @since unknown
* @since 2.5.0
* @uses do_action() Calls 'switch_theme' action on updated theme display name.
*
* @param string $template Template name

View File

@ -455,7 +455,7 @@ class wpdb {
/**
* A textual description of the last query/get_row/get_var call
*
* @since unknown
* @since 3.0.0
* @access public
* @var string
*/

View File

@ -64,7 +64,7 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
*
* This will set class properties based on the key value pairs in the array.
*
* @since unknown
* @since 2.6.0
*
* @param array $params
*/