thekid/rfc — Issue #137: RFC 0137: Retrieve class tags through reflection
Author: thekid
Created: 2011-10-09 15:20:32+00:00
State: open
Labels: rejected, rfc

Scope of Change
====
The various @-style apidoc tags through XP's reflection
API.

Rationale
====
Contains some additional information. In some rare situations
one might want to access those.

Functionality
====
A new method getTagByName() will be added to lang.XPClass.

Security considerations
====
n/a

Speed impact
====
Slightly slower as an additional array element must be
created and one further preg_match() call is executed upon
retrieving class details.

Dependencies
====

Related documents
====
- http://xp-framework.net/rfc/contrib/rfc0137.diff
Patch implementing this rfc

Comments
====
- kiesel, Sun Sep 2 20:29:31 2007
This simplifies retrieving @test tags for unittests, which
is why I came to this.

- friebe, Sun Sep 2 20:52:12 2007
Maybe @test should be made an annotation in this case? These
are already retrievable by reflection at runtime...

- friebe, Wed Oct 10 21:38:58 2007
Reset to draft, I don't really like the idea of using apidoc
tags at runtime - as said, this is what annotations already
provide. Something like @tests(testone.name, testtwo.name)
also doesn't really make me happy, though...

- kiesel, Sat Oct 27 18:50:42 2007
Set status to rejected, this test-related information must be
retrieved some other way.