On 29/04/16 10:42, Rowan Collins wrote: > Lester Caine wrote on 29/04/2016 10:17: >> And it would be nice if you actually checked out just how phpdocumentor1 >> worked and explain why I can't produce >> http://lsces.org.uk/bitweaverdocsPHP/index.html with phpDocumentor2 ... > > The simple fact is that this is completely off-topic for this list. > > You are free to use whatever documentation generator you want if > phpDocumentor2 doesn't suit your needs, including phpDocumentor1, or one > of these (found in 5 minutes using DuckDuckGo): > - http://www.apigen.org/ > - > http://fabien.potencier.org/sami-yet-another-php-api-documentation-generator.html > > - http://www.stack.nl/~dimitri/doxygen/index.html > - http://phpdox.net/ > > I'm not sure what it is specifically that you can't do in > phpDocumentor2, and whether you've discussed it with the maintainer > already as to why they've changed it. If you need to support extra > docblock annotations not supported by any of those tools, I'm sure you > could figure out how to customise one of them, and create a fork, or a > Pull Request, or a plugin. > > Again, this has nothing to do with the core language.
In my book this is DIRECTLY relevant to the current discussion! We have been adding attributes via docBloc annotation since PHP4 days. This has partly been accepted as the default way of doing it and phpDoc was originally part of the PEAR support structure. A large section of legacy code has well written phpDoc annotation and simply adding the current requested attributes to that platform creates no work in the core code. It may well be that things have now gone too far, and what is needed is a replacement for phpDoc built into the code, in which case it should replace ALL of the annotation rather than cherry picking parts and ignoring key elements that don't fit the current style of working ... -- Lester Caine - G8HFL ----------------------------- Contact - http://lsces.co.uk/wiki/?page=contact L.S.Caine Electronic Services - http://lsces.co.uk EnquirySolve - http://enquirysolve.com/ Model Engineers Digital Workshop - http://medw.co.uk Rainbow Digital Media - http://rainbowdigitalmedia.co.uk -- PHP Internals - PHP Runtime Development Mailing List To unsubscribe, visit: http://www.php.net/unsub.php
