WordPress.org

Make WordPress Core

Opened 16 months ago

Last modified 16 months ago

#44453 new defect (bug)

PHPDoc comments do not contain all necessary @throws tags

Reported by: subrataemfluence Owned by:
Milestone: Future Release Priority: normal
Severity: normal Version: 5.1
Component: General Keywords: needs-patch
Focuses: docs, coding-standards Cc:
PR Number:

Description

Files:

/wp-includes/functions.php
/wp-includes/spl-autoload-compat.php

There are more files having this issue but I am not sure if they are extensively maintained by WordPress core team itself. One example is files inside pomo directory. So I did not consider them.

Please find attached proposed patch.

Attachments (1)

44453.diff​ (1.2 KB) - added by subrataemfluence 16 months ago.
Proposed patch

Download all attachments as: .zip

Change History (2)

@subrataemfluence
16 months ago

Proposed patch

#1 @netweb
16 months ago

  • Milestone changed from Awaiting Review to Future Release

You are correct @subrataemfluence, there has not been much usage of @throws historically, it is also not documented in the ​handbook.

A little more research and some documentation is probably required in order before landing this.

Note: See TracTickets for help on using tickets.