Re: cvs: phpdoc /en/reference/array/functions array-combine.xml
| From: | Friedhelm Betz | Date: | Fri, 30 May 2003 17:27:54 +0000 |
| Subject: | Re: cvs: phpdoc /en/reference/array/functions array-combine.xml | ||
| References: | 1 2 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969354093@lists.php.net to get a copy of this message | ||
On Friday 30 May 2003 19:20, Gabor Hojtsy wrote:
> Hi!
>
> > I disagree with these changes and don't consider them
> > upgrades, I intentionally put the output in the
> > example as to make a clean cut-n-paste example. In
> > fact, there are times when I change it the other way
> > around :)
> >
> > Why do you feel using <screen> is "an upgrade"?
>
> I guess because that is somewhat in line with the guidelines, maybe...
> BTW I cannot find thic convention in the howto ;) But I remember to
> something like that. Anyway, I think this should be dealt with on a case
> by case basis. Sometimes it is OK to put the output into the code, and
> sometimes it is not.
Maybe from RFC/coding_standards:
<qoute>
E: EXAMPLE PRINTOUTS
For short example printouts, use a C++ style comment
on the line where the output occurs, or the next line,
where it is needed:
echo $var; // outputs: 32
For longer example printouts use the screen
container in conjunction with <![CDATA[... ]]>:
....
</quote>
I guess this never got int the howto....
Friedhelm