Docs: Fix some minor DocBlock alignment issues.
See #32246. git-svn-id: https://develop.svn.wordpress.org/trunk@35885 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
parent
fd30730949
commit
4e58589669
|
@ -15,7 +15,7 @@
|
|||
* @since 3.2.0
|
||||
*
|
||||
* @return array|false A list of all of the contributors, or false on error.
|
||||
*/
|
||||
*/
|
||||
function wp_credits() {
|
||||
global $wp_version;
|
||||
$locale = get_locale();
|
||||
|
|
|
@ -1207,7 +1207,7 @@ function wp_dashboard_plugins_output( $rss, $args = array() ) {
|
|||
* @since 3.0.0
|
||||
*
|
||||
* @return bool|null True if not multisite, user can't upload files, or the space check option is disabled.
|
||||
*/
|
||||
*/
|
||||
function wp_dashboard_quota() {
|
||||
if ( !is_multisite() || !current_user_can( 'upload_files' ) || get_site_option( 'upload_space_check_disabled' ) )
|
||||
return true;
|
||||
|
|
|
@ -224,7 +224,7 @@ function validate_file_to_edit( $file, $allowed_files = '' ) {
|
|||
* @param string $action Expected value for $_POST['action'].
|
||||
* @return array On success, returns an associative array of file attributes. On failure, returns
|
||||
* $overrides['upload_error_handler'](&$file, $message ) or array( 'error'=>$message ).
|
||||
*/
|
||||
*/
|
||||
function _wp_handle_upload( &$file, $overrides, $time, $action ) {
|
||||
// The default error handler.
|
||||
if ( ! function_exists( 'wp_handle_upload_error' ) ) {
|
||||
|
|
|
@ -1093,7 +1093,7 @@ function confirm_delete_users( $users ) {
|
|||
* Print JavaScript in the header on the Network Settings screen.
|
||||
*
|
||||
* @since 4.1.0
|
||||
*/
|
||||
*/
|
||||
function network_settings_add_js() {
|
||||
?>
|
||||
<script type="text/javascript">
|
||||
|
|
|
@ -237,7 +237,7 @@ function wp_nav_menu_taxonomy_meta_boxes() {
|
|||
*
|
||||
* @param int|string $nav_menu_selected_id (id, name or slug) of the currently-selected menu
|
||||
* @return string Disabled attribute if at least one menu exists, false if not
|
||||
*/
|
||||
*/
|
||||
function wp_nav_menu_disabled_check( $nav_menu_selected_id ) {
|
||||
global $one_theme_location_no_menus;
|
||||
|
||||
|
|
|
@ -1350,7 +1350,7 @@ function add_links_page( $page_title, $menu_title, $capability, $menu_slug, $fun
|
|||
* @param string $menu_slug The slug name to refer to this menu by (should be unique for this menu).
|
||||
* @param callable $function The function to be called to output the content for this page.
|
||||
* @return false|string The resulting page's hook_suffix, or false if the user does not have the capability required.
|
||||
*/
|
||||
*/
|
||||
function add_pages_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
|
||||
return add_submenu_page( 'edit.php?post_type=page', $page_title, $menu_title, $capability, $menu_slug, $function );
|
||||
}
|
||||
|
@ -1370,7 +1370,7 @@ function add_pages_page( $page_title, $menu_title, $capability, $menu_slug, $fun
|
|||
* @param string $menu_slug The slug name to refer to this menu by (should be unique for this menu).
|
||||
* @param callable $function The function to be called to output the content for this page.
|
||||
* @return false|string The resulting page's hook_suffix, or false if the user does not have the capability required.
|
||||
*/
|
||||
*/
|
||||
function add_comments_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
|
||||
return add_submenu_page( 'edit-comments.php', $page_title, $menu_title, $capability, $menu_slug, $function );
|
||||
}
|
||||
|
|
|
@ -283,9 +283,9 @@ endif;
|
|||
if ( ! function_exists( 'twentythirteen_post_nav' ) ) :
|
||||
/**
|
||||
* Display navigation to next/previous post when applicable.
|
||||
*
|
||||
* @since Twenty Thirteen 1.0
|
||||
*/
|
||||
*
|
||||
* @since Twenty Thirteen 1.0
|
||||
*/
|
||||
function twentythirteen_post_nav() {
|
||||
global $post;
|
||||
|
||||
|
|
|
@ -1195,7 +1195,7 @@ function create_user($username, $password, $email) {
|
|||
* Unused function.
|
||||
*
|
||||
* @deprecated 2.5.0
|
||||
*/
|
||||
*/
|
||||
function gzip_compression() {
|
||||
_deprecated_function( __FUNCTION__, '2.5' );
|
||||
return false;
|
||||
|
@ -1613,7 +1613,7 @@ function get_the_author_ID() {
|
|||
* @since 0.71
|
||||
* @deprecated 2.8.0 Use the_author_meta()
|
||||
* @see the_author_meta()
|
||||
*/
|
||||
*/
|
||||
function the_author_ID() {
|
||||
_deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'ID\')' );
|
||||
the_author_meta('ID');
|
||||
|
|
|
@ -685,7 +685,7 @@ function get_post_comments_feed_link($post_id = 0, $feed = '') {
|
|||
* @param string $link_text Descriptive text.
|
||||
* @param int $post_id Optional post ID. Default to current post.
|
||||
* @param string $feed Optional. Feed format.
|
||||
*/
|
||||
*/
|
||||
function post_comments_feed_link( $link_text = '', $post_id = '', $feed = '' ) {
|
||||
$url = get_post_comments_feed_link( $post_id, $feed );
|
||||
if ( empty( $link_text ) ) {
|
||||
|
@ -716,7 +716,7 @@ function post_comments_feed_link( $link_text = '', $post_id = '', $feed = '' ) {
|
|||
* @param int $author_id ID of an author.
|
||||
* @param string $feed Optional. Feed type.
|
||||
* @return string Link to the feed for the author specified by $author_id.
|
||||
*/
|
||||
*/
|
||||
function get_author_feed_link( $author_id, $feed = '' ) {
|
||||
$author_id = (int) $author_id;
|
||||
$permalink_structure = get_option('permalink_structure');
|
||||
|
@ -760,7 +760,7 @@ function get_author_feed_link( $author_id, $feed = '' ) {
|
|||
* @param int $cat_id ID of a category.
|
||||
* @param string $feed Optional. Feed type.
|
||||
* @return string Link to the feed for the category specified by $cat_id.
|
||||
*/
|
||||
*/
|
||||
function get_category_feed_link( $cat_id, $feed = '' ) {
|
||||
return get_term_feed_link( $cat_id, 'category', $feed );
|
||||
}
|
||||
|
@ -777,7 +777,7 @@ function get_category_feed_link( $cat_id, $feed = '' ) {
|
|||
* @param string $taxonomy Optional. Taxonomy of $term_id
|
||||
* @param string $feed Optional. Feed type.
|
||||
* @return string|false Link to the feed for the term specified by $term_id and $taxonomy.
|
||||
*/
|
||||
*/
|
||||
function get_term_feed_link( $term_id, $taxonomy = 'category', $feed = '' ) {
|
||||
$term_id = ( int ) $term_id;
|
||||
|
||||
|
@ -2719,7 +2719,7 @@ function previous_comments_link( $label = '' ) {
|
|||
*
|
||||
* @param string|array $args Optional args. See paginate_links().
|
||||
* @return string|void Markup for pagination links.
|
||||
*/
|
||||
*/
|
||||
function paginate_comments_links($args = array()) {
|
||||
global $wp_rewrite;
|
||||
|
||||
|
@ -2924,7 +2924,7 @@ function get_shortcut_link() {
|
|||
* @param string|null $scheme Optional. Scheme to give the home url context. Accepts
|
||||
* 'http', 'https', 'relative', 'rest', or null. Default null.
|
||||
* @return string Home url link with optional path appended.
|
||||
*/
|
||||
*/
|
||||
function home_url( $path = '', $scheme = null ) {
|
||||
return get_home_url( null, $path, $scheme );
|
||||
}
|
||||
|
@ -2946,7 +2946,7 @@ function home_url( $path = '', $scheme = null ) {
|
|||
* @param string|null $orig_scheme Optional. Scheme to give the home URL context. Accepts
|
||||
* 'http', 'https', 'relative', 'rest', or null. Default null.
|
||||
* @return string Home URL link with optional path appended.
|
||||
*/
|
||||
*/
|
||||
function get_home_url( $blog_id = null, $path = '', $scheme = null ) {
|
||||
global $pagenow;
|
||||
|
||||
|
@ -2998,7 +2998,7 @@ function get_home_url( $blog_id = null, $path = '', $scheme = null ) {
|
|||
* @param string $path Optional. Path relative to the site url.
|
||||
* @param string $scheme Optional. Scheme to give the site url context. See set_url_scheme().
|
||||
* @return string Site url link with optional path appended.
|
||||
*/
|
||||
*/
|
||||
function site_url( $path = '', $scheme = null ) {
|
||||
return get_site_url( null, $path, $scheme );
|
||||
}
|
||||
|
@ -3018,7 +3018,7 @@ function site_url( $path = '', $scheme = null ) {
|
|||
* 'http', 'https', 'login', 'login_post', 'admin', or
|
||||
* 'relative'. Default null.
|
||||
* @return string Site url link with optional path appended.
|
||||
*/
|
||||
*/
|
||||
function get_site_url( $blog_id = null, $path = '', $scheme = null ) {
|
||||
if ( empty( $blog_id ) || !is_multisite() ) {
|
||||
$url = get_option( 'siteurl' );
|
||||
|
@ -3055,7 +3055,7 @@ function get_site_url( $blog_id = null, $path = '', $scheme = null ) {
|
|||
* @param string $path Optional path relative to the admin url.
|
||||
* @param string $scheme The scheme to use. Default is 'admin', which obeys force_ssl_admin() and is_ssl(). 'http' or 'https' can be passed to force those schemes.
|
||||
* @return string Admin url link with optional path appended.
|
||||
*/
|
||||
*/
|
||||
function admin_url( $path = '', $scheme = 'admin' ) {
|
||||
return get_admin_url( null, $path, $scheme );
|
||||
}
|
||||
|
@ -3071,7 +3071,7 @@ function admin_url( $path = '', $scheme = 'admin' ) {
|
|||
* to force those schemes. Default 'admin', which obeys
|
||||
* {@see force_ssl_admin()} and {@see is_ssl()}.
|
||||
* @return string Admin url link with optional path appended.
|
||||
*/
|
||||
*/
|
||||
function get_admin_url( $blog_id = null, $path = '', $scheme = 'admin' ) {
|
||||
$url = get_site_url($blog_id, 'wp-admin/', $scheme);
|
||||
|
||||
|
@ -3098,7 +3098,7 @@ function get_admin_url( $blog_id = null, $path = '', $scheme = 'admin' ) {
|
|||
* @param string $path Optional. Path relative to the includes url.
|
||||
* @param string $scheme Optional. Scheme to give the includes url context.
|
||||
* @return string Includes url link with optional path appended.
|
||||
*/
|
||||
*/
|
||||
function includes_url( $path = '', $scheme = null ) {
|
||||
$url = site_url( '/' . WPINC . '/', $scheme );
|
||||
|
||||
|
@ -3124,7 +3124,7 @@ function includes_url( $path = '', $scheme = null ) {
|
|||
*
|
||||
* @param string $path Optional. Path relative to the content url.
|
||||
* @return string Content url link with optional path appended.
|
||||
*/
|
||||
*/
|
||||
function content_url($path = '') {
|
||||
$url = set_url_scheme( WP_CONTENT_URL );
|
||||
|
||||
|
@ -3156,7 +3156,7 @@ function content_url($path = '') {
|
|||
* The URL will be relative to its directory. Default empty.
|
||||
* Typically this is done by passing `__FILE__` as the argument.
|
||||
* @return string Plugins URL link with optional paths appended.
|
||||
*/
|
||||
*/
|
||||
function plugins_url( $path = '', $plugin = '' ) {
|
||||
|
||||
$path = wp_normalize_path( $path );
|
||||
|
@ -3206,7 +3206,7 @@ function plugins_url( $path = '', $plugin = '' ) {
|
|||
* @param string $path Optional. Path relative to the site url.
|
||||
* @param string $scheme Optional. Scheme to give the site url context. See set_url_scheme().
|
||||
* @return string Site url link with optional path appended.
|
||||
*/
|
||||
*/
|
||||
function network_site_url( $path = '', $scheme = null ) {
|
||||
if ( ! is_multisite() )
|
||||
return site_url($path, $scheme);
|
||||
|
@ -3248,7 +3248,7 @@ function network_site_url( $path = '', $scheme = null ) {
|
|||
* @param string $scheme Optional. Scheme to give the home url context. Accepts
|
||||
* 'http', 'https', or 'relative'. Default null.
|
||||
* @return string Home url link with optional path appended.
|
||||
*/
|
||||
*/
|
||||
function network_home_url( $path = '', $scheme = null ) {
|
||||
if ( ! is_multisite() )
|
||||
return home_url($path, $scheme);
|
||||
|
@ -3289,7 +3289,7 @@ function network_home_url( $path = '', $scheme = null ) {
|
|||
* @param string $path Optional path relative to the admin url.
|
||||
* @param string $scheme The scheme to use. Default is 'admin', which obeys force_ssl_admin() and is_ssl(). 'http' or 'https' can be passed to force those schemes.
|
||||
* @return string Admin url link with optional path appended.
|
||||
*/
|
||||
*/
|
||||
function network_admin_url( $path = '', $scheme = 'admin' ) {
|
||||
if ( ! is_multisite() )
|
||||
return admin_url( $path, $scheme );
|
||||
|
@ -3319,7 +3319,7 @@ function network_admin_url( $path = '', $scheme = 'admin' ) {
|
|||
* @param string $path Optional path relative to the admin url.
|
||||
* @param string $scheme The scheme to use. Default is 'admin', which obeys force_ssl_admin() and is_ssl(). 'http' or 'https' can be passed to force those schemes.
|
||||
* @return string Admin url link with optional path appended.
|
||||
*/
|
||||
*/
|
||||
function user_admin_url( $path = '', $scheme = 'admin' ) {
|
||||
$url = network_site_url('wp-admin/user/', $scheme);
|
||||
|
||||
|
@ -3346,7 +3346,7 @@ function user_admin_url( $path = '', $scheme = 'admin' ) {
|
|||
* @param string $path Optional path relative to the admin url.
|
||||
* @param string $scheme The scheme to use. Default is 'admin', which obeys force_ssl_admin() and is_ssl(). 'http' or 'https' can be passed to force those schemes.
|
||||
* @return string Admin url link with optional path appended.
|
||||
*/
|
||||
*/
|
||||
function self_admin_url($path = '', $scheme = 'admin') {
|
||||
if ( is_network_admin() )
|
||||
return network_admin_url($path, $scheme);
|
||||
|
@ -3489,7 +3489,7 @@ function get_edit_profile_url( $user_id = 0, $scheme = 'admin' ) {
|
|||
* Output rel=canonical for singular queries.
|
||||
*
|
||||
* @since 2.9.0
|
||||
*/
|
||||
*/
|
||||
function rel_canonical() {
|
||||
if ( ! is_singular() ) {
|
||||
return;
|
||||
|
|
Loading…
Reference in New Issue