Re: PEAR documentation and PhpDocumentor
| From: | Jon Parise | Date: | Wed, 10 Sep 2003 04:48:42 +0000 |
| Subject: | Re: PEAR documentation and PhpDocumentor | ||
| References: | 1 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-21322@lists.php.net to get a copy of this message | ||
On Wed, Sep 10, 2003 at 12:12:05AM -0400, Greg Beaver wrote:
> I'm very confused right now - is there a way that I can more clearly
> state that you can generate the exact DocBook needed for the
> pear.php.net manual using phpDocumentor?
>
> I keep running into more and more features of phpDocumentor that I've
> advertised repeatedly which nobody seems to have any idea exists :).
>
> This is frustrating, because that is in essence a documentation problem
> on my part. So, if any of you have any suggestions, I'd like to get
> that fixed right away.
No, you've done a fine job in advertisting the abilities of
phpDocumentator, especially in this respect. I've been aware of its
DocBook capabilities for quite some time.
One of the main problems that I have with DocBook (and that can't be
solve by phpDocumentator) is the goofy toolchain that I need to
construct in order to render the XML source into a readable format.
And once the toolchain is in place, I need to wait a few minutes to
build the complete PEAR Manual in order to verify whether the
hyperlink I just added actually works.
--
Jon Parise (jon@php.net) :: The PHP Project (http://www.php.net/)