Re: Update: phpDocumentor development

> 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. > > The peardoc2 converter is now at about 95% complete. The biggest stumbling > blocks were recently solved. The spec for phpDocumentor's descriptions > allows certain html tags for formatting such as <b>, <i>, <ul>, etc. This > required parsing the long description and replacing these with their docbook > equivalents, as well as parsing out paragraphs. Using a derivative of the > parser that phpDocumentor uses to parse php and a new options.ini file for > every template, this problem was solved. The other larger problem involved > a new DocBook format for package-level docs (tutorials would go there). > 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. Cool, that will be a great help ! It enable us to spend more time writing tutorials ;)