Re: reStructuredText (was: RE: [PEAR-DEV] Net_SMTP user's guide)
| From: | Martin Jansen | Date: | Wed, 11 Jun 2003 21:07:32 +0000 |
| Subject: | Re: reStructuredText (was: RE: [PEAR-DEV] Net_SMTP user's guide) | ||
| References: | 1 2 3 4 5 6 7 8 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-17330@lists.php.net to get a copy of this message | ||
On Wed Jun 11, 2003 at 10:4531PM +0200, Pierre-Alain Joye wrote:
> On Wed, 11 Jun 2003 22:32:55 +0200
> Martin Jansen <mj@php.net> wrote:
> > Using phpDocumentor for *all* documentation related topics still
> > implies for me that the documentation (usage examples, tutorials) will
> > be stored within the source code. This definitively isn't optimal.
>
> 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?
--
- Martin Martin Jansen
http://martinjansen.com/