Changeset 30546 for trunk/src/wp-includes/taxonomy.php

Timestamp:

11/24/2014 06:30:19 AM (10 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:

• Backtick-escape code snippets in the description for get_object_taxonomies()
• Backtick-escape inline code in a markdown-formatted unordered list in the description for get_taxonomy_labels()
• Remove an HTML tag from the summary for the Walker_Category_Checklist class
• Remove an HTML tag from the summary for wp_category_checklist(), various formatting
• Remove an HTML tag from the summary for wp_terms_checklist()
• Backtick-escape an HTML tag in the description for wp_popular_terms_checklist()
• Remove HTML tags from the summaries for page_template_dropdown(), parent_dropdown(), and wp_dropdown_roles()
• Backtick-escape HTML tags in a parameter description for add_settings_error()
• Various formatting in the description and summary for settings_errors()
• Markdown-indent code snippets in the descriptions for wpdb::prepare(), wpdb::insert(), wpdb::replace(), wpdb::update(), and wpdb::delete()
• Backtick-escape an HTML tag in a parameter description for login_header()
• Remove HTML tags from the summaries for the lostpassword_form and signup_header hooks

Props rarst.
See #30473.

File:

• trunk/src/wp-includes/taxonomy.php (modified) (3 diffs)

trunk/src/wp-includes/taxonomy.php

@@ -156 +156 @@
  * $wp_taxonomies global variable.
  *
- * <code><?php $taxonomies = get_object_taxonomies('post'); ?></code> Should
- * result in <code>Array('category', 'post_tag')</code>
+ * `<?php $taxonomies = get_object_taxonomies('post'); ?>` Should
+ * result in `Array( 'category', 'post_tag' )`
  *
  * @since 2.3.0
@@ -435 +435 @@
  *
  * Accepted keys of the label array in the taxonomy object:
+ *
  * - name - general name for the taxonomy, usually plural. The same as and overridden by $tax->label. Default is Tags/Categories
  * - singular_name - name for one object of this taxonomy. Default is Tag/Category
@@ -441 +442 @@
  * - all_items - Default is All Tags/All Categories
  * - parent_item - This string isn't used on non-hierarchical taxonomies. In hierarchical ones the default is Parent Category
- * - parent_item_colon - The same as <code>parent_item</code>, but with colon <code>:</code> in the end
+ * - parent_item_colon - The same as `parent_item`, but with colon `:ё in the end
  * - edit_item - Default is Edit Tag/Edit Category
  * - view_item - Default is View Tag/View Category