Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
On Wed, 13 Mar 2002, Marco Cucinato wrote: > cucinato Wed Mar 13 12:23:30 2002 EDT > > Modified files: > /phpdoc/en/functions array.xml > Log: > Typo fix That's what you get when working in trains :) Derick > > > Index: phpdoc/en/functions/array.xml > diff -u phpdoc/en/functions/array.xml:1.163 phpdoc/en/functions/array.xml:1.164 > --- phpdoc/en/functions/array.xml:1.163 Mon Mar 11 19:45:09 2002 > +++ phpdoc/en/functions/array.xml Wed Mar 13 12:23:30 2002 > @@ -1,5 +1,5 @@ > > - > + > >Array Functions >Arrays > @@ -57,7 +57,7 @@ > > CASE_UPPER and CASE_LOWER are > used with the array_change_key_case function. They > - respectively are used for chaning a string to upper case or lower case. > + respectively are used for changing a string to upper case or lower case. > > > > > -- PHP: Scripting the Web - [EMAIL PROTECTED] All your branches are belong to me! SRM: Site Resource Manager - www.vl-srm.net ---
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml crack.xml
On Tue, 2002-03-12 at 03:10, Gabor Hojtsy wrote: > > > > > > See also > > > > > > > > > See also is_array, > > > explode, > > > implode, split, > > > and join. > > > > > > > > > > > > > > > > What about ? Easy enough to > > process. But even the example you have above doesn't look bad to me, > > since the seealso has to be inside a anyway at that point, > > and it does make sense. > > Well, I don't like this above, because you have see also in > the section id, in the section title, in the note role and > in the para text. Huh. It would be nice to have a simple > container tag for this, but I guess this is impossible > with docbook... > > Goba Well, yeah, but every one of those is optional--especially the para text. I was speaking more to the fact that there was a note inside a section, not the specifics of the example. What I meant by my first sentence was: See also . . .functions. . . i.e. just make play this role here. -- Torben Wilson <[EMAIL PROTECTED]> http://www.thebuttlesschaps.com http://www.hybrid17.com http://www.inflatableeye.com +1.604.709.0506
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml crack.xml
> > > > See also > > > > > > See also is_array, > > explode, > > implode, split, > > and join. > > > > > > > > > > What about ? Easy enough to > process. But even the example you have above doesn't look bad to me, > since the seealso has to be inside a anyway at that point, > and it does make sense. Well, I don't like this above, because you have see also in the section id, in the section title, in the note role and in the para text. Huh. It would be nice to have a simple container tag for this, but I guess this is impossible with docbook... Goba
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml crack.xml
On Tue, 2002-03-12 at 01:52, Gabor Hojtsy wrote: > > I added this to crosslink the array functions to functions from other > > sections. > > Ah, I ckecked array.xml. This see also part is for the partintro. > Well, it would be nice to come up with a good structure for > see alsos in function descriptions and partintros. > > This would be a "bit" too cluttered (using the note we invented > before for see also blocks): > > > See also > > > See also is_array, > explode, > implode, split, > and join. > > > > > Better ideas, anyone? > > Goba What about ? Easy enough to process. But even the example you have above doesn't look bad to me, since the seealso has to be inside a anyway at that point, and it does make sense. -- Torben Wilson <[EMAIL PROTECTED]> http://www.thebuttlesschaps.com http://www.hybrid17.com http://www.inflatableeye.com +1.604.709.0506
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml crack.xml
On Tue, 2002-03-12 at 01:53, Gabor Hojtsy wrote: > > > What? We do not have sections like this for see also lists > > > anywhere... We have but it is also not > > > used anywhere. We have see also lists written as > > > See also: > > > > > > Goba > > > > Yeah, I know. But it looked like Derick had something bigger in > > mind and I wanted to meet two primary criteria: 1) not fuck with > > what seemed to be the general idea, and 2) compile. I figured we'd > > work out the details after that. Maybe this was something which was > > discussed at the meeting? :) > > Well, we've not discussed the actual tags to use, but the > concept is what Derick introduced. It will become a de facto > standard this way. I really like the divisions, but we need > to have the see also lists standard in partintros and function > pages... > > Goba I agree 100% with all of that. But section was the only valid element at that point, and I neglected to remember the recently discussed standard. :/ I'll try to think of a better solution. -- Torben Wilson <[EMAIL PROTECTED]> http://www.thebuttlesschaps.com http://www.hybrid17.com http://www.inflatableeye.com +1.604.709.0506
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml crack.xml
> > What? We do not have sections like this for see also lists > > anywhere... We have but it is also not > > used anywhere. We have see also lists written as > > See also: > > > > Goba > > Yeah, I know. But it looked like Derick had something bigger in > mind and I wanted to meet two primary criteria: 1) not fuck with > what seemed to be the general idea, and 2) compile. I figured we'd > work out the details after that. Maybe this was something which was > discussed at the meeting? :) Well, we've not discussed the actual tags to use, but the concept is what Derick introduced. It will become a de facto standard this way. I really like the divisions, but we need to have the see also lists standard in partintros and function pages... Goba
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml crack.xml
> > > + > > > +See also > > > + > > > + See also is_array, > > explode, > > > + implode, split, > > > + and join. > > > + > > > + > > > > What? We do not have sections like this for see also lists > > anywhere... We have but it is also not > > used anywhere. We have see also lists written as > > See also: > > I added this to crosslink the array functions to functions from other > sections. Ah, I ckecked array.xml. This see also part is for the partintro. Well, it would be nice to come up with a good structure for see alsos in function descriptions and partintros. This would be a "bit" too cluttered (using the note we invented before for see also blocks): See also See also is_array, explode, implode, split, and join. Better ideas, anyone? Goba
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml crack.xml
On Tue, 2002-03-12 at 01:10, Gabor Hojtsy wrote: > > Modified files: > > /phpdoc/en/functions array.xml crack.xml > > Log: > > > > 'make test' didn't like these. > > > + > > +See also > > + > > + See also is_array, > explode, > > + implode, split, > > + and join. > > + > > + > > What? We do not have sections like this for see also lists > anywhere... We have but it is also not > used anywhere. We have see also lists written as > See also: > > Goba Yeah, I know. But it looked like Derick had something bigger in mind and I wanted to meet two primary criteria: 1) not fuck with what seemed to be the general idea, and 2) compile. I figured we'd work out the details after that. Maybe this was something which was discussed at the meeting? :) -- Torben Wilson <[EMAIL PROTECTED]> http://www.thebuttlesschaps.com http://www.hybrid17.com http://www.inflatableeye.com +1.604.709.0506
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml crack.xml
On Tue, 12 Mar 2002, Gabor Hojtsy wrote: > > Modified files: > > /phpdoc/en/functions array.xml crack.xml > > Log: > > > > 'make test' didn't like these. > > > + > > +See also > > + > > + See also is_array, > explode, > > + implode, split, > > + and join. > > + > > + > > What? We do not have sections like this for see also lists > anywhere... We have but it is also not > used anywhere. We have see also lists written as > See also: I added this to crosslink the array functions to functions from other sections. Derick -- PHP: Scripting the Web - [EMAIL PROTECTED] All your branches are belong to me! SRM: Site Resource Manager - www.vl-srm.net ---
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml crack.xml
> Modified files: > /phpdoc/en/functions array.xml crack.xml > Log: > > 'make test' didn't like these. > + > +See also > + > + See also is_array, explode, > + implode, split, > + and join. > + > + What? We do not have sections like this for see also lists anywhere... We have but it is also not used anywhere. We have see also lists written as See also: Goba
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml crack.xml
On Tue, 12 Mar 2002, Torben Wilson wrote: > torbenMon Mar 11 19:45:09 2002 EDT > > Modified files: > /phpdoc/en/functions array.xml crack.xml > Log: > > 'make test' didn't like these. The famous phrase "test before commit" pops up in my head :) Derick > > > > Index: phpdoc/en/functions/array.xml > diff -u phpdoc/en/functions/array.xml:1.162 phpdoc/en/functions/array.xml:1.163 > --- phpdoc/en/functions/array.xml:1.162 Mon Mar 11 02:30:19 2002 > +++ phpdoc/en/functions/array.xml Mon Mar 11 19:45:09 2002 > @@ -1,5 +1,5 @@ > > - > + > >Array Functions >Arrays > @@ -61,11 +61,14 @@ > > > > - > -See also is_array, explode, > -implode, split, > -and join. > - > + > +See also > + > + See also is_array, explode, > + implode, split, > + and join. > + > + > > > > Index: phpdoc/en/functions/crack.xml > diff -u phpdoc/en/functions/crack.xml:1.8 phpdoc/en/functions/crack.xml:1.9 > --- phpdoc/en/functions/crack.xml:1.8 Mon Mar 11 02:30:20 2002 > +++ phpdoc/en/functions/crack.xml Mon Mar 11 19:45:09 2002 > @@ -1,5 +1,5 @@ > > - > + > >Crack functions >Crack functions > @@ -84,6 +84,7 @@ >crack_getlastmessage will return 'strong password'. > > > + > > > > > -- PHP: Scripting the Web - [EMAIL PROTECTED] All your branches are belong to me! SRM: Site Resource Manager - www.vl-srm.net ---
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
Zak Greant writes: > On 2002-6-01 16:50, Hartmut Holzgraefe wrote: > > Egon Schmid wrote: > > > The rules in English are the following: > > > > > > See also func1 and func2. > > > See also func1, func2, and func3. > > > See also func1, func2, func3, and func4. > > > > that what the university of Chicago manual of style says, > > but otoh the university of Montana style guide says > > > > Omit the comma between the last two items in a series unless > > needed for clarity: "John, Mona and Sharon came to my party" > > > >( http://www.umt.edu/urelations/style/apxa.htm ) > > > > most native speakers i asked also prefered the second form ... > > > > does anyone have a *definitive* answer on this topic? > > Both forms are perfectly acceptable. I also prefer the second form > but use of the first form is probably more sensible. Proper use of > the second form can require subtle understanding of English, while the > first form is correct (if somewhat formal) in all cases. +1 > -- > Zak Greant > > PHP Quality Assurance Team > http://qa.php.net/ > > "We must be the change we wish to see." - M. K. Ghandi > -- Torben Wilson <[EMAIL PROTECTED]> http://www.thebuttlesschaps.com http://www.hybrid17.com http://www.inflatableeye.com +1.604.709.0506
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
On 2002-6-01 16:50, Hartmut Holzgraefe wrote: > Egon Schmid wrote: > > The rules in English are the following: > > > > See also func1 and func2. > > See also func1, func2, and func3. > > See also func1, func2, func3, and func4. > > that what the university of Chicago manual of style says, > but otoh the university of Montana style guide says > > Omit the comma between the last two items in a series unless > needed for clarity: "John, Mona and Sharon came to my party" > >( http://www.umt.edu/urelations/style/apxa.htm ) > > most native speakers i asked also prefered the second form ... > > does anyone have a *definitive* answer on this topic? Both forms are perfectly acceptable. I also prefer the second form but use of the first form is probably more sensible. Proper use of the second form can require subtle understanding of English, while the first form is correct (if somewhat formal) in all cases. -- Zak Greant PHP Quality Assurance Team http://qa.php.net/ "We must be the change we wish to see." - M. K. Ghandi
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
Hartmut Holzgraefe <[EMAIL PROTECTED]> wrote: > does anyone have a *definitive* answer on this topic? for english? there's no such thing. it really doesn't matter that much. jim
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
Egon Schmid wrote: > The rules in English are the following: > > See also func1 and func2. > See also func1, func2, and func3. > See also func1, func2, func3, and func4. > that what the university of Chicago manual of style says, but otoh the university of Montana style guide says Omit the comma between the last two items in a series unless needed for clarity: "John, Mona and Sharon came to my party" ( http://www.umt.edu/urelations/style/apxa.htm ) most native speakers i asked also prefered the second form ... does anyone have a *definitive* answer on this topic?
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
From: "Papp Gyozo" <[EMAIL PROTECTED]> > From: "Egon Schmid" <[EMAIL PROTECTED]> > Subject: Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml > > | From: "Gyozo Papp" <[EMAIL PROTECTED]> > | > | > pgerzson Fri Jan 4 09:34:02 2002 EDT > | > > | > Modified files: > | > /phpdoc/en/functions array.xml > | > Log: > | > correct "See also" cross references and exampe outputs for > | several functions > | > and array_unique note on preserving keys > | > | Oh, I haven´t understood what you said about the comma. The rules in > | English are the following: > > Did I say anything about commas? ;) You're right I removed several > commas without notice. > > | See also func1 and func2. > | See also func1, func2, and func3. > | See also func1, func2, func3, and func4. > > Please forgive my ignorance, I haven't known this rule in English yet. > (about comma usage in enumaration). I have only one excuse that > in Hungarian there should not be used comma and any conjuction such as > 'and' together. Yes, Hungarian and German is different from English :) -Egon
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
From: "Egon Schmid" <[EMAIL PROTECTED]> Subject: Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml | From: "Gyozo Papp" <[EMAIL PROTECTED]> | | > pgerzson Fri Jan 4 09:34:02 2002 EDT | > | > Modified files: | > /phpdoc/en/functions array.xml | > Log: | > correct "See also" cross references and exampe outputs for | several functions | > and array_unique note on preserving keys | | Oh, I haven´t understood what you said about the comma. The rules in | English are the following: Did I say anything about commas? ;) You're right I removed several commas without notice. | | See also func1 and func2. | See also func1, func2, and func3. | See also func1, func2, func3, and func4. Please forgive my ignorance, I haven't known this rule in English yet. (about comma usage in enumaration). I have only one excuse that in Hungarian there should not be used comma and any conjuction such as 'and' together. | | I have looked at the diff and I have seen another minor | incorrectness. The space between "and" and "" have | sometimes removed. The rendering would look like this (see the last | change line): | | ... andrsort(). | OK, I'll correct it and commit again.
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
From: "Gyozo Papp" <[EMAIL PROTECTED]> > pgerzson Fri Jan 4 09:34:02 2002 EDT > > Modified files: > /phpdoc/en/functions array.xml > Log: > correct "See also" cross references and exampe outputs for several functions > and array_unique note on preserving keys Oh, I haven´t understood what you said about the comma. The rules in English are the following: See also func1 and func2. See also func1, func2, and func3. See also func1, func2, func3, and func4. I have looked at the diff and I have seen another minor incorrectness. The space between "and" and "" have sometimes removed. The rendering would look like this (see the last change line): ... andrsort(). -Egon
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
Hi, you were of course right, and was "a little" scatter-brained yesterday, sorry (and thanks for the fast revert!). Cu, Thomas Derick Rethans wrote: > On Tue, 20 Nov 2001, Gabor Hojtsy wrote: > > > comitted... I think a revert is needed here... > > I already did that. > > Derick
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
> > - The name of this function is key_exists > > - in PHP version 4.0.6. > > + This function was introduced in PHP 4.0.6. > > Hrm. This clarification is not a clarification. The meaning of > the sentence is lost. There is no need to have this sentece > here, because the info is in the compatibility part generated > by Hartmut (and put automatically below function names). So > the information in that sentence was, that the function was > not names array_key_exists in 4.0.6... Not the same, you > comitted... I think a revert is needed here... Derick already reverted it, so no action is required on your part Thomas. Goba
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
On Tue, 20 Nov 2001, Gabor Hojtsy wrote: > comitted... I think a revert is needed here... I already did that. Derick
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
> - The name of this function is key_exists > - in PHP version 4.0.6. > + This function was introduced in PHP 4.0.6. Hrm. This clarification is not a clarification. The meaning of the sentence is lost. There is no need to have this sentece here, because the info is in the compatibility part generated by Hartmut (and put automatically below function names). So the information in that sentence was, that the function was not names array_key_exists in 4.0.6... Not the same, you comitted... I think a revert is needed here... Goba
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
Derick Rethans writes: > Hello Torben, > > afaik, this function was only added in php 4.0.6, so my statement was > correct IMO. > > Derick IMO as well, now that I devote two more brain cells to the task. My mistake. Whoops. Torben > On Thu, 15 Nov 2001, Torben Wilson wrote: > > > torben Thu Nov 15 02:39:59 2001 EDT > > > > Modified files: > > /phpdoc/en/functionsarray.xml > > Log: > > > > Small clarification. > > > > > > Index: phpdoc/en/functions/array.xml > > diff -u phpdoc/en/functions/array.xml:1.120 phpdoc/en/functions/array.xml:1.121 > > --- phpdoc/en/functions/array.xml:1.120 Thu Nov 15 02:29:51 2001 > > +++ phpdoc/en/functions/array.xml Thu Nov 15 02:39:59 2001 > > @@ -1,5 +1,5 @@ > > > > - > > + > > > >Array Functions > >Arrays > > @@ -604,7 +604,7 @@ > > > > > >The name of this function is key_exists > > - in PHP version 4.0.6. > > + in PHP versions earlier than 4.0.6. > > > > > > > > > > > > Derick Rethans > > - > PHP: Scripting the Web - www.php.net - [EMAIL PROTECTED] > SRM: Site Resource Manager - www.vl-srm.net > - -- Torben Wilson <[EMAIL PROTECTED]> http://www.thebuttlesschaps.com +1.604.709.0506
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
Hello Torben, afaik, this function was only added in php 4.0.6, so my statement was correct IMO. Derick On Thu, 15 Nov 2001, Torben Wilson wrote: > torbenThu Nov 15 02:39:59 2001 EDT > > Modified files: > /phpdoc/en/functions array.xml > Log: > > Small clarification. > > > Index: phpdoc/en/functions/array.xml > diff -u phpdoc/en/functions/array.xml:1.120 phpdoc/en/functions/array.xml:1.121 > --- phpdoc/en/functions/array.xml:1.120 Thu Nov 15 02:29:51 2001 > +++ phpdoc/en/functions/array.xml Thu Nov 15 02:39:59 2001 > @@ -1,5 +1,5 @@ > > - > + > >Array Functions >Arrays > @@ -604,7 +604,7 @@ > > >The name of this function is key_exists > - in PHP version 4.0.6. > + in PHP versions earlier than 4.0.6. > > > > > Derick Rethans - PHP: Scripting the Web - www.php.net - [EMAIL PROTECTED] SRM: Site Resource Manager - www.vl-srm.net -
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
> > > eschmid Sat Sep 15 19:47:45 2001 EDT > > > > > > Modified files: > > > /phpdoc/en/functions array.xml > > > Log: > > > Whitespace and some typos. > > > > Can you repeat, what is advised about WS and > > other fixes in the README? > > Please read the diff. Some examples: -Filters elements of an array using a callback function + + Filters elements of an array using a callback function + -Implementation of array_keys for PHP 3 -users + Implementation of array_keys for PHP 3 + users -Applies the callback to the elements of the given arrays + + Applies the callback to the elements of the given arrays + - array_multisort, and uksort. + array_multisort, and + uksort. Well, there were many WS like fixes, where you eg. introduced PEAR standards, I can see, but the above extrations (and there are many more of them) were only TRUE ws only fixes. Please try to follow this guideline, contained in the README in the future. Many Thanks, Goba
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
- Original Message - From: "Hojtsy Gabor" <[EMAIL PROTECTED]> To: "Egon Schmid" <[EMAIL PROTECTED]>; "PHP-Doc list" <[EMAIL PROTECTED]> Sent: Sunday, September 16, 2001 11:17 AM Subject: Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml > > eschmid Sat Sep 15 19:47:45 2001 EDT > > > > Modified files: > > /phpdoc/en/functions array.xml > > Log: > > Whitespace and some typos. > > Can you repeat, what is advised about WS and > other fixes in the README? Please read the diff. -Egon
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
> eschmid Sat Sep 15 19:47:45 2001 EDT > > Modified files: > /phpdoc/en/functions array.xml > Log: > Whitespace and some typos. Can you repeat, what is advised about WS and other fixes in the README? Goba
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
on 10/07/01 03:10, Rasmus Lerdorf at [EMAIL PROTECTED] wrote: Hi Rasmus, > rasmus Mon Jul 9 21:10:36 2001 EDT > > Modified files: > /phpdoc/en/functions array.xml > Log: > Add note toi range() function Can you add some PHP version's indication? or was this available since ages, but not documented? Best regards, Damien Seguy
Re: [PHP-DOC] cvs: phpdoc /en/functions array.xml
Doh! Sorry about that. It was a quick change and I didn't even do a 'make
test'. I already knew that.. just left my brain at home today.
Daniel
- Original Message -
From: "Egon Schmid" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>
Sent: Monday, July 02, 2001 2:44 PM
Subject: [PHP-DOC] cvs: phpdoc /en/functions array.xml
> eschmid Mon Jul 2 15:44:45 2001 EDT
>
> Modified files:
> /phpdoc/en/functions array.xml
> Log:
> Never use a < character in examples or ordinary text.
>
>
> Index: phpdoc/en/functions/array.xml
> diff -u phpdoc/en/functions/array.xml:1.73
phpdoc/en/functions/array.xml:1.74
> --- phpdoc/en/functions/array.xml:1.73 Mon Jul 2 12:52:10 2001
> +++ phpdoc/en/functions/array.xml Mon Jul 2 15:44:44 2001
> @@ -3062,7 +3062,7 @@
>
> function cmp ($a, $b) {
> if ($a == $b) return 0;
> -return ($a < $b) ? -1 : 1;
> +return ($a < $b) ? -1 : 1;
> }
>
> $a = array (3, 2, 5, 6, 1);
>
>
>
