Re: Documentation (Re: [PHPLIB-DEV] Changes to the CVS) From: Kristian Koehntopp (kris <email protected>)
Date: 04/14/00

On Fri, Apr 14, 2000 at 05:38:41AM +0200, Alexander Aulbach wrote:
> But there is a reason: I have no idea how to write the
> documention in sgml without a helping tool.

Don't know. I am using the same tool for HTML and PHP3 as for
SGML, the "joe" editor and a command line prompt plus a web
browser.

> PS: How about converting it to docbook?

Docbook is slow and complicated. On a 500 MHz Pentium 3 with 256
MB of RAM and a pure SCSI disk subsystem, it takes more than 20
minutes to convert the phpdoc/ subdirectory from Docbook SGML to
HTML. The machine is otherwise idle and the resulting HTML
directory is smaller than 5 megabytes. Performancewise this is a
joke, albeit a very bad one.

There is no way I am going to use such tools unless somebody
shows me how to speed this up by a factor of approximately 50.

Anyway, Linuxdoc format is SGML, you may as well use an XSLT
transformation to convert it to Docbook for you or convert it
back from Docbook into Linuxdoc if you want to work with Docbook
tools on it. I think the jade and the other tools come with XSLT
processors which are just as slow as the HTML generator, so this
should not be a problem.

Kristian

-
PHPLIB Developers Mailing List. Send messages to <phplib-dev <email protected>>.
To unsubscribe, send "unsubscribe" to <phplib-dev-request <email protected>> in
the body, not the subject, of your message.