search

tobyS / pdv

PHP Documentor for VIM - Generates PHP docblocks
161 stars 32 forks source link

Change see to uses #24

Closed MikkelPaulson closed 8 years ago

MikkelPaulson commented 8 years ago

Based on the phpDocumentor docs, it's more appropriate to use @uses than @see to describe an inheritance relationship. Ideally the @used-by tag should be added to the parent class, but that's not really practical, the docs list it as optional ("SHOULD"), and current versions of phpdoc don't actually recognize that tag.

http://www.phpdoc.org/docs/latest/references/phpdoc/tags/uses.html

MikkelPaulson commented 8 years ago

This included the commits for #23; I'll close the request for now and reopen based on the approval/rejection of the other request.