Re: PEAR documentation and PhpDocumentor
| From: | Greg Beaver | Date: | Wed, 10 Sep 2003 21:22:40 +0000 |
| Subject: | Re: PEAR documentation and PhpDocumentor | ||
| References: | 1 2 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-21380@lists.php.net to get a copy of this message | ||
Tomas V.V.Cox wrote:
No. I did know that it could generate API Docs in many formats. But that's not enought for decent documentation. If you read the phpdocumentor manual: "How to write phpDocumentor-style tutorials/extended documentation Tutorials may be written as any legal DocBook top-level tag (<book>, <chapter>, <article>, <refentry>), but it is highly recommended for any project that may become a part of PEAR to write with the <refentry> tag as the top-level, as this will automatically translate into peardoc2-ready tutorials." So I assume it is not a tool for creating tutorials or introduction sections.This took me a while to wrap my brain around, but I think I understand now - do you mean a text editor that allows easy creation of docbook without having to know the tags for things? Greg