Skip to content

Commit 6a8762c

Browse files
committed
rephrase on return tag
1 parent 24862e2 commit 6a8762c

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

proposed/phpdoc-tags.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -690,10 +690,10 @@ function or method. When provided, it MUST contain a "Type"
690690
to indicate what is returned; the description on the other hand is OPTIONAL yet
691691
RECOMMENDED in case of complicated return structures, such as associative arrays.
692692

693-
It is RECOMMENDED to use this tag with every function and method.
694-
If no `@return` type is given, and no return type declaration is provided in
695-
the code signature, an interpreter MUST interpret this as if `@return mixed`
696-
is provided.
693+
It is RECOMMENDED to use this tag with every function or method where PHP native
694+
types are insufficient. If no `@return` type is given, and no return type
695+
declaration is provided in the code signature, an interpreter MUST interpret
696+
this as if `@return mixed` is provided.
697697

698698
This tag MUST NOT occur more than once in a "DocBlock" and is limited to the
699699
"DocBlock" of a "Structural Element" of a method or function.

0 commit comments

Comments
 (0)