Changeset 30537 for trunk/src/wp-includes/class.wp-dependencies.php

Timestamp:

11/24/2014 04:57:17 AM (10 years ago)

Author:

DrewAPicture

Message:

Ensure inline code is markdown-escaped as such, and that code snippets in descriptions are properly indented.

Affects DocBlocks for the following core elements:

• Backtick-escapes a <link> tag in a parameter description for the embed_oembed_discover hook
• Inline code fixes in the summary and return description for WP_List_Table::get_table_classes()
• Removes HTML markup from the summary for WP_List_Table::display_rows_or_placeholder()
• Backtick-escapes a <tr> tag in a parameter description for WP_Users_List_Table::single_row()
• Converts non-DocBlocks into multi-line comments in WP_Dependencies::do_items()
• Removes HTML markup from the summary for the comment_form_top hook.
• Inline code and snippet fixes in the description for wp_get_schedules()

Props rarst for the initial patch.
See #30473.

File:

• trunk/src/wp-includes/class.wp-dependencies.php (modified) (4 diffs)

trunk/src/wp-includes/class.wp-dependencies.php

@@ -90 +90 @@
      */
     public function do_items( $handles = false, $group = false ) {
-        /**
+        /*
          * If nothing is passed, print the queue. If a string is passed,
          * print that item. If an array is passed, print those items.
@@ -100 +100 @@
             if ( !in_array($handle, $this->done, true) && isset($this->registered[$handle]) ) {
 
-                /**
+                /*
                  * A single item may alias a set of items, by having dependencies,
                  * but no source. Queuing the item queues the dependencies.
@@ -108 +108 @@
                  *
                  * The src property is false.
-                **/
+                 */
                 if ( ! $this->registered[$handle]->src ) {
                     $this->done[] = $handle;
@@ -114 +114 @@
                 }
 
-                /**
+                /*
                  * Attempt to process the item. If successful,
                  * add the handle to the done array.