Re: [PHP-DOC] How to use programlisting? From: Damien Seguy (damien.seguy <email protected>)
Date: 01/08/01

Hi,

> We should probably remove the version-specific ones, en masse,
> as the syntax between 3 and 4 didn't change much (at all?)
> as far as docbook/jade are concerned, did it?
Sounds OK to me.

> Just to question/clarify:
> If you showed a perl/tcl/asp script (for php/perl/tcl/asp comparison reasons),
> how should it be documented? (I'm wondering what we're doing with "everything
> else"). <programlisting> </programlisting> ?
In my last mail, I suggested to keep the following roles : php, php.ini,
html and shell. All others should be removed. This approach is pretty based
on "how many times to we need such a role", and it leads directly to :
"everything else" => no role.

Now, one question I'd like to ask to Jade/DSSL guru is : what was the "role"
attribut made for? As much as I can see, no special processing is based on
this attribute, so basically, this is RFU (reserved for future use). But I
may be wrong.

> <computeroutput> 272 occurances
> <screen> 129 occurances
> Is there a reason for using two different ones?
I don't think so, and I'd suggest the <screen> removal. If anyone object,
I can take care of it. Anyone with a better idea?

Best regards,
Damien Seguy.