Re: reStructuredText
| From: | Pierre-Alain Joye | Date: | Thu, 12 Jun 2003 18:20:17 +0000 |
| Subject: | Re: reStructuredText | ||
| References: | 1 2 3 4 5 6 7 8 9 10 11 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-17360@lists.php.net to get a copy of this message | ||
On Thu, 12 Jun 2003 20:15:52 +0200
Martin Jansen <mj@php.net> wrote:
> What is the problem with a reST -> Docbook parser? This way we can
> easily import the documentation written in reST into the manual and we
> have a easy-to-use format for the developers. => No need to leave
> Docbook.
yes
> Tell me a format that has no 'specific syntax'.
Tell me a tool to edit reST as we should do it with some office tools or
with future version of bitflux?
> I guess everybody agrees with you that phpDocumentor is great for API
> documentation. But why do you fail to see that API documentation and
> end-user documentation are different things? I don't think that
> "controlling" the end-user documentation in the API documentation is a
> good thing.
Please, *read* the phpdocumentor documentation and come back :)
> Jon already posted a link for Docbook converter.
Python, do I have to remember you the phpdoc history? why depends of
python as we have all in hands to do it with php? I really wonder why.
pierre