[PHP-DOC] Re: From: Jirka Kosek (jirka <email protected>)
Date: 10/16/01

Egon Schmid wrote:

> > > > Only drawback is that
> > > > your documents would not be DocBook DTD compliant. But if you
> don't send
> > > > your source document outside of phpdoc group there wouldn't be
> problems
> > > > with it.
>
> Correct, but what is with the peoples inside the phpdoc group?

Currently DocBook DTD is in CVS together with XML files and build
scripts. Adding customization to repository would mean that everyone
using phpdoc from CVS could use customization without any additional
setup steps.
 
> > > With a role attribute we can specify that this is a seealso
> > > para. For style sheets not customized for this role,
> > > that would be a normal _para_. For style sheets not customized
> > > for a new tag, that would be a _problem_...
>
> A new tag (or element) results only in errors and there will be no
> rendering.

But who uses phpdoc XML sources with other than provided customized
stylesheets?
 
> Publishers can do that for own purposes. The PHP documentation is an
> international effort and we donīt need to change the DocBook DTD.
> Any help to customize the stylesheets are welcome.

I already sent some patch to support <pre class="php"> in HTML output.
If you tell me how precisely you want render <para role="seealso"> I can
modify this also. I personally prefer XSLT, but this is way to improve
myself in DSSSL.

                                Jirka

-----------------------------------------------------------------
  Jirka Kosek
  e-mail: jirka <email protected>
  http://www.kosek.cz