@returns
@returns is not a distinct tag — it is a recognized alias for @return. The library's own source comment marks it as "a fairly common typo in code," so rather than rejecting it, the parser accepts @returns and produces the exact same tag that @return would.
"@returns" <Type> [ <Description> ]
Both spellings above parse into an identical ReturnTag instance, exposing the same $type and $description. See @return for the full description of the tag's shape and behavior.
05 July 2026