phpDocumentor icon indicating copy to clipboard operation
phpDocumentor copied to clipboard

uses tag not work

Open rino1 opened this issue 4 years ago • 3 comments

https://manual.phpdoc.org/HTMLSmartyConverter/PHP/phpDocumentor/tutorial_tags.uses.pkg.html "The @uses tag automatically creates a virtual @usedby tag in the other documentation that links to the documentation containing the @uses tag. In other words, it is exactly like @see, except a return link is added automatically."

` //classes.php class A { /** * @uses B::b() */ function a(){} } class B { function b(){} }

$ php -l classes.php && phpdoc -f classes.php -t docs No syntax errors detected in classes.php phpDocumentor v3.0.0

Parsing files ... ` I checked the page docs/classes/B.html#method_b and I see that there is no reference (@usedby) to A::a(). Why?

rino1 avatar May 22 '21 15:05 rino1

the manual you checked is the old manual of phpDocumentor v1 which had more features regarding tags. with introducing classes and all other features in php 5 we needed a full rewrite of phpDocumentor to support all those features. And we implemented not all features which had been implemented in the new phpDocumentor

nowadays, phpDocumentor v3 is the latest version and is still lagging regarding tag support in phpDocumentor v1.

I will keep this item open, but I don't think it will be implemented soon. Since the resources of our team are quite limited.

jaapio avatar Jun 04 '21 17:06 jaapio

Where is the new manual?

Furthermore

` class ABC { /** * @see ABC::fx() */ function f1() {}

/**
 * @see self::fx()
 */
function f2() {}

function fx() {}

} `

because, in the generated documentation, ABC::fx () is clickable, but self::fx() is not clickable (does not appear as a hyperlink)? They should both be equivalent!!!

rino1 avatar Jun 05 '21 12:06 rino1

You can find the manual here https://docs.phpdoc.org/latest/

Could you please report the self:: missing link in a separate issue? It makes it easier for us to track it like that.

jaapio avatar Jun 06 '21 07:06 jaapio