phpDoc comments - @link vs @see

[MGSteve]

Just noticed that the XF source phpDoc comments use the @link tag to refer to other methods within a class. However, @link is supposed to refer to a URL, @see is supposed to be use for referring to other methods.

Just thought I'd mention it. Its hardly earth shattering I know, but still.

Great work though, the code in XF is a work of art.

 

[Mike]

Actually, inline @link is different from block @link: http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.inlinelink.pkg.html

 

[MGSteve]

Ah, ok - nice and confusing I @see.

 

[Mike]

Yeah, agreed there