Make WordPress Core

Changeset 57077


Ignore:
Timestamp:
11/07/2023 12:12:24 AM (7 months ago)
Author:
SergeyBiryukov
Message:

Docs: Use proper case for @todo tags.

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

Reference: PHP Documentation Standards: PHPDoc tags.

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

Props jrf.
See #59651.

Location:
trunk/src/wp-includes
Files:
3 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/wp-includes/block-supports/layout.php

    r56994 r57077  
    797797     * will also be present; rarely should classes be removed.
    798798     *
    799      * @TODO: Find a better way to match the first inner block. If it's possible to identify where the
    800      *        first inner block starts, then it will be possible to find the last tag before it starts
    801      *        and then that tag, if an opening tag, can be solidly identified as a wrapping element.
    802      *        Can some unique value or class or ID be added to the inner blocks when they process
    803      *        so that they can be extracted here safely without guessing? Can the block rendering function
    804      *        return information about where the rendered inner blocks start?
     799     * @todo Find a better way to match the first inner block. If it's possible to identify where the
     800     *       first inner block starts, then it will be possible to find the last tag before it starts
     801     *       and then that tag, if an opening tag, can be solidly identified as a wrapping element.
     802     *       Can some unique value or class or ID be added to the inner blocks when they process
     803     *       so that they can be extracted here safely without guessing? Can the block rendering function
     804     *       return information about where the rendered inner blocks start?
    805805     *
    806806     * @var string|null
  • trunk/src/wp-includes/html-api/class-wp-html-processor.php

    r56790 r57077  
    343343     * Finds the next tag matching the $query.
    344344     *
    345      * @TODO: Support matching the class name and tag name.
     345     * @todo Support matching the class name and tag name.
    346346     *
    347347     * @since 6.4.0
     
    552552     * They always include the entire path from the root HTML node to the matched element.
    553553     *
    554      * @TODO: It could be more efficient to expose a generator-based version of this function
    555      *        to avoid creating the array copy on tag iteration. If this is done, it would likely
    556      *        be more useful to walk up the stack when yielding instead of starting at the top.
     554     * @todo It could be more efficient to expose a generator-based version of this function
     555     *       to avoid creating the array copy on tag iteration. If this is done, it would likely
     556     *       be more useful to walk up the stack when yielding instead of starting at the top.
    557557     *
    558558     * Example
  • trunk/src/wp-includes/html-api/class-wp-html-tag-processor.php

    r56953 r57077  
    20322032         * @see https://html.spec.whatwg.org/#attributes-2
    20332033         *
    2034          * @TODO as the only regex pattern maybe we should take it out? are
    2035          *       Unicode patterns available broadly in Core?
     2034         * @todo As the only regex pattern maybe we should take it out?
     2035         *       Are Unicode patterns available broadly in Core?
    20362036         */
    20372037        if ( preg_match(
Note: See TracChangeset for help on using the changeset viewer.