Ensure we're using the correct @ignore phpDocumentor tag to mark elements that should be skipped when parsing.

DrewAPicture · DrewAPicture · commit 9b0cf1bd5bc0 · 2015-01-13T00:50:32.000Z
Up to this point, various core elements' DocBlocks incorrectly included an `@internal` tag as a means for skipping the parsing process. When paired with a description (inline or otherwise), `@internal` is a valid tag meant to provide internal-only context, but not necessarily to skip parsing the entire element. See #30987. git-svn-id: https://develop.svn.wordpress.org/trunk@31170 602fd350-edb4-49c9-b593-d223f7449a82
diff --git a/src/wp-admin/admin.php b/src/wp-admin/admin.php
@@ -216,7 +216,7 @@
 		/**
 		 * Used to call the registered callback for a plugin screen.
 		 *
-		 * @internal
+		 * @ignore
 		 * @since 1.5.0
 		 */
 		do_action( $page_hook );
diff --git a/src/wp-cron.php b/src/wp-cron.php
@@ -94,7 +94,7 @@ function _get_cron_lock() {
 			/**
 			 * Fires scheduled events.
 			 *
-			 * @internal
+			 * @ignore
 			 * @since 2.1.0
 			 *
 			 * @param string $hook Name of the hook that was scheduled to be fired.
diff --git a/src/wp-includes/functions.php b/src/wp-includes/functions.php
@@ -2684,11 +2684,11 @@ function wp_json_encode( $data, $options = 0, $depth = 512 ) {
 /**
  * Perform sanity checks on data that shall be encoded to JSON.
  *
- * @see wp_json_encode()
- *
+ * @ignore
  * @since 4.1.0
  * @access private
- * @internal
+ *
+ * @see wp_json_encode()
  *
  * @param mixed $data  Variable (usually an array or object) to encode as JSON.
  * @param int   $depth Maximum depth to walk through $data. Must be greater than 0.
@@ -2747,11 +2747,11 @@ function _wp_json_sanity_check( $data, $depth ) {
 /**
  * Convert a string to UTF-8, so that it can be safely encoded to JSON.
  *
- * @see _wp_json_sanity_check()
- *
+ * @ignore
  * @since 4.1.0
  * @access private
- * @internal
+ *
+ * @see _wp_json_sanity_check()
  *
  * @param string $string The string which is to be converted.
  * @return string The checked string.
@@ -4320,7 +4320,7 @@ function send_nosniff_header() {
 /**
  * Return a MySQL expression for selecting the week number based on the start_of_week option.
  *
- * @internal
+ * @ignore
  * @since 3.0.0
  *
  * @param string $column Database column.
diff --git a/src/wp-includes/general-template.php b/src/wp-includes/general-template.php
@@ -716,9 +716,9 @@ function get_bloginfo( $show = '', $filter = 'raw' ) {
 /**
  * Display title tag with contents.
  *
+ * @ignore
  * @since 4.1.0
  * @access private
- * @internal
  *
  * @see wp_title()
  */
diff --git a/src/wp-includes/script-loader.php b/src/wp-includes/script-loader.php
@@ -831,7 +831,9 @@ function print_footer_scripts() {
 }
 
 /**
- * @internal use
+ * Print scripts (internal use only)
+ *
+ * @ignore
  */
 function _print_scripts() {
 	global $wp_scripts, $compress_scripts;
@@ -997,7 +999,9 @@ function print_late_styles() {
 }
 
 /**
- * @internal use
+ * Print styles (internal use only)
+ *
+ * @ignore
  */
 function _print_styles() {
 	global $wp_styles, $compress_css;

Original file line number	Diff line number	Diff line change
`@@ -216,7 +216,7 @@`
`216`	`216`	`/**`
`217`	`217`	`* Used to call the registered callback for a plugin screen.`
`218`	`218`	`*`
`219`		`- * @internal`
	`219`	`+ * @ignore`
`220`	`220`	`* @since 1.5.0`
`221`	`221`	`*/`
`222`	`222`	`do_action( $page_hook );`
Original file line number	Diff line number	Diff line change
`@@ -94,7 +94,7 @@ function _get_cron_lock() {`
`94`	`94`	`/**`
`95`	`95`	`* Fires scheduled events.`
`96`	`96`	`*`
`97`		`- * @internal`
	`97`	`+ * @ignore`
`98`	`98`	`* @since 2.1.0`
`99`	`99`	`*`
`100`	`100`	`* @param string $hook Name of the hook that was scheduled to be fired.`
Original file line number	Diff line number	Diff line change
`@@ -716,9 +716,9 @@ function get_bloginfo( $show = '', $filter = 'raw' ) {`
`716`	`716`	`/**`
`717`	`717`	`* Display title tag with contents.`
`718`	`718`	`*`
	`719`	`+ * @ignore`
`719`	`720`	`* @since 4.1.0`
`720`	`721`	`* @access private`
`721`		`- * @internal`
`722`	`722`	`*`
`723`	`723`	`* @see wp_title()`
`724`	`724`	`*/`