Re: reStructuredText (was: RE: [PEAR-DEV] Net_SMTP user's guide)
| From: | Pierre-Alain Joye | Date: | Wed, 11 Jun 2003 21:16:55 +0000 |
| Subject: | Re: reStructuredText (was: RE: [PEAR-DEV] Net_SMTP user's guide) | ||
| References: | 1 2 3 4 5 6 7 8 9 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-17331@lists.php.net to get a copy of this message | ||
On Wed, 11 Jun 2003 23:07:32 +0200
Martin Jansen <mj@php.net> wrote:
> > You may look again at phpDocumentor. You will see there is something
> > about general documentations and not inline docs. Using only it
> > allows us to make link from the inline docs to outline
> > documentations/tutorials.
>
> In which format will this external documentation be written? Is it
> interchangeable, so that we can easily export it to Docbook, PDF or
> HTML?
http://phpdoc.org/docs/HTMLSmartyConverter/default/phpDocumentor/tutorial_tutorials.pkg.html
You should definitively look at phpdocumentor. It takes care of *all*
conversions. And it should be not that difficult to add more converters
(well, not hard, but long sometimes ;).
Btw, we already have this exact discussions :), I hope we'll find the
way this time :).
pierre