Hi,

> On Fri, 3 May 2002, Egon Schmid wrote:

>> From: "Simone Cortesi" <[EMAIL PROTECTED]>
>> > At 00.24 03/05/02 +0200, =?iso-8859-2?Q?S=B3awomir_Pucia?= wrote:
>> >
>> > >Probably you didn't get the point.
>> > >
>> > >Since 1.101 many examples look like...
>> > >
>> > ><?php
>> > >     /* Connecting, selecting database */
>> > >     $link = mysql_connect("mysql_host", "mysql_user",
>> "mysql_password")
>> > >         or die("Could not connect");
>> > >     print "Connected successfully";
>> > >[...]
>> > >
>> > >Until 1.101 they looked like...
>> > >
>> > ><?php
>> > >/* Connecting, selecting database */
>> > >$link = mysql_connect("mysql_host", "mysql_user",
>> "mysql_password")
>> > >     or die("Could not connect");
>> > >print "Connected successfully";
>> > >[...]
>> > >
>> > >The question is whether or not to use these 4 spaces in each
>> line. If yes, I
>> > >will correct the rest of mysql related files, and use it in pl/.
>> >
>> > I've read that we should start at column 1 in examples:
>> >
>> > Take a look at: /phpdoc/RFC/coding_standards
>> 
>> Oh, it seems that Derick havenīt read the coding_standards :(

> Oh, btw, it sais "3. The contents of examples with programlistings start 
> on column 0 in the XML code." IMO <?php is also code, and just like { or } 
> and thus need indentation, but that is my opinion. ANyway, I think 
> indenting everything with four spaces adds a lot to readbility in code, as 
> your left margin is usually the most left pixel of your screen. 

Hey, it was me who collected some mails from the list and from the
howto. This coding_standard in RFC is only a draft and starting point for
discussions. Once a descision is made (if ever), the things should go into the
howto. So far I understand this RFC directory....:-)

>From the protocol of the meeting in Stuttgart:
17. Examples
The examples in the manual should be more consistent and useful. A
draft styleguide alredy exists under phpdoc/RFC/coding_standards.

"officially" identation is not descided...... :-)
If the examples are more useful with identation everything it's ok,
why not?
The only thing to keep in mind is: there are some examples with very
long lines and ident everything (also <?php) could probably break the
layout.

What about starting with <?php at column 2 and ident everything else
with 4 spaces?

 Friedhelm                           

Reply via email to