WordPress.org
Get WordPress

Make WordPress Core

Opened 3 years ago

Last modified 2 years ago

#60452 new defect (bug)

@category tag is considered deprecated by phpDocumentor

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

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 2 years ago.
removing @category from class-json.php

Download all attachments as: .zip

Change History (2)

@sabernhardt
2 years ago

removing @category from class-json.php

#1 @sabernhardt
2 years 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.