Docs: Use proper case for `@todo` tags.

The correct tag is `@todo`, not `@TODO` or `@todo:` (note the trailing colon).

Reference: [https://developer.wordpress.org/coding-standards/inline-documentation-standards/php/#phpdoc-tags PHP Documentation Standards: PHPDoc tags].

Follow-up to [55203], [56274], [56565], [56698].

Props jrf.
See #59651.
Built from https://develop.svn.wordpress.org/trunk@57077


git-svn-id: http://core.svn.wordpress.org/trunk@56588 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Sergey Biryukov 2023-11-07 00:14:23 +00:00
parent 9c8d8c260a
commit 7da5644617
4 changed files with 13 additions and 13 deletions

View File

@ -796,12 +796,12 @@ function wp_render_layout_support_flag( $block_content, $block ) {
* are still present in the wrapper as they are in this example. Frequently, additional classes * are still present in the wrapper as they are in this example. Frequently, additional classes
* will also be present; rarely should classes be removed. * will also be present; rarely should classes be removed.
* *
* @TODO: Find a better way to match the first inner block. If it's possible to identify where the * @todo Find a better way to match the first inner block. If it's possible to identify where the
* first inner block starts, then it will be possible to find the last tag before it starts * first inner block starts, then it will be possible to find the last tag before it starts
* and then that tag, if an opening tag, can be solidly identified as a wrapping element. * and then that tag, if an opening tag, can be solidly identified as a wrapping element.
* Can some unique value or class or ID be added to the inner blocks when they process * Can some unique value or class or ID be added to the inner blocks when they process
* so that they can be extracted here safely without guessing? Can the block rendering function * so that they can be extracted here safely without guessing? Can the block rendering function
* return information about where the rendered inner blocks start? * return information about where the rendered inner blocks start?
* *
* @var string|null * @var string|null
*/ */

View File

@ -342,7 +342,7 @@ class WP_HTML_Processor extends WP_HTML_Tag_Processor {
/** /**
* Finds the next tag matching the $query. * Finds the next tag matching the $query.
* *
* @TODO: Support matching the class name and tag name. * @todo Support matching the class name and tag name.
* *
* @since 6.4.0 * @since 6.4.0
* *
@ -551,9 +551,9 @@ class WP_HTML_Processor extends WP_HTML_Tag_Processor {
* Breadcrumbs start at the outermost parent and descend toward the matched element. * Breadcrumbs start at the outermost parent and descend toward the matched element.
* They always include the entire path from the root HTML node to the matched element. * They always include the entire path from the root HTML node to the matched element.
* *
* @TODO: It could be more efficient to expose a generator-based version of this function * @todo It could be more efficient to expose a generator-based version of this function
* to avoid creating the array copy on tag iteration. If this is done, it would likely * to avoid creating the array copy on tag iteration. If this is done, it would likely
* be more useful to walk up the stack when yielding instead of starting at the top. * be more useful to walk up the stack when yielding instead of starting at the top.
* *
* Example * Example
* *

View File

@ -2031,8 +2031,8 @@ class WP_HTML_Tag_Processor {
* *
* @see https://html.spec.whatwg.org/#attributes-2 * @see https://html.spec.whatwg.org/#attributes-2
* *
* @TODO as the only regex pattern maybe we should take it out? are * @todo As the only regex pattern maybe we should take it out?
* Unicode patterns available broadly in Core? * Are Unicode patterns available broadly in Core?
*/ */
if ( preg_match( if ( preg_match(
'~[' . '~[' .

View File

@ -16,7 +16,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '6.5-alpha-57075'; $wp_version = '6.5-alpha-57077';
/** /**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.