Doxygen sometimes reads and tries to interpret phan notation; it should ignore it. Specific tags that I have seen
@phan-file-suppress
- At https://doc.wikimedia.org/mediawiki-core/master/php/group__API.html, the documentation for ApiMessageTrait includes "-file-suppress PhanTraitParentReference -file-suppress PhanUndeclaredMethod"
- https://doc.wikimedia.org/mediawiki-core/master/php/group__Search.html shown the phan suppression of SearchResultSetTrait
@phan-var
- https://doc.wikimedia.org/mediawiki-core/master/php/classHTMLForm.html#a9b9937a89232fdfaa5ab5bd605ab41ec shows -var array<array{name:string,value:string,label-message?:string|string[]|MessageSpecifier,label?:string,label-raw?:string,id?:string,attribs?:array,flags?:string|string[],framed?:bool}>
@phan-param
- https://doc.wikimedia.org/mediawiki-core/master/php/classLocalFile.html#ae5548ea4590f35d109f2661c1de475d2 - -param array{forThumbRefresh?:bool} $options
@phan-return
- https://doc.wikimedia.org/mediawiki-core/master/php/classInstaller.html#ae97c50c57ec2eef8152c68a712095e84 - -return array<int,array{name:string,callback:array{0:object,1:string}}>
@return-taint
- https://doc.wikimedia.org/mediawiki-core/master/php/classLogFormatter.html#a8c73b7a38960a08f0c183cea703af92b phan-taint-check gets very confused by $this->plaintext, so disable. -taint onlysafefor_html from 1 (exacerbated by a comment that is misplaced?)
- https://doc.wikimedia.org/mediawiki-core/master/php/classChangeTags.html#a8f43198cf5b8e9a82b0732142a549912 - -taint onlysafefor_htmlnoent