Re: Update: phpDocumentor development

On Sat, 30 Nov 2002 23:38:30 -0500 "Greg Beaver" <greg@chiaraquartet.net> wrote: > Hello all, > > There have been some issues with the PEAR release of phpDocumentor due > to problems in pear.in for windows which render the project unusable > without minor adjustments. These problems have been fixed and will be > available with the next release. In the meantime, a clean install > from http://www.phpdoc.org will work until the PEAR release is > fixed > up. What kind of problem did you get with pear.in under windows ? There is a known bug due to php constants, which will be hopefully solved with the 4.3.0 release. But basically, it is easier to fix manually. The main problem I have with phpDocumentor is the name of the command, which is the same as the PHPDoc (phpdoc), which make impossible to install the both packages. > The other larger problem involved a new DocBook > format for package-level docs (tutorials would go there). How do you plan the use of phpDocumentor for the creation of tutorials ? My favourite idea for this purpose is to allow people to use their favourite word processing tools and convert it to docbook. This is the way I choose for DocConvert. That makes the work easier for the authors as well for the translators. > Currently, the spec calls for html-format package-level docs, but html > is not rigorous enough to convert back into DocBook reliably. By > allowing a subset of DocBook tags (basically everything but the table > tags), it is possible to use the same derivative parser with a few > changes to parse DocBook-style package pages and spit out html-ready > or pdf-ready package pages. html-ready or pdf-ready, or, xxxx-ready in any case ? In others words, is it one or another format and not a generic format ? I should help you on the tutorials parts, which I consider as a real separate need. I do not know if you solved the package.xml issue, my last test to install it failed. I may help you too here, and make it a little more clean and reliable (using dir or install-as when needed). hth pierre