Drew Jaynes d95586e943 Add missing summaries and descriptions for various functions in wp-admin/includes/upgrade.php. ...

Also generally improve existing parameter, return, and other documentation in various function DocBlocks.

Props morganestes.
Fixes #30825.

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


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

2015-01-19 09:15:22 +00:00

..

admin.php

Fix syntax for single- and multi-line comments in wp-admin-directory files.

2014-07-17 09:14:16 +00:00

ajax-actions.php

In wp_ajax_parse_media_shortcode(), don't require a global $post for all passed shortcodes.

2015-01-16 05:19:22 +00:00

bookmark.php

Switch to a 403 response code in places where it is more appropriate than a 500 due to permissions errors.

2014-11-16 06:16:22 +00:00

class-ftp-pure.php

…

class-ftp-sockets.php

…

class-ftp.php

PHP 5.2 compatibility for [30310], __DIR__ wasn't added until PHP 5.3. Props TobiasBg. Fixes #29628

2014-11-12 10:44:23 +00:00

class-pclzip.php

…

class-wp-comments-list-table.php

After [31146], properly declare $user_can as a private field in WP_Comments_List_Table.

2015-01-12 16:02:24 +00:00

class-wp-filesystem-base.php

@param cleanup:

2015-01-16 19:03:23 +00:00

class-wp-filesystem-direct.php

Improve some wp-admin/includes/class-wp-filesystem-*.php docs for @param.

2014-12-20 20:40:23 +00:00

class-wp-filesystem-ftpext.php

Calling ->chown() and ->chgrp() in WP_Filesystem_FTPext produces no side-effects. Remove the calls. ->chgrp() is defined in the super class, and does nothing, can be removed from the child class.

2015-01-16 21:07:24 +00:00

class-wp-filesystem-ftpsockets.php

Fix some erroneous @param annotations.

2015-01-16 22:44:25 +00:00

class-wp-filesystem-ssh2.php

Fix some erroneous @param annotations.

2015-01-16 22:44:25 +00:00

class-wp-importer.php

Fix some internal types that are passed to functions to avoid changing the acceptable types passed as arguments to those functions:

2015-01-16 22:51:21 +00:00

class-wp-links-list-table.php

List tables: Use CSS :nth-child() selectors for zebra striping.

2015-01-14 22:14:22 +00:00

class-wp-list-table.php

Fix some internal types that are passed to functions to avoid changing the acceptable types passed as arguments to those functions:

2015-01-16 22:51:21 +00:00

class-wp-media-list-table.php

Fix some internal types that are passed to functions to avoid changing the acceptable types passed as arguments to those functions:

2015-01-16 22:51:21 +00:00

class-wp-ms-sites-list-table.php

List tables: Use CSS :nth-child() selectors for zebra striping.

2015-01-14 22:14:22 +00:00

class-wp-ms-themes-list-table.php

In lieu of refactoring, add a private field to WP_MS_Themes_List_Table, $has_items. Ideally, this class would overload ->has_items() and not set a private field.

2015-01-12 16:17:22 +00:00

class-wp-ms-users-list-table.php

List tables: Use CSS :nth-child() selectors for zebra striping.

2015-01-14 22:14:22 +00:00

class-wp-plugin-install-list-table.php

Ensure the correct list of default tabs for the Plugin Install screen are documented.

2015-01-19 08:44:22 +00:00

class-wp-plugins-list-table.php

Improve various @param docs for List Tables.

2014-12-01 00:33:23 +00:00

class-wp-posts-list-table.php

Fix some internal types that are passed to functions to avoid changing the acceptable types passed as arguments to those functions:

2015-01-16 22:51:21 +00:00

class-wp-terms-list-table.php

In HTML5, the action attribute is no longer required. Remove this attribute when empty.

2015-01-16 04:16:24 +00:00

class-wp-theme-install-list-table.php

Docs Formatting: Backtick-escape inline code for all dynamic hook docs in wp-admin/includes/*.

2014-11-30 11:28:24 +00:00

class-wp-themes-list-table.php

Improve various @param docs for List Tables.

2014-12-01 00:33:23 +00:00

class-wp-upgrader-skins.php

Fix some erroneous @param annotations.

2015-01-16 22:44:25 +00:00

class-wp-upgrader.php

Jump statements should not be followed by other statements (there were 5 lingering).

2015-01-08 21:15:22 +00:00

class-wp-users-list-table.php

In PHP 5.0.0, is_a() became deprecated in favour of the instanceof operator. Calling is_a() would result in an E_STRICT warning.

2015-01-16 01:06:24 +00:00

comment.php

Correct references of @uses $wpdb in core documentation to use @global.

2014-10-31 17:56:22 +00:00

continents-cities.php

…

dashboard.php

In HTML5, the action attribute is no longer required. Remove this attribute when empty.

2015-01-16 04:16:24 +00:00

deprecated.php

Correctly capitalize JavaScript throughout core docs.

2014-12-02 00:31:22 +00:00

export.php

The keyword elseif should be used instead of else if so that all control keywords look like single words.

2015-01-08 07:05:25 +00:00

file.php

Fix some erroneous @param annotations.

2015-01-16 22:44:25 +00:00

image-edit.php

Image file editor: fix a wrong error message when restoring an edited image and IMAGE_EDIT_OVERWRITE is set. Props tiqbiz, fixes #30167.

2015-01-07 22:48:22 +00:00

image.php

Use && instead of and in the 3 places where and was used.

2015-01-08 21:12:22 +00:00

import.php

In wp_import_handle_upload():

2014-12-20 21:10:24 +00:00

list-table.php

Fix mismatches in access modifiers for WP_List_Table + subclasses.

2014-07-13 22:09:16 +00:00

media.php

In HTML5, the action attribute is no longer required. Remove this attribute when empty.

2015-01-16 04:16:24 +00:00

menu.php

Fix syntax for single- and multi-line comments in wp-admin-directory files.

2014-07-17 09:14:16 +00:00

meta-boxes.php

The keyword elseif should be used instead of else if so that all control keywords look like single words.

2015-01-08 07:05:25 +00:00

misc.php

Fill in the @param types for the args for functions missing them in wp-admin/includes/misc.php.

2014-11-03 06:01:24 +00:00

ms-deprecated.php

Fix syntax for single- and multi-line comments in wp-admin-directory files.

2014-07-17 09:14:16 +00:00

ms.php

Add variable type for sync_category_tag_slugs() parameters.

2015-01-09 11:19:22 +00:00

nav-menu.php

For clarity, initialize some arrays that previously were only assigned via short circuit in loops.

2014-12-20 22:47:22 +00:00

plugin-install.php

In HTML5, the action attribute is no longer required. Remove this attribute when empty.

2015-01-16 04:16:24 +00:00

plugin.php

Remove unused local vars in delete_plugins(), delete_theme(), WP_Date_Query->validate_date_values(), global_terms(), and WP_Text_Diff_Renderer_Table->_changed().

2015-01-16 21:19:22 +00:00

post.php

Replace the 3 remaining occurrences of wpspin GIF with spinner.

2015-01-16 00:33:22 +00:00

revision.php

In wp-admin/includes/revision.php, $post->modified is a coding error. It should be $post->post_modified.

2015-01-10 05:50:22 +00:00

schema.php

Adjust [29806] and revert [29807] to restore placeholder and email copy order.

2014-12-05 01:15:26 +00:00

screen.php

In HTML5, the action attribute is no longer required. Remove this attribute when empty.

2015-01-16 04:16:24 +00:00

taxonomy.php

Default $parent in category_exists() should default to null rather than 0.

2015-01-11 01:26:27 +00:00

template.php

In HTML5, the action attribute is no longer required. Remove this attribute when empty.

2015-01-16 04:16:24 +00:00

theme-install.php

In HTML5, the action attribute is no longer required. Remove this attribute when empty.

2015-01-16 04:16:24 +00:00

theme.php

Remove unused local vars in delete_plugins(), delete_theme(), WP_Date_Query->validate_date_values(), global_terms(), and WP_Text_Diff_Renderer_Table->_changed().

2015-01-16 21:19:22 +00:00

translation-install.php

Call the init() method for the upgrader in wp_can_install_language_pack() to avoid undefined index notices.

2015-01-07 23:43:24 +00:00

update-core.php

Declare $wp_version, $required_php_version, and $required_mysql_version as globals in install and upgrade admin files.

2015-01-10 05:57:22 +00:00

update.php

The keyword elseif should be used instead of else if so that all control keywords look like single words.

2015-01-08 07:05:25 +00:00

upgrade.php

Add missing summaries and descriptions for various functions in wp-admin/includes/upgrade.php.

2015-01-19 09:15:22 +00:00

user.php

Correct all @return unknown instances.

2014-11-03 06:17:22 +00:00

widgets.php

In HTML5, the action attribute is no longer required. Remove this attribute when empty.

2015-01-16 04:16:24 +00:00