Skip to content

Hooks/Docs: the_title (×4) in deprecated.php missing xref to post-template.php #34

Open

Description

@apermo

Problem

4 calls to apply_filters( 'the_title', ... ) in wp-includes/deprecated.php have no PHPDoc or cross-reference comment. The canonical PHPDoc lives in wp-includes/post-template.php:166-173. All other call sites across core already have the correct xref.

Affected locations

  • src/wp-includes/deprecated.php:153 — in deprecated previous_post()
  • src/wp-includes/deprecated.php:188 — in deprecated next_post()
  • src/wp-includes/deprecated.php:2705 — in deprecated start_post_rel_link()
  • src/wp-includes/deprecated.php:2782 — in deprecated parent_post_rel_link()

Fix

Add /** This filter is documented in wp-includes/post-template.php */ above each call.

Related to https://core.trac.wordpress.org/ticket/64224

Activity

  1. apermo commented on Mar 8, 2026

    @apermo
    OwnerAuthor

    Likely irrelevant, but ok.

  2. added
    verifiedIssue is manually verified.
    has-fixHas a fix/PR upstream is opened
    on Mar 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationhas-fixHas a fix/PR upstream is openedverifiedIssue is manually verified.

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions