Make WordPress Core

Opened 2 months ago

Last modified 8 weeks ago

#60452 new defect (bug)

@category tag is considered deprecated by phpDocumentor

Reported by: henrywright's profile henry.wright Owned by:
Milestone: Awaiting Review Priority: normal
Severity: normal Version:
Component: General Keywords: has-patch 2nd-opinion
Focuses: docs Cc:

Description

The @category tag is used in wp-includes/class-json.php. According to phpdoc.org it is deprecated and isn't recommended.

Ref https://docs.phpdoc.org/3.0/guide/references/phpdoc/tags/category.html

This tag is considered deprecated and support may be removed in a future version of phpDocumentor. It is recommended to use the @package tag's ability to provide multiple levels instead.

Attachments (1)

60452.diff (472 bytes) - added by sabernhardt 8 weeks ago.
removing @category from class-json.php

Download all attachments as: .zip

Change History (2)

@sabernhardt
8 weeks ago

removing @category from class-json.php

#1 @sabernhardt
8 weeks ago

  • Keywords has-patch 2nd-opinion added

The class-json.php file is the only place where @category is used, and the entire file with Services_JSON is deprecated.

I made a patch to remove that line; however, the file may be removed instead. #57681 closed without changing documentation, and #60070 has not been decided yet.

Note: See TracTickets for help on using tickets.