>  3. Standard "make; make install" for a P5EE module should produce man
> pages (perldoc),
>     html pages, PDF, and XML (for further flexible conversion/rendering)

I don't think this is a good idea. For me using the standard way as
MakeMaker does (i.e. pod & man) is ok for the default.

There should be another tool, that creates HTML/XML/PDF etc. which can be
run optional. This other tools would of course need extra information to
group documentaion together, to make a content page etc. This extra
information should be part of the module distribution.

Stas is currently writing such a tool for the mod_perl documentation. I plan
to extent it, especialy to be able to generate XML and do transformations
from there. If there is any interest I can present the result to list, when
it's done.... (will probably take two or three weeks)

Gerald

-------------------------------------------------------------
Gerald Richter    ecos electronic communication services gmbh
Internetconnect * Webserver/-design/-datenbanken * Consulting

Post:       Tulpenstrasse 5         D-55276 Dienheim b. Mainz
E-Mail:     [EMAIL PROTECTED]         Voice:    +49 6133 925131
WWW:        http://www.ecos.de      Fax:      +49 6133 925152
-------------------------------------------------------------


Reply via email to