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 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.163 $ -- +!-- $Revision: 1.164 $ -- reference id=ref.array titleArray Functions/title titleabbrevArrays/titleabbrev @@ -57,7 +57,7 @@ para constantCASE_UPPER/constant and constantCASE_LOWER/constant are used with the functionarray_change_key_case/function 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. /para /section -- 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. + section id=array.seealso +titleSee also/title +para + See also functionis_array/function, functionexplode/function, + functionimplode/function, functionsplit/function, + and functionjoin/function. +/para + /section What? We do not have sections like this for see also lists anywhere... We have note role=seealso but it is also not used anywhere. We have see also lists written as paraSee also: .../para. Goba
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. + section id=array.seealso +titleSee also/title +para + See also functionis_array/function, functionexplode/function, + functionimplode/function, functionsplit/function, + and functionjoin/function. +/para + /section What? We do not have sections like this for see also lists anywhere... We have note role=seealso but it is also not used anywhere. We have see also lists written as paraSee also: .../para. 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
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. + section id=array.seealso +titleSee also/title +para + See also functionis_array/function, functionexplode/function, + functionimplode/function, functionsplit/function, + and functionjoin/function. +/para + /section What? We do not have sections like this for see also lists anywhere... We have note role=seealso but it is also not used anywhere. We have see also lists written as paraSee also: .../para. 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
+ section id=array.seealso +titleSee also/title +para + See also functionis_array/function, functionexplode/function, + functionimplode/function, functionsplit/function, + and functionjoin/function. +/para + /section What? We do not have sections like this for see also lists anywhere... We have note role=seealso but it is also not used anywhere. We have see also lists written as paraSee also: .../para. 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): section id=array.seealso titleSee also/title note role=seealso para See also functionis_array/function, functionexplode/function, functionimplode/function, functionsplit/function, and functionjoin/function. /para /note /section Better ideas, anyone? Goba
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 note role=seealso but it is also not used anywhere. We have see also lists written as paraSee also: .../para. 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
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 note role=seealso but it is also not used anywhere. We have see also lists written as paraSee also: .../para. 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
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): section id=array.seealso titleSee also/title note role=seealso para See also functionis_array/function, functionexplode/function, functionimplode/function, functionsplit/function, and functionjoin/function. /para /note /section Better ideas, anyone? Goba What about section id=array.seealso role=seealso? 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 section 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
section id=array.seealso titleSee also/title note role=seealso para See also functionis_array/function, functionexplode/function, functionimplode/function, functionsplit/function, and functionjoin/function. /para /note /section What about section id=array.seealso role=seealso? 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 section 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 03:10, Gabor Hojtsy wrote: section id=array.seealso titleSee also/title note role=seealso para See also functionis_array/function, functionexplode/function, functionimplode/function, functionsplit/function, and functionjoin/function. /para /note /section What about section id=array.seealso role=seealso? 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 section 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: section id=array.seeaslo role=seealso titleSee also/title simpara . . .functions. . . /simparay /section i.e. just make section 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
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
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
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 function 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
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 havent 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 function 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: 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 havent 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
- The name of this function is functionkey_exists/function - 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
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 functionkey_exists/function - 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
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
- 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? Please read the diff. Some examples: -refpurposeFilters elements of an array using a callback function/refpurpose +refpurpose + Filters elements of an array using a callback function +/refpurpose example title -Implementation of functionarray_keys/function for PHP 3 -users + Implementation of functionarray_keys/function for PHP 3 + users /title -refpurposeApplies the callback to the elements of the given arrays/refpurpose +refpurpose + Applies the callback to the elements of the given arrays +/refpurpose - functionarray_multisort/function, and functionuksort/function. + functionarray_multisort/function, and + functionuksort/function. 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
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 @@
programlisting role=php
function cmp ($a, $b) {
if ($a == $b) return 0;
-return ($a $b) ? -1 : 1;
+return ($a lt; $b) ? -1 : 1;
}
$a = array (3, 2, 5, 6, 1);
