Re: Writing PEAR documentation with DocBook on win32
| From: | anatoly techtonik | Date: | Sat, 06 Aug 2005 16:50:18 +0000 |
| Subject: | Re: Writing PEAR documentation with DocBook on win32 | ||
| References: | 1 | Groups: | php.pear.doc |
| Request: | Send a blank email to pear-doc+get-6600@lists.php.net to get a copy of this message | ||
Hello Laurent,
LL> I've begun to write doc for HTML_Progress2 and
LL> HTML_QuickForm_advmultiselect following the famous DocBook: The
LL> Definitive Guide [2].
LL> 1. Is there any tag that are not supported on PEAR Manual generation
LL> (forbidden) ?
No, there are no forbidden tags, but there are many tags, which are not
supported by our stylesheets. You may want to look at ready documentation
on CVS and follow it style. And always do "make test" before submitting
your work.
LL> 2. Can we add media such images ?
No. AFAIR there's no mechanizm in docbook to copy your images to target
directory (i.e. into distribution) and in documentation build process
also. Additionally media such as images will make downloadable manual
bigger.
LL> 3. What is the time limit to publish in CVS the xml files before the
LL> sunday publish ?
Monday-Saturday. =)
--
anatoly