Re: How to use programlisting?
| From: | Damien Seguy | Date: | Mon, 08 Jan 2001 09:08:08 +0000 |
| Subject: | Re: How to use programlisting? | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969333483@lists.php.net to get a copy of this message | ||
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.