Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Already on GitHub? Sign in to your account

Have phpDocumentor fix @param tags in existing code #780

Open
mvriel opened this Issue Mar 22, 2013 · 2 comments

Comments

Projects
None yet
3 participants
Owner

mvriel commented Mar 22, 2013

This is a request by @MarkBaker sent in via Twitter: https://twitter.com/Mark_Baker/status/315035003903950848

At the moment phpDocumentor does not support the altering of existing code to improve code quality but this would of course not be impossible given that it has access to the source code and line numbers.

At this moment in time the phpDocumentor team focuses its efforts on fixing bugs and the generation of documentation, although this feature is wanted we probably do not get around to implementing this functionality within a short timespan. Contributions are of course welcomed and will help with this effort

Owner

ashnazg commented Mar 22, 2013

I'd at least require a runtime flag that toggles this behavior on, rather than defaulting it to on. Having us actually modify the source we're scanning is a touchy business ;-)

I certainly wouldn't consider this as anything other than an option that had to be explicitly enabled

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment