[PHP-DOC] cvs: phpdoc /en/functions ming.xml
damsTue May 15 02:17:28 2001 EDT Modified files: /phpdoc/en/functionsming.xml Log: paramdefinteger - int Index: phpdoc/en/functions/ming.xml diff -u phpdoc/en/functions/ming.xml:1.9 phpdoc/en/functions/ming.xml:1.10 --- phpdoc/en/functions/ming.xml:1.9Thu Apr 19 06:06:56 2001 +++ phpdoc/en/functions/ming.xmlTue May 15 02:17:28 2001 @@ -1103,10 +1103,10 @@ funcsynopsis funcprototype funcdefvoid functionswfdisplayitem-addcolor/function/funcdef - paramdefinteger parameteroptionalred/optional/parameter/paramdef - paramdefinteger parameteroptionalgreen/optional/parameter/paramdef - paramdefinteger parameteroptionalblue/optional/parameter/paramdef - paramdefinteger parameteroptionala/optional/parameter/paramdef + paramdefint parameteroptionalred/optional/parameter/paramdef + paramdefint parameteroptionalgreen/optional/parameter/paramdef + paramdefint parameteroptionalblue/optional/parameter/paramdef + paramdefint parameteroptionala/optional/parameter/paramdef /funcprototype /funcsynopsis para @@ -1132,10 +1132,10 @@ funcsynopsis funcprototype funcdefvoid functionswfdisplayitem-multcolor/function/funcdef - paramdefinteger parameteroptionalred/optional/parameter/paramdef - paramdefinteger parameteroptionalgreen/optional/parameter/paramdef - paramdefinteger parameteroptionalblue/optional/parameter/paramdef - paramdefinteger parameteroptionala/optional/parameter/paramdef + paramdefint parameteroptionalred/optional/parameter/paramdef + paramdefint parameteroptionalgreen/optional/parameter/paramdef + paramdefint parameteroptionalblue/optional/parameter/paramdef + paramdefint parameteroptionala/optional/parameter/paramdef /funcprototype /funcsynopsis para @@ -1252,10 +1252,10 @@ funcprototype funcdefvoid functionswfshape-setline/function/funcdef paramdefint parameterwidth/parameter/paramdef - paramdefinteger parameteroptionalred/optional/parameter/paramdef - paramdefinteger parameteroptionalgreen/optional/parameter/paramdef - paramdefinteger parameteroptionalblue/optional/parameter/paramdef - paramdefinteger parameteroptionala/optional/parameter/paramdef + paramdefint parameteroptionalred/optional/parameter/paramdef + paramdefint parameteroptionalgreen/optional/parameter/paramdef + paramdefint parameteroptionalblue/optional/parameter/paramdef + paramdefint parameteroptionala/optional/parameter/paramdef /funcprototype /funcsynopsis para @@ -1345,24 +1345,24 @@ funcsynopsis funcprototype funcdefvoid functionswfshape-addfill/function/funcdef - paramdefinteger parameterred/parameter/paramdef - paramdefinteger parametergreen/parameter/paramdef - paramdefinteger parameterblue/parameter/paramdef - paramdefinteger parameteroptionala/optional/parameter/paramdef + paramdefint parameterred/parameter/paramdef + paramdefint parametergreen/parameter/paramdef + paramdefint parameterblue/parameter/paramdef + paramdefint parameteroptionala/optional/parameter/paramdef /funcprototype /funcsynopsis funcsynopsis funcprototype funcdefvoid functionswfshape-addfill/function/funcdef paramdefSWFbitmap parameterbitmap/parameter/paramdef - paramdefinteger parameteroptionalflags/optional/parameter/paramdef + paramdefint parameteroptionalflags/optional/parameter/paramdef /funcprototype /funcsynopsis funcsynopsis funcprototype funcdefvoid functionswfshape-addfill/function/funcdef paramdefSWFGradient parametergradient/parameter/paramdef - paramdefinteger parameteroptionalflags/optional/parameter/paramdef + paramdefint parameteroptionalflags/optional/parameter/paramdef /funcprototype /funcsynopsis para @@ -1475,10 +1475,10 @@ funcsynopsis funcprototype funcdefvoid functionswfshape-setleftfill/function/funcdef - paramdefinteger parameterred/parameter/paramdef - paramdefinteger parametergreen/parameter/paramdef - paramdefinteger parameterblue/parameter/paramdef - paramdefinteger parameteroptionala/optional/parameter/paramdef + paramdefint parameterred/parameter/paramdef + paramdefint parametergreen/parameter/paramdef + paramdefint parameterblue/parameter/paramdef + paramdefint parameteroptionala/optional/parameter/paramdef /funcprototype /funcsynopsis para @@ -1522,10 +1522,10 @@ funcsynopsis funcprototype funcdefvoid functionswfshape-setrightfill/function/funcdef - paramdefinteger parameterred/parameter/paramdef - paramdefinteger parametergreen/parameter/paramdef - paramdefinteger parameterblue/parameter/paramdef - paramdefinteger parameteroptionala/optional/parameter/paramdef + paramdefint
[PHP-DOC] boolean/bool and int/integer
Hi all, I went through all function synopsis, and updated boolean - bool, integer - int. If some are left over, feel free to tell me. Damien Seguy
[PHP-DOC] sem_remove
I have added a function sem_remove(int id) to the sysvsem extension. This removes unwanted semaphores. It returns true upon success and false upon failure. This function is currently undocumented. Gavin
[PHP-DOC] cvs: phpdoc /en/functions mysql.xml
damsTue May 15 05:18:59 2001 EDT Modified files: /phpdoc/en/functionsmysql.xml Log: Added functionmysql_query/function in mysql_db_query related links. Index: phpdoc/en/functions/mysql.xml diff -u phpdoc/en/functions/mysql.xml:1.39 phpdoc/en/functions/mysql.xml:1.40 --- phpdoc/en/functions/mysql.xml:1.39 Sun May 13 09:50:25 2001 +++ phpdoc/en/functions/mysql.xml Tue May 15 05:18:59 2001 @@ -474,7 +474,8 @@ arguments /para para - See also functionmysql_connect/function. + See also functionmysql_connect/function and + functionmysql_query/function. /para para For downwards
RE: [PHP-DOC] Would somebody check this please (readme.win32)?
Hello! As promised this the morning, here is a new proposal for an README.win32 improvement. Would be great, if somebody could check, probably improve, and commit it. Many thanks in advance, Thomas README.win32
[PHP-DOC] cvs: phpdoc / README.win32
jkj Tue May 15 11:55:15 2001 EDT Modified files: /phpdoc README.win32 Log: - added updates sent by Thomas - added reference for ISO entity sets Index: phpdoc/README.win32 diff -u phpdoc/README.win32:1.2 phpdoc/README.win32:1.3 --- phpdoc/README.win32:1.2 Wed Feb 7 02:55:37 2001 +++ phpdoc/README.win32 Tue May 15 11:55:14 2001 @@ -25,34 +25,61 @@ http://www.jclark.com/jade/ http://nwalsh.com/docbook/dsssl/ -There is a DTD reference for DocBook at +There is a Reference for DocBook at -http://www.ora.com/homepages/dtdparse/docbook/3.0/ +http://www.oasis-open.org/docbook/documentation/reference/ -RPMs with the necessary software can be found at -ftp://sourceware.cygnus.com/pub/docbook-tools/ -Most major linux distributions should already come with -ready to use packages. This is not case for Windows. You must do -following steps: +Most major linux distributions should already come with ready to use +packages. This is not case for Windows. You must do following steps: -1. Directory where jade.exe is located must be added into your +1. Download and unpack the distributions of + - Jade, + - DSSSL stylesheets + +2. Download ISO entity sets (http://www.oasis-open.org/cover/ISOEnts.zip) + and unzip them into some directory, for example c:\isoent. Create file + named isoent.cat in this directory and place following code into it: + +PUBLIC ISO 8879:1986//ENTITIES Diacritical Marks//EN isodia +PUBLIC ISO 8879:1986//ENTITIES Numeric and Special Graphic//ENisonum +PUBLIC ISO 8879:1986//ENTITIES Publishing//EN isopub +PUBLIC ISO 8879:1986//ENTITIES General Technical//EN isotech +PUBLIC ISO 8879:1986//ENTITIES Added Latin 1//EN isolat1 +PUBLIC ISO 8879:1986//ENTITIES Added Latin 2//EN isolat2 +PUBLIC ISO 8879:1986//ENTITIES Greek Letters//EN isogrk1 +PUBLIC ISO 8879:1986//ENTITIES Monotoniko Greek//EN isogrk2 +PUBLIC ISO 8879:1986//ENTITIES Greek Symbols//EN isogrk3 +PUBLIC ISO 8879:1986//ENTITIES Alternative Greek Symbols//EN isogrk4 +PUBLIC ISO 8879:1986//ENTITIES Added Math Symbols: Arrow Relations//EN isoamsa +PUBLIC ISO 8879:1986//ENTITIES Added Math Symbols: Binary Operators//EN isoamsb +PUBLIC ISO 8879:1986//ENTITIES Added Math Symbols: Delimiters//EN isoamsc +PUBLIC ISO 8879:1986//ENTITIES Added Math Symbols: Negated Relations//EN isoamsn +PUBLIC ISO 8879:1986//ENTITIES Added Math Symbols: Ordinary//EN isoamso +PUBLIC ISO 8879:1986//ENTITIES Added Math Symbols: Relations//EN isoamsr +PUBLIC ISO 8879:1986//ENTITIES Box and Line Drawing//EN isobox +PUBLIC ISO 8879:1986//ENTITIES Russian Cyrillic//EN isocyr1 +PUBLIC ISO 8879:1986//ENTITIES Non-Russian Cyrillic//EN isocyr2 + +3. Directory where jade.exe is located must be added into your PATH environment variable. - -2. Norm's modular DocBook DSSSL stylesheets must be unzipped somewhere. -3. You need to download and install cygwin tools from www.cygwin.com. +4. Make the catalog files available. + Set the environemt variable SGML_CATALOG_FILES, e.g.: + SGML_CATALOG_FILES=c:/jade/catalog;c:/isoent/isoent.cat + +5. You need to download and install cygwin tools from www.cygwin.com. Just select Install now! link and run supplied setup.exe. It - will guide you through process of instalation. + will guide you through process of installation. These tools are port of standard unix tools like sed, awk, autoconf, make, perl, ... for Windows. -4. If want to build documentation just run Cygwin Bash Shell +6. If you want to build documentation just run Cygwin Bash Shell command from Programs menu (it will be added here by previous step). -5. Now you get command line which behaves same as bash on unix +7. Now you get a command line which behaves same as bash on unix boxes. Change to directory where you have snapshot of phpdoc. (If you haven't snapshot yet, use CVS command as described on http://www.php.net/cvs-php.php. CVS is part of cygwin, so you @@ -63,18 +90,32 @@ paths. If you want access directory foo on drive c: write is as c:/foo instead of c:\foo. -6. Now do same steps as on unix machine. For example for building +8. Now do same steps as on unix machine. For example for building HTML version of documentation use: autoconf ./configure --with-dsssl=c:/path/to/dsssl/stylesheets/dir make html + + to make your local language, replace the above configure-command with + +./configure --with-dsssl=c:/path/to/dsssl/stylesheets/dir --with-lang=xx + + for further options, simply type +./configure --help -7. Wait a few minutes (now it is time to have a couple of tea or +9. Wait a few minutes (now it is time to have a couple of tea or
Re: [PHP-DOC] Would somebody check this please (readme.win32)?
Thomas wrote: Would be great, if somebody could check, probably improve, and commit it. It is commited, I just remove reference for DocBook DTD which is not needed and reference for ISO entity sets (which are needed if you do not have SGML version of DocBook installed). - Jirka Kosek e-mail: [EMAIL PROTECTED] http://www.kosek.cz
[PHP-DOC] Array-Functions
Hello all,
while working on the de-translation of the array-functions, I've recognized
the following:
1.) FUNCTION ARRAY_REVERSE:
The mentioned $result2 doesn't exist in the related example,
it should be $result_keyed:
*** snip ***
Example 1. Array_reverse() example
$input = array (php, 4.0, array (green, red));
$result = array_reverse ($input);
$result_keyed = array_reverse ($input, TRUE);
This makes $result have array (array (green, red), 4.0, php). But
$result2[0] is still php.
*** snip ***
2.) FUNCTION ARRAY_FLIP:
http://www.php.net/manual/en/html/function.array-flip.html:
Considering a beginner with no programming history, this description
isn't easy to understand. Therefore I'd suggest a description like:
snip ***
array_flip -- Flip all the values of an array
Description
array array_flip (array array)
Array_flip() returns an array where keys and values are flipped.
Note that this function works only with string and integer values
Example 1. Array_flip()
$input = array ( red, green, green );
$result = array_flip ($input);
This makes $result have array ( red = 0, green = 2 );.
Note that green in result is unique (see Array()).
See also Array_unique() and array_reverse().
snip ***
3.) COMETICS 1: Question to examples in general:
The examples (throughout the whole phpdoc) are often stated like
example
titlefunctionArray_flip/function example/title,
what makes in the manual Example 1. Array_flip() example.
Isn't that off-putting to the reader?
Is that based on a special thought behind, or would it be better to
delete/rename the extra-example?
4.) COSMETICS 2:
The parameter-names are inconsistent:
sometimes, we have
function (array array),
function (array arr),
function (array input)
Should I unify this?
If everybody agrees on some or all of these (or new/better) suggestions, let
me know, and I'll provide the adapted array.xml that somebody can commit it.
best regards,
Thomas
Re: [PHP-DOC] To the German-people: filesystem.xml
On Tue, May 15, 2001 at 08:42:29PM +0200, Thomas wrote: I can't reach Egon Saturday, so I try it here: Could somebody please confirm the enclosed de/functions/filesystem.xml and de/Translators.xml? I'm still alive. On weekends I spent the most time in another city ... What I've done: de/filesystem.xml: - implemented changes to en-version 1.63, - corrected some typos, - rephrased some function-titles, so that the TOC is easier to read de/translators: - changed the status-info of filesystem.xml to 1.63 Do you have an CVS account? I havent seen any commits. -Egon -- LinuxTag, Stuttgart, Germany: July 5-8 2001: http://www.linuxtag.de/ All known books about PHP and related books: http://php.net/books.php Concert Band of the University of Hohenheim: http://www.concert-band.de/ First and second bestselling book in German: http://www.php-buch.de/
[PHP-DOC] cvs: phpdoc /en/language functions.xml
eschmid Tue May 15 15:20:12 2001 EDT Modified files: /phpdoc/en/language functions.xml Log: Should fix two off ten errors, Index: phpdoc/en/language/functions.xml diff -u phpdoc/en/language/functions.xml:1.10 phpdoc/en/language/functions.xml:1.11 --- phpdoc/en/language/functions.xml:1.10 Mon May 14 09:52:41 2001 +++ phpdoc/en/language/functions.xmlTue May 15 15:20:12 2001 @@ -309,10 +309,11 @@ be used to implement callbacks, function tables, and so forth. /para para -Variable functions won't work with language constructs such as -functionecho/function, functionunset/function, functionisset/function -and /functionempty/function. This is one of the major differences between -PHP functions and langage constructs. +Variable functions won't work with language constructs such as +functionecho/function, functionunset/function, +functionisset/function and functionempty/function. This is +one of the major differences between PHP functions and langage +constructs. /para para example
[PHP-DOC] Procedure for renaming functions
What is the correct procedure for dealing with renamed functions in the PHP Manual? Should the function be renamed with a note that it used to have a different name, or should it be listed twice (under both its old and new names)? -- Jon Parise ([EMAIL PROTECTED]) . Rochester Inst. of Technology http://www.csh.rit.edu/~jon/ : Computer Science House Member
[PHP-DOC] cvs: phpdoc /en/language functions.xml
sniper Tue May 15 16:22:46 2001 EDT Modified files: /phpdoc/en/language functions.xml Log: fixed typo Index: phpdoc/en/language/functions.xml diff -u phpdoc/en/language/functions.xml:1.11 phpdoc/en/language/functions.xml:1.12 --- phpdoc/en/language/functions.xml:1.11 Tue May 15 15:20:12 2001 +++ phpdoc/en/language/functions.xmlTue May 15 16:22:46 2001 @@ -312,7 +312,7 @@ Variable functions won't work with language constructs such as functionecho/function, functionunset/function, functionisset/function and functionempty/function. This is -one of the major differences between PHP functions and langage +one of the major differences between PHP functions and language constructs. /para para
[PHP-DOC] cvs: phpdoc /en/functions filesystem.xml
jon Tue May 15 16:51:56 2001 EDT Modified files: /phpdoc/en/functionsfilesystem.xml Log: Documentation for the new disk_total_space() function. Index: phpdoc/en/functions/filesystem.xml diff -u phpdoc/en/functions/filesystem.xml:1.63 phpdoc/en/functions/filesystem.xml:1.64 --- phpdoc/en/functions/filesystem.xml:1.63 Mon May 14 05:37:47 2001 +++ phpdoc/en/functions/filesystem.xml Tue May 15 16:51:56 2001 @@ -330,6 +330,36 @@ /refsect1 /refentry + refentry id=function.disk-total-space + refnamediv +refnamedisk_total_space/refname +refpurposeReturns the total size of a directory/refpurpose + /refnamediv + refsect1 +titleDescription/title +funcsynopsis + funcprototype + funcdeffloat functiondisk_total_space/function/funcdef + paramdefstring parameterdirectory/parameter/paramdef + /funcprototype +/funcsynopsis +para + Given a string containing a directory, this function will return + the total number of bytes on the corresponding filesystem or disk + partition. +/para +para + example + titlefunctiondisk_total_space/function example/title + programlisting role=php +$df = disk_total_space(/); // $df contains the total number of + // bytes available on / + /programlisting + /example +/para + /refsect1 + /refentry + refentry id=function.fclose refnamediv refnamefclose/refname
[PHP-DOC] Rename list to php-doc?
We're there plans to rename the [EMAIL PROTECTED] mailing list to [EMAIL PROTECTED], for consistency with the other mailing lists? What ever happened to that idea? -- Jon Parise ([EMAIL PROTECTED]) . Rochester Inst. of Technology http://www.csh.rit.edu/~jon/ : Computer Science House Member
