Changeset 30541 for trunk/src/wp-includes/functions.php

Timestamp:

11/24/2014 05:38:44 AM (11 years ago)

Author:

DrewAPicture

Message:

Ensure inline code is markdown-escaped as such, HTML tags are removed from summaries, and that code snippets in descriptions are properly indented.

Affects DocBlocks for the following core elements:

• Markdown-indent a code snippet in the description for _deprecated_argument()
• Markdown-indent a code snippet in the description for wp_localize_script()
• Backtick-escape HTML tags in two parameter descriptions for wp_register()
• Various DocBlock formatting in the description for get_bloginfo()
• Remove HTML tag from the summary for _wp_render_title_tag()
• Backtick-escape a HTML tag in the description for get_archives_link()
• Markdown-indent a code snippet in the description for wp_admin_css_color()
• Markdown-indent a code snippet in the description for the welcome_panel hook

Props rarst.
See #30473.

File:

• trunk/src/wp-includes/functions.php (modified) (1 diff)

trunk/src/wp-includes/functions.php

@@ -3446 +3446 @@
  * used by comparing it to its default value or evaluating whether it is empty.
  * For example:
- * <code>
- * if ( ! empty( $deprecated ) ) {
- *  _deprecated_argument( __FUNCTION__, '3.0' );
- * }
- * </code>
+ *
+ *     if ( ! empty( $deprecated ) ) {
+ *         _deprecated_argument( __FUNCTION__, '3.0' );
+ *     }
+ *
  *
  * There is a hook deprecated_argument_run that will be called that can be used