Re: XML:DocBook:peardoc2 is 100% functional
| From: | Jesus M. Castagnetto | Date: | Wed, 25 Dec 2002 21:54:50 +0000 |
| Subject: | Re: XML:DocBook:peardoc2 is 100% functional | ||
| References: | 1 | Groups: | php.pear.dev php.pear.doc |
| Request: | Send a blank email to pear-dev+get-11833@lists.php.net to get a copy of this message | ||
Just downloaded phpdoc-20021225.tar.gz, the only problem I've seen on a cursory
check of the DocBook output, is that the entities referred to in the top XML
files are missing a semicolon.
For example, I run it on PEAR::Message and in the file "Message/common-php.xml"
I see the entity "&package.Message.common-php-summary" (not the semicolon
missing)
Also, the new form interface to generate the documentation does not work in my
old Opera at home (5.0 for Linux, using RH 6.1). The dir tree part seems to
have some problems. The old form works like a charm.
--- Greg Beaver <greg@chiaraquartet.net> wrote:
> Hello all,
>
> After a bit of work today, I am pleased to let you all know that
> phpDocumentor's new XMLDocBookConverter's peardoc2 templates are fully
> functional. Support for tutorials is also fully functional in all active
> converters.
>
> Incidentally, work on the CHM converter has been postponed for a little
> while, but may make it into the next release, we'll see.
>
> the output from the peardoc2 templates needs testing, and lots of it. If
> you have a desire to see this addition to phpDocumentor, please download a
> cvs snapshot from:
>
> http://developer.phpdoc.org/downloads
>
> Note that today's work won't show up until tomorrow's snapshot, which is
> taken some time tonight. Please also note that the stringent requirements
> of peardoc2 may force a few projects to write better in-code comments if
> they wish to use this facility. phpDocumentor can't make good documentation
> from poor commenting. Think of it as a source of inspiration: you can have
> great peardoc2/html/pdf manuals from one source, and that equals less work!
>
> Take care,
> Greg
>
>
>
> --
> PEAR Development Mailing List (http://pear.php.net/)
> To unsubscribe, visit: http://www.php.net/unsub.php
>
=====
--- Jesus M. Castagnetto (jcastagnetto@yahoo.com)
Research:
http://metallo.scripps.edu/
Personal: http://www.castagnetto.org/
__________________________________________________
Do you Yahoo!?
Yahoo! Mail Plus - Powerful. Affordable. Sign up now.
http://mailplus.yahoo.com