diff --git a/wp-includes/comment-template.php b/wp-includes/comment-template.php index 21a4c3eb1c..5144285621 100644 --- a/wp-includes/comment-template.php +++ b/wp-includes/comment-template.php @@ -1940,6 +1940,8 @@ function wp_list_comments( $args = array(), $comments = null ) { * * @since 4.0.0 * + * @see wp_list_comments() + * * @param array $r An array of arguments for displaying comments. */ $r = apply_filters( 'wp_list_comments_args', $r ); diff --git a/wp-includes/formatting.php b/wp-includes/formatting.php index 69923584c7..c858aac78a 100644 --- a/wp-includes/formatting.php +++ b/wp-includes/formatting.php @@ -40,16 +40,18 @@ function wptexturize($text, $reset = false) { // Set up static variables. Run once only. if ( $reset || ! isset( $static_characters ) ) { /** - * Filter whether to skip running `wptexturize()`. + * Filter whether to skip running wptexturize(). * - * Passing false to the filter will effectively short-circuit `wptexturize()`. + * Passing false to the filter will effectively short-circuit wptexturize(). * returning the original text passed to the function instead. * - * The filter runs only once, the first time `wptexturize()` is called. + * The filter runs only once, the first time wptexturize() is called. * * @since 4.0.0 * - * @param bool $run_texturize Whether to short-circuit `wptexturize()`. + * @see wptexturize() + * + * @param bool $run_texturize Whether to short-circuit wptexturize(). */ $run_texturize = apply_filters( 'run_wptexturize', $run_texturize ); if ( false === $run_texturize ) { diff --git a/wp-includes/functions.php b/wp-includes/functions.php index 030d1f56ad..80d38d590b 100644 --- a/wp-includes/functions.php +++ b/wp-includes/functions.php @@ -3506,8 +3506,9 @@ function is_ssl() { * * @since 4.0.0 * - * @param string $url The URL - * @return bool True if the given URL uses https, false if not (or if the URL is not valid). + * @param string $url The URL. + * @return bool True if the given URL uses https, false if not (or if the URL + * is not valid). */ function is_https_url( $url ) { return ( 'https' === parse_url( $url, PHP_URL_SCHEME ) ); diff --git a/wp-includes/l10n.php b/wp-includes/l10n.php index 1f376c7497..e10d41b32a 100644 --- a/wp-includes/l10n.php +++ b/wp-includes/l10n.php @@ -821,6 +821,10 @@ function wp_get_pomo_file_data( $po_file ) { * Language selector. More to come. * * @since 4.0.0 + * + * @see get_available_languages() + * + * @param array $args Optional arguments. Default empty array. */ function wp_dropdown_languages( $args = array() ) { if ( isset( $args['languages'] ) ) { diff --git a/wp-includes/ms-blogs.php b/wp-includes/ms-blogs.php index 6a14febc3a..e2c3f208f5 100644 --- a/wp-includes/ms-blogs.php +++ b/wp-includes/ms-blogs.php @@ -910,7 +910,7 @@ function _update_blog_date_on_post_delete( $post_id ) { * * @since 4.0 * - * @param int $post_id Post ID + * @param int $post_id Post ID. */ function _update_posts_count_on_delete( $post_id ) { if ( 'publish' !== get_post_field( 'post_status', $post_id ) ) { diff --git a/wp-includes/theme.php b/wp-includes/theme.php index 68a8871296..912a49c0b6 100644 --- a/wp-includes/theme.php +++ b/wp-includes/theme.php @@ -1947,6 +1947,8 @@ function wp_customize_support_script() { * * @since 4.0.0 * + * @global WP_Customize_Manager $wp_customize Customizer instance. + * * @return bool True if the site is being previewed in the Customizer, false otherwise. */ function is_customize_preview() { diff --git a/wp-includes/wp-db.php b/wp-includes/wp-db.php index 6f3e46ef2a..dab2efbdff 100644 --- a/wp-includes/wp-db.php +++ b/wp-includes/wp-db.php @@ -1188,11 +1188,14 @@ class wpdb { * $sql = esc_sql( $wpdb->esc_like( $input ) ); * * @since 4.0.0 + * @access public * - * @param string $text The raw text to be escaped. The input typed by the user should have no extra or deleted slashes. - * @return string Text in the form of a LIKE phrase. The output is not SQL safe. Call prepare or real_escape next. + * @param string $text The raw text to be escaped. The input typed by the user should have no + * extra or deleted slashes. + * @return string Text in the form of a LIKE phrase. The output is not SQL safe. Call $wpdb::prepare() + * or real_escape next. */ - function esc_like( $text ) { + public function esc_like( $text ) { return addcslashes( $text, '_%\\' ); }