[PHP-DOC] cvs: phpdoc /en/language functions.xml
vrana Tue Aug 10 04:44:00 2004 EDT Modified files: /phpdoc/en/language functions.xml Log: PHP 4 and above\nDefault value for arguments passed by reference http://cvs.php.net/diff.php/phpdoc/en/language/functions.xml?r1=1.52r2=1.53ty=u Index: phpdoc/en/language/functions.xml diff -u phpdoc/en/language/functions.xml:1.52 phpdoc/en/language/functions.xml:1.53 --- phpdoc/en/language/functions.xml:1.52 Fri Aug 6 18:37:44 2004 +++ phpdoc/en/language/functions.xmlTue Aug 10 04:43:59 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.52 $ -- +!-- $Revision: 1.53 $ -- chapter id=language.functions titleFunctions/title @@ -131,7 +131,7 @@ PHP 3 does not support variable numbers of arguments to functions, although default arguments are supported (see link linkend=functions.arguments.defaultDefault argument -values/link for more information). PHP 4 supports both: see link +values/link for more information). PHP 4 and above supports both: see link linkend=functions.variable-arg-listVariable-length argument lists/link and the function references for functionfunc_num_args/function, @@ -338,6 +338,10 @@ Making a bowl of acidophilus raspberry. /screen /para + +para + Default value for arguments passed by reference is supported since PHP 5. +/para /sect2 @@ -345,7 +349,7 @@ titleVariable-length argument lists/title simpara - PHP 4 has support for variable-length argument lists in + PHP 4 and above has support for variable-length argument lists in user-defined functions. This is really quite easy, using the functionfunc_num_args/function, functionfunc_get_arg/function, and
[PHP-DOC] #27111 [Opn-Asn]: virtual() function does not behave as documented
ID: 27111 Updated by: [EMAIL PROTECTED] Reported By: e-phpbug at erowid dot org -Status: Open +Status: Assigned Bug Type: Documentation problem Operating System: freebsd PHP Version: 4.3.4 Assigned To: vrana Previous Comments: [2004-07-28 21:36:16] e-phpbug at erowid dot org Yes, excellent. I do not have access to a properly-functioning apache2+mod_php setup, so I can't test this myself, but I'd say you've hit the nail on the head. Thanks for taking another look at it! Your work on this is very much appreciated. [2004-07-28 10:04:20] [EMAIL PROTECTED] Yes, I tried it. It seems that this function works as expected only with Apache 2. I tried these simple scripts: main.php: ?php virtual(virtual.php?a=c); ? virtual.php: ?php echo $_SERVER[QUERY_STRING]; ? Apache 1: Parameters of main.php are printed Apache 2: a=c is printed virtual.php is not listed in Apache access log in either case. It's independent if you use PHP 4 or PHP 5. I tried it under Windows. Do you agree with this description? [2004-07-28 07:50:42] e-phpbug at erowid dot org It seems you continue to not understand the problem? Did you try it? Do you realize this exact bug has been closed improperly before? No, simply noting that it only works when compiled as an apache module does not solve the problem. The function does not work as documented no matter how PHP 4.x is compiled. I have not tried PHP5, but given your response to the problems, it seems very very unlikely its been fixed. Did you try my simple test case? Can you get the same behaviour from shtml include virtual on apache as you do from PHP? Also please check your apache log files. No additional request to apache is being generated, query parameters don't get passed and the environment is wrong. This function does not work when used to include PHP files, otherwise it works fine. The documentation should be changed to say something more like: Note: This function does not perform like apache's include virtual shtml directive when used to call another PHP file. virtual() does not call the apache httpd, but instead runs the script internally without generating another file hit. It does not properly pass any query parameters or environment variables to the called php file. I would guess the problem is with some code above the apache API call and PHP is being smart by seeing its a php file and short circuiting instead of actually calling apache. Or there is a bug between apache and PHP, but its not getting to apache as a file request, its just getting executed by the PHP module internally. Whatever the cause, however, your proposed resolution, is wrong. [2004-07-27 22:33:09] [EMAIL PROTECTED] This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. Copied from sources: This function works only when PHP is compiled as an Apache module, since it uses the Apache API for doing sub requests. [2004-01-31 21:06:18] e-phpbug at erowid dot org Description: Documentation for virtual() claims that it should work like an apache sub-request like the shtml #include virtual command. It does not. Bug 26500 is reporting the same bug but appears to have been closed by someone who does not understand the issue. It is clear that it is not doing this as advertised for php scripts. What should be creating an http request is instead clearly short-circuting to a PHP include() call with the docroot pre-pended when the target is a php script. This results in any CGI PHP called through virtual being called as a sub-component of the current PHP script instead of as its own execution, with its own environment, own POST/GET variables, etc. This clearly violates the documented purpose of the call (to replicate the apache shtml functionality). Also, as a side effect of how this behaves, virtual changes the cwd in the calling script (a behaviour that should not happen with an apache subrequest). Both of these problems are solved if http://www.host.com/ is pre-pended to the string and passed to include() instead, which actually generates an http sub-request. Proposed solutions: 1) change the documentation so that it doesn't claim this is the same as apache's include-virtual directive. 2) fix the problem since this is clearly the intended behaviour for the function. Reproduce code: --- The following
[PHP-DOC] #28731 [Opn-Csd]: Document what is in the windows package
ID: 28731 Updated by: [EMAIL PROTECTED] Reported By: cross_phil at hotmail dot com -Status: Open +Status: Closed Bug Type: Documentation problem Operating System: Windows XP PHP Version: 5.0.0RC2 New Comment: This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. Previous Comments: [2004-06-10 22:16:37] [EMAIL PROTECTED] Ups, title change too [2004-06-10 22:15:55] [EMAIL PROTECTED] IMHO the manual installation page should have details on what can be found in the package. We can add this after Wez reviewed the docs (so we know what to add more info about). [2004-06-10 17:16:09] [EMAIL PROTECTED] I've already fixed this in the new installation part. The php-win.exe is refered in the command line page and in the migration appendix. Thanks for your report, Nuno [2004-06-10 16:58:59] cross_phil at hotmail dot com Description: Installation instructions into Apache as a CGI say to include the following: ScriptAlias /php/ c:/php/ AddType application/x-httpd-php .php Action application/x-httpd-php /php/php.exe I found that I had to modify the php.exe to say php-cgi.exe. In my PHP folder there is: php.exe php-win.exe php-cgi.exe with no documentation regarding which one does what. I found php-cgi worked for me. Expected result: Expected more detail regarding the different EXE files packaged in the distribution. Actual result: -- Internal server error was coming up instead of PHP processed HTML. -- Edit this bug report at http://bugs.php.net/?id=28731edit=1
[PHP-DOC] #21783 [Opn-Asn]: php-{SAPI}.ini and php.ini : when/where/what php looks for and why.
ID: 21783
Updated by: [EMAIL PROTECTED]
Reported By: danielc at analysisandsolutions dot com
-Status: Open
+Status: Assigned
Bug Type: Documentation problem
Operating System: Any
PHP Version: 4.3.0
-Assigned To:
+Assigned To: nlopess
Previous Comments:
[2004-07-27 20:19:49] [EMAIL PROTECTED]
IMHO this should be closed when:
1) Every possible php-{SAPI}.ini name is listed
2) Where PHP looks for these, and in what order
3) Document every possible way to change this location,
including at compile time.
Not sure why #22001 was closed but we'll leave it and focus on this one
as it's a smaller number :)
#3 may want to be a faq but it's important and a topic that PHP users
have wondered about for years. In Apache 2 there is a PHPINIDir
setting that can be used, does anything similar exist in Apache 1? In
Windows show how (or link to how) to set environment variables such as
PHPRC, PHPRC as a variable is currently documented. Not sure about
IIS... --with-config-file-path should be mentioned on this list as
well. There could be more settings, the above are what come to mind.
[2004-07-27 18:54:05] [EMAIL PROTECTED]
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.
Thank you for the report, and for helping us make our documentation
better.
If php-SAPI.ini exists (where SAPI is used SAPI, so the filename is
e.g. php-cli.ini or php-apache.ini), it's used instead of php.ini;.
I added also cross-reference to features.commandline.
[2003-07-15 08:11:14] phyre at rogers dot com
I note that there are different files (php-cli.ini) which isn't
documented as far as I can tell. That's for that pointer folks.
However, I believe that different directories are also quite
important. Apache php.ini goes with apache config. CLI should go in
/etc. Thoughts?
[2003-02-02 06:44:17] [EMAIL PROTECTED]
Information found in bug #22001 should be included when this bug report
is dealt with:
http://bugs.php.net/22001
Pretty interesting stuff.
[2003-01-20 21:25:40] danielc at analysisandsolutions dot com
The text I'd suggest is something along these lines. I don't know the
complete inner workings of PHP, so tweak it to reflect reality.
On Unix systems, PHP uses the php.ini file specified when PHP was
compiled. On Windows systems, PHP uses the php.ini from the same
directory as the php.exe file you execute. This behavior can be
modified by using the -c switch or by setting the PHPRC environment
variable. See the a href=configuration.phpConfiguration/a page
for more information.
Thanks,
--Dan
The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at
http://bugs.php.net/21783
--
Edit this bug report at http://bugs.php.net/?id=21783edit=1
[PHP-DOC] #26125 [Opn-Csd]: php.ini location in phpinfo() is not where the php4sapi.dll looks for it
ID: 26125 Updated by: [EMAIL PROTECTED] Reported By: nickh at supportteam dot net -Status: Open +Status: Closed Bug Type: Documentation problem Operating System: Windows Server 2003 PHP Version: 4.3.3 New Comment: This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. Previous Comments: [2003-11-06 18:18:43] nickh at supportteam dot net Nope. The php binary is found in e:\php on this particular server. By Default, PHP has always looked (by always, I mean on all 2000 Server installs I've done) in the c:\winnt or c:\windows, whichever you installed to. It is behaving differently under 2003. Eventhough phpinfo says c:\windows, it's not. [2003-11-06 14:56:14] [EMAIL PROTECTED] This gives a bit of a hint why: http://www.php.net/manual/en/faq.installation.php#faq.installation.phpini With IIS, the search propably starts where it's binary is located at. I haven't got w2k3 so I can't really test this. [2003-11-04 18:35:32] nickh at supportteam dot net Description: Under Windows Server 2003 when I run a phpinfo() it says the Configuration File Path is C:\WINDOWS. I was having trouble with the sessions path and when running a filemon capture (sysinternals filemon) I saw it was auctually looking for the ini in C:\Windows\system32\inetsrv. Placing the ini there fixed the problem. It appears that the ISAPI version of PHP4 .3.3 says the INI should be in one place but it looks for it elsewhere. I have tested this on 4 different Windows Server 2003 Standard servers that we have and it's the same on all 3. Reproduce code: --- N/A Expected result: N/A Actual result: -- N/A -- Edit this bug report at http://bugs.php.net/?id=26125edit=1
[PHP-DOC] #28255 [Asn-Csd]: DLL directory missing
ID: 28255 Updated by: [EMAIL PROTECTED] Reported By: pburden98 at yahoo dot com -Status: Assigned +Status: Closed Bug Type: Documentation problem Operating System: windows 98 2nd Edition PHP Version: 5.0.0RC2 Assigned To: nlopess New Comment: This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. Previous Comments: [2004-08-07 11:30:01] [EMAIL PROTECTED] None of them need to be put to system32 (according to our very latest install instructions, which are in effect in the manual sources since yestarday). Watch out for new manual builds coming out in the comings days or next week, or a bit later containing the completely rewritten windows instructions with more tips, information and an easier install method. The INSTALL file in the windows distribution probably still needs to be changed. [2004-08-07 01:01:53] steve at aquiel dot net Bring back the dll directory so we can see which ones need to be put into system32 ok it might all run from the one directory but as a sysadmin running it form that one directory involves changes to enviromental variables etc to get php5 working properly and please update your documentation to reflect any changes!!! the installation docs are far from easy to read [2004-07-16 04:30:12] bradley at scrapcode dot com There is no dlls/ directory - the dlls in the root directory of php work, but without copying them to system32 during an upgrade, many problems arise. [2004-05-05 13:28:38] pburden98 at yahoo dot com I found another on line 181 of INSTALL. Since PHP 4.0.5 MySQL, ODBC, FTP...and XML support is built-in. This is not true. I was told by a friend, MySQL is not loaded because of licensing problems Will you be patching the whole chapter Installation of Windows extensions on the INSTALL? [2004-05-03 15:32:19] [EMAIL PROTECTED] I don't have karma to update the INSTALL file, but I'll make a patch for it and I'll update this in the migration appendix. The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/28255 -- Edit this bug report at http://bugs.php.net/?id=28255edit=1
[PHP-DOC] cvs: phpdoc /en/chapters tutorial.xml /en/features safe-mode.xml /en/install/unix fhttpd.xml sun.xml /en/language/oop5 abstract.xml /en/reference/apache reference.xml
nlopess Tue Aug 10 09:01:08 2004 EDT Modified files: /phpdoc/en/reference/apache reference.xml /phpdoc/en/chapters tutorial.xml /phpdoc/en/features safe-mode.xml /phpdoc/en/install/unix fhttpd.xml sun.xml /phpdoc/en/language/oop5abstract.xml Log: fix IDs http://cvs.php.net/diff.php/phpdoc/en/reference/apache/reference.xml?r1=1.8r2=1.9ty=u Index: phpdoc/en/reference/apache/reference.xml diff -u phpdoc/en/reference/apache/reference.xml:1.8 phpdoc/en/reference/apache/reference.xml:1.9 --- phpdoc/en/reference/apache/reference.xml:1.8Mon Apr 19 10:52:33 2004 +++ phpdoc/en/reference/apache/reference.xmlTue Aug 10 09:01:07 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.8 $ -- +!-- $Revision: 1.9 $ -- reference id=ref.apache titleApache-specific Functions/title titleabbrevApache/titleabbrev @@ -24,9 +24,8 @@ section id=apache.installation reftitle.install; para - For PHP installation on Apache see the - link linkend='install.apache'Apache section/link in the installation - chapter. + For PHP installation on Apache see the link + linkend='install'installation chapter/link. /para /section http://cvs.php.net/diff.php/phpdoc/en/chapters/tutorial.xml?r1=1.36r2=1.37ty=u Index: phpdoc/en/chapters/tutorial.xml diff -u phpdoc/en/chapters/tutorial.xml:1.36 phpdoc/en/chapters/tutorial.xml:1.37 --- phpdoc/en/chapters/tutorial.xml:1.36Fri Aug 6 18:37:44 2004 +++ phpdoc/en/chapters/tutorial.xml Tue Aug 10 09:01:07 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.36 $ -- +!-- $Revision: 1.37 $ -- chapter id=tutorial titleA simple tutorial/title @@ -37,7 +37,7 @@ para Let us say you want to save precious bandwidth and develop locally. In this case, you will want to install a web server, such as -link linkend=install.apacheApache/link, and of course +ulink url=url.apache;Apache/ulink, and of course ulink url=url.php.downloads;PHP/ulink. You will most likely want to install a database as well, such as ulink url=url.mysql.docs;MySQL/ulink. http://cvs.php.net/diff.php/phpdoc/en/features/safe-mode.xml?r1=1.54r2=1.55ty=u Index: phpdoc/en/features/safe-mode.xml diff -u phpdoc/en/features/safe-mode.xml:1.54 phpdoc/en/features/safe-mode.xml:1.55 --- phpdoc/en/features/safe-mode.xml:1.54 Sun Aug 8 13:30:17 2004 +++ phpdoc/en/features/safe-mode.xmlTue Aug 10 09:01:07 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.54 $ -- +!-- $Revision: 1.55 $ -- chapter id=features.safe-mode titleSafe Mode/title @@ -89,7 +89,7 @@ listitem para Whether to enable PHP's safe mode. Read the -link linkend=security.indexSecurity/link chapter for more +link linkend=securitySecurity/link chapter for more information. /para /listitem @@ -243,7 +243,7 @@ listitem simpara This directive allows you to disable certain functions for -link linkend=security.indexsecurity/link reasons. It takes +link linkend=securitysecurity/link reasons. It takes on a comma-delimited list of function names. disable_functions is not affected by link linkend=ini.safe-modeSafe Mode/link. /simpara @@ -261,7 +261,7 @@ listitem simpara This directive allows you to disable certain classes for -link linkend=security.indexsecurity/link reasons. It takes +link linkend=securitysecurity/link reasons. It takes on a comma-delimited list of class names. disable_classes is not affected by link linkend=ini.safe-modeSafe Mode/link. /simpara http://cvs.php.net/diff.php/phpdoc/en/install/unix/fhttpd.xml?r1=1.1r2=1.2ty=u Index: phpdoc/en/install/unix/fhttpd.xml diff -u phpdoc/en/install/unix/fhttpd.xml:1.1 phpdoc/en/install/unix/fhttpd.xml:1.2 --- phpdoc/en/install/unix/fhttpd.xml:1.1 Tue Jun 8 17:47:58 2004 +++ phpdoc/en/install/unix/fhttpd.xml Tue Aug 10 09:01:07 2004 @@ -1,11 +1,11 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.1 $ -- +!-- $Revision: 1.2 $ -- sect1 id=install.unix.fhttpd titlefhttpd related notes/title para To build PHP as an fhttpd module, answer yes to Build as an fhttpd module? (the link -linkend=install.configure.with-fhttpd +linkend=configure.with-fhttpd --with-fhttpd/link=replaceableDIR/replaceable option to configure) and specify the fhttpd source base directory. The default directory is filename http://cvs.php.net/diff.php/phpdoc/en/install/unix/sun.xml?r1=1.1r2=1.2ty=u Index: phpdoc/en/install/unix/sun.xml diff -u phpdoc/en/install/unix/sun.xml:1.1 phpdoc/en/install/unix/sun.xml:1.2 --- phpdoc/en/install/unix/sun.xml:1.1 Tue Jun 8 17:47:58 2004 +++ phpdoc/en/install/unix/sun.xml Tue Aug 10 09:01:07 2004 @@
[PHP-DOC] cvs: phpdoc /htmlhelp README.txt
daveTue Aug 10 09:48:52 2004 EDT
Modified files:
/phpdoc/htmlhelpREADME.txt
Log:
- Explain cvs date tag usage and bunzip2 usage.
http://cvs.php.net/diff.php/phpdoc/htmlhelp/README.txt?r1=1.3r2=1.4ty=u
Index: phpdoc/htmlhelp/README.txt
diff -u phpdoc/htmlhelp/README.txt:1.3 phpdoc/htmlhelp/README.txt:1.4
--- phpdoc/htmlhelp/README.txt:1.3 Mon Aug 9 07:46:21 2004
+++ phpdoc/htmlhelp/README.txt Tue Aug 10 09:48:52 2004
@@ -10,7 +10,10 @@
but that your XSL folder is dated 2002.12.31 23:00:00,
since if you use XSL sheets from after this timestamp,
the customizations will not work. Use the cvs date tag
-to get this version.
+to get this version:
+
+From the phpdoc root directory:
+cvs update -dP -D'December 31, 2002 11:00pm' xsl
{Volunteer to fix the customizations if you are willing
to, but otherwise you cannot do much more but use the old
@@ -52,9 +55,9 @@
6. Get all the user notes from
http://ANY_MIRROR.php.net/backend/notes/all.bz2,
-extract it's contents, and place the resulting
-all file to the same folder where the
-make_chm.bat resides.
+extract its contents (using bunzip2 all.bz2, for example),
+and place the resulting all file to the same folder where
+the make_chm.bat resides.
7. Copy local_vars.php.src to local_vars.php and
adjust settings as needed.
[PHP-DOC] cvs: phpdoc /en/reference/apache/functions apache-request-headers.xml apache-response-headers.xml
nlopess Tue Aug 10 11:21:32 2004 EDT Modified files: /phpdoc/en/reference/apache/functions apache-request-headers.xml apache-response-headers.xml Log: examples http://cvs.php.net/diff.php/phpdoc/en/reference/apache/functions/apache-request-headers.xml?r1=1.6r2=1.7ty=u Index: phpdoc/en/reference/apache/functions/apache-request-headers.xml diff -u phpdoc/en/reference/apache/functions/apache-request-headers.xml:1.6 phpdoc/en/reference/apache/functions/apache-request-headers.xml:1.7 --- phpdoc/en/reference/apache/functions/apache-request-headers.xml:1.6 Mon Mar 22 10:15:06 2004 +++ phpdoc/en/reference/apache/functions/apache-request-headers.xml Tue Aug 10 11:21:32 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.6 $ -- +!-- $Revision: 1.7 $ -- !-- splitted from ./en/functions/apache.xml, last change in rev 1.2 -- refentry id=function.apache-request-headers refnamediv @@ -32,6 +32,19 @@ ? ]] /programlisting + para + The above example will output something similar to: + /para + screen +![CDATA[ +Accept: */* +Accept-Language: en-us +Accept-Encoding: gzip, deflate +User-Agent: Mozilla/4.0 +Host: www.example.com +Connection: Keep-Alive +]] + /screen /example /para note http://cvs.php.net/diff.php/phpdoc/en/reference/apache/functions/apache-response-headers.xml?r1=1.8r2=1.9ty=u Index: phpdoc/en/reference/apache/functions/apache-response-headers.xml diff -u phpdoc/en/reference/apache/functions/apache-response-headers.xml:1.8 phpdoc/en/reference/apache/functions/apache-response-headers.xml:1.9 --- phpdoc/en/reference/apache/functions/apache-response-headers.xml:1.8Sat May 22 11:28:41 2004 +++ phpdoc/en/reference/apache/functions/apache-response-headers.xmlTue Aug 10 11:21:32 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.8 $ -- +!-- $Revision: 1.9 $ -- !-- splitted from ./en/functions/apache.xml, last change in rev 1.2 -- refentry id=function.apache-response-headers refnamediv @@ -16,6 +16,30 @@ /methodsynopsis para Returns an array of all Apache response headers. +/para +para + example + titlefunctionapache_response_headers/function example/title + programlisting role=php +![CDATA[ +?php +print_r(apache_response_headers()); +? +]] + /programlisting + para + The above example will output something similar to: + /para + screen +![CDATA[ +Array +( +[Accept-Ranges] = bytes +[X-Powered-By] = PHP/4.3.8 +) +]] + /screen + /example /para note.apache.nsapi-module; para
Re: [PHP-DOC] libxml
you may didn't use the same chars due to your news client encoding conversion. try to iconv chr(224); -- Moshe. Jakub Vrana [EMAIL PROTECTED] wrote in message news:[EMAIL PROTECTED] moshe doron wrote: sorry, wrong target. anyway on win32, with php5.0.0 the function return empty string while on php4 it return notice. the iconv(WINDOWS-1255, UTF-8... which is what libxml suppse to do is working nice on win32 php. we still trying to figure out what going here. echo iconv(WINDOWS-1255, ISO-8859-1, raaa); It behaves the same in PHP 5.0.0 and PHP 4.3.8 on my box (Windows XP). Notice is issued and illegal characters are not translated. Jakub Vrana
[PHP-DOC] cvs: phpdoc /en/reference/tidy constants.xml /en/reference/tidy/functions tidy-node-isPhp.xml
nlopess Tue Aug 10 13:01:18 2004 EDT Modified files: /phpdoc/en/reference/tidy constants.xml /phpdoc/en/reference/tidy/functions tidy-node-isPhp.xml Log: added explanation about tidy constants docs and examples http://cvs.php.net/diff.php/phpdoc/en/reference/tidy/constants.xml?r1=1.3r2=1.4ty=u Index: phpdoc/en/reference/tidy/constants.xml diff -u phpdoc/en/reference/tidy/constants.xml:1.3 phpdoc/en/reference/tidy/constants.xml:1.4 --- phpdoc/en/reference/tidy/constants.xml:1.3 Sun Jul 4 06:06:18 2004 +++ phpdoc/en/reference/tidy/constants.xml Tue Aug 10 13:01:17 2004 @@ -1,18 +1,20 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.3 $ -- +!-- $Revision: 1.4 $ -- section id=tidy.constants reftitle.constants; extension.constants; para Each constantTIDY_TAG_XXX/constant represents a HTML tag. For example, constantTIDY_TAG_A/constant represents a lt;a - href=XXgt;linklt;/agt; tag. + href=XXgt;linklt;/agt; tag. Each constantTIDY_ATTR_XXX/constant + represents a HTML atribute. For example constantTIDY_ATTR_HREF/constant + would represent the href atribute in the previous example. /para para The following constants are defined: table titletidy tag constants/title -tgroup cols=2 +tgroup cols=1 thead row entryconstant/entry @@ -375,783 +377,474 @@ para table titletidy attribute constants/title - tgroup cols=2 + tgroup cols=1 thead row entryconstant/entry - entrydescription/entry /row /thead tbody row entryTIDY_ATTR_UNKNOWN/entry - entry - /entry /row row entryTIDY_ATTR_ABBR/entry - entry - /entry /row row entryTIDY_ATTR_ACCEPT/entry - entry - /entry /row row entryTIDY_ATTR_ACCEPT_CHARSET/entry - entry - /entry /row row entryTIDY_ATTR_ACCESSKEY/entry - entry - /entry /row row entryTIDY_ATTR_ACTION/entry - entry - /entry /row row entryTIDY_ATTR_ADD_DATE/entry - entry - /entry /row row entryTIDY_ATTR_ALIGN/entry - entry - /entry /row row entryTIDY_ATTR_ALINK/entry - entry - /entry /row row entryTIDY_ATTR_ALT/entry - entry - /entry /row row entryTIDY_ATTR_ARCHIVE/entry - entry - /entry /row row entryTIDY_ATTR_AXIS/entry - entry - /entry /row row entryTIDY_ATTR_BACKGROUND/entry - entry - /entry /row row entryTIDY_ATTR_BGCOLOR/entry - entry - /entry /row row entryTIDY_ATTR_BGPROPERTIES/entry - entry - /entry /row row entryTIDY_ATTR_BORDER/entry - entry - /entry /row row entryTIDY_ATTR_BORDERCOLOR/entry - entry - /entry /row row entryTIDY_ATTR_BOTTOMMARGIN/entry - entry - /entry /row row entryTIDY_ATTR_CELLPADDING/entry - entry - /entry /row row entryTIDY_ATTR_CELLSPACING/entry - entry - /entry /row row entryTIDY_ATTR_CHAR/entry - entry - /entry /row row entryTIDY_ATTR_CHAROFF/entry - entry - /entry /row row entryTIDY_ATTR_CHARSET/entry - entry - /entry /row row entryTIDY_ATTR_CHECKED/entry - entry - /entry /row row entryTIDY_ATTR_CITE/entry - entry - /entry /row row entryTIDY_ATTR_CLASS/entry - entry - /entry /row row entryTIDY_ATTR_CLASSID/entry - entry - /entry /row row entryTIDY_ATTR_CLEAR/entry - entry - /entry /row row entryTIDY_ATTR_CODE/entry - entry - /entry /row row entryTIDY_ATTR_CODEBASE/entry - entry - /entry /row row entryTIDY_ATTR_CODETYPE/entry - entry - /entry /row row entryTIDY_ATTR_COLOR/entry - entry - /entry /row row entryTIDY_ATTR_COLS/entry - entry - /entry /row row entryTIDY_ATTR_COLSPAN/entry - entry - /entry /row row entryTIDY_ATTR_COMPACT/entry - entry - /entry /row row entryTIDY_ATTR_CONTENT/entry - entry - /entry /row row entryTIDY_ATTR_COORDS/entry - entry - /entry /row row entryTIDY_ATTR_DATA/entry - entry - /entry /row row entryTIDY_ATTR_DATAFLD/entry - entry - /entry /row row entryTIDY_ATTR_DATAPAGESIZE/entry - entry - /entry /row row entryTIDY_ATTR_DATASRC/entry -
[PHP-DOC] cvs: phpdoc /en/reference/misc/functions time-nanosleep.xml
daveTue Aug 10 14:45:07 2004 EDT
Modified files:
/phpdoc/en/reference/misc/functions time-nanosleep.xml
Log:
- Document time_nanosleep(), with example.
http://cvs.php.net/diff.php/phpdoc/en/reference/misc/functions/time-nanosleep.xml?r1=1.1r2=1.2ty=u
Index: phpdoc/en/reference/misc/functions/time-nanosleep.xml
diff -u phpdoc/en/reference/misc/functions/time-nanosleep.xml:1.1
phpdoc/en/reference/misc/functions/time-nanosleep.xml:1.2
--- phpdoc/en/reference/misc/functions/time-nanosleep.xml:1.1 Sun May 2 11:46:21
2004
+++ phpdoc/en/reference/misc/functions/time-nanosleep.xml Tue Aug 10 14:45:07
2004
@@ -1,22 +1,99 @@
?xml version='1.0' encoding='iso-8859-1'?
-!-- $Revision: 1.1 $ --
+!-- $Revision: 1.2 $ --
refentry id=function.time-nanosleep
refnamediv
refnametime_nanosleep/refname
refpurpose
- Delay for a number of seconds and nano seconds
+ Delay for a number of seconds and nanoseconds
/refpurpose
/refnamediv
refsect1
- titleDescription/title
+ reftitle.description;
methodsynopsis
typemixed/typemethodnametime_nanosleep/methodname
methodparamtypeint/typeparameterseconds/parameter/methodparam
methodparamtypeint/typeparameternanoseconds/parameter/methodparam
/methodsynopsis
+ para
+ Delays program execution for the given number of
+ parameterseconds/parameter and parameternanoseconds/parameter.
+ /para
+ para
+ parameterseconds/parameter must be a positive integer, and
+ parameternanoseconds/parameter must be a positive integer less than
+ 1 billion.
+ /para
+ /refsect1
+ refsect1
+ reftitle.returnvalues;
+ para
+ Returns true; on success, false; on failure.
+ /para
+ para
+ If the delay was interrupted by a signal, an associative array will be
+ returned with the components:
+ itemizedlist
+listitem
+ simpara
+ literalseconds/literal - number of seconds remaining in
+ the delay
+ /simpara
+/listitem
+listitem
+ simpara
+ literalnanoseconds/literal - number of nanoseconds
+ remaining in the delay
+ /simpara
+/listitem
+ /itemizedlist
+ /para
+ /refsect1
+ refsect1
+ reftitle.seealso;
+ para
+ functionsleep/function,
+ functionusleep/function,
+ functionset_time_limit/function
+ /para
+ /refsect1
+ refsect1
+ reftitle.examples;
+ para
+ example
+titlefunctiontime_nanosleep/function example/title
+programlisting role=php
+![CDATA[
+?php
+/* Careful! This won't work as expected if an array is returned */
+if (time_nanosleep(0, 50)) {
+echo Slept for half a second.\n;
+}
+
+/* This is better: */
+if (time_nanosleep(0, 50) === true) {
+echo Slept for half a second.\n;
+}
- warn.undocumented.func;
+/* And this is the best: */
+$nano = time_nanosleep(2, 10);
+if ($nano === true) {
+echo Slept for 2 seconds, 100 milliseconds.\n;
+}
+else if ($nano === false) {
+echo Sleeping failed.\n;
+}
+else if (is_array($nano)) {
+$seconds = $nano['seconds'];
+$nanoseconds = $nano['nanoseconds'];
+echo Interrupted by a signal.\n;
+echo Time remaining: $seconds seconds, $nanoseconds nanoseconds.;
+}
+?
+]]
+/programlisting
+ /example
+ /para
/refsect1
/refentry
[PHP-DOC] cvs: phpdoc /en/reference/misc/functions time-nanosleep.xml
daveTue Aug 10 14:47:24 2004 EDT Modified files: /phpdoc/en/reference/misc/functions time-nanosleep.xml Log: - Use return.success. http://cvs.php.net/diff.php/phpdoc/en/reference/misc/functions/time-nanosleep.xml?r1=1.2r2=1.3ty=u Index: phpdoc/en/reference/misc/functions/time-nanosleep.xml diff -u phpdoc/en/reference/misc/functions/time-nanosleep.xml:1.2 phpdoc/en/reference/misc/functions/time-nanosleep.xml:1.3 --- phpdoc/en/reference/misc/functions/time-nanosleep.xml:1.2 Tue Aug 10 14:45:07 2004 +++ phpdoc/en/reference/misc/functions/time-nanosleep.xml Tue Aug 10 14:47:24 2004 @@ -1,5 +1,5 @@ ?xml version='1.0' encoding='iso-8859-1'? -!-- $Revision: 1.2 $ -- +!-- $Revision: 1.3 $ -- refentry id=function.time-nanosleep refnamediv refnametime_nanosleep/refname @@ -27,7 +27,7 @@ refsect1 reftitle.returnvalues; para - Returns true; on success, false; on failure. + return.success; /para para If the delay was interrupted by a signal, an associative array will be
[PHP-DOC] cvs: phpdoc /en/reference/msql/functions msql-db-query.xml
yannick Tue Aug 10 14:59:05 2004 EDT Modified files: /phpdoc/en/reference/msql/functions msql-db-query.xml Log: typo http://cvs.php.net/diff.php/phpdoc/en/reference/msql/functions/msql-db-query.xml?r1=1.1r2=1.2ty=u Index: phpdoc/en/reference/msql/functions/msql-db-query.xml diff -u phpdoc/en/reference/msql/functions/msql-db-query.xml:1.1 phpdoc/en/reference/msql/functions/msql-db-query.xml:1.2 --- phpdoc/en/reference/msql/functions/msql-db-query.xml:1.1Tue Mar 2 05:16:06 2004 +++ phpdoc/en/reference/msql/functions/msql-db-query.xmlTue Aug 10 14:59:05 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.1 $ -- +!-- $Revision: 1.2 $ -- refentry id=function.msql-db-query refnamediv refnamemsql/refname @@ -8,7 +8,7 @@ refsect1 titleDescription/title methodsynopsis - typeresouce/typemethodnamemsql_db_query/methodname + typeresource/typemethodnamemsql_db_query/methodname methodparamtypestring/typeparameterdatabase/parameter/methodparam methodparamtypestring/typeparameterquery/parameter/methodparam methodparam choice=opttyperesource/typeparameterlink_identifier/parameter/methodparam
[PHP-DOC] System-dependent functions
Some functions are system-dependent in that if they're not detected at compile time, they won't be included in PHP. Currently the documentation does not tell the user any information about this type of function availability and could cause some confusion when a user tries to use a function and it says Call to undefined function. Opinions of the proposed entity?: !ENTITY note.func.sysdep 'noteparaThis function is system-dependent and may not be available in your copy of PHP. Use functionfunction_exists/function to be certain./para/note' Looking at php-src/ext/standard/basic_functions.c for example, these functions may or may not be available in your copy of PHP, depending on various factors: time_nanosleep() strftime() gmstrftime() strcoll() money_format() nl_langinfo() readlink() linkinfo() symlink() link() proc_open()proc_close() proc_terminate() proc_get_status() proc_nice()getservbyname() getservbyport()getprotobyname() getprotobynumber() asinh() aconh()atanh() hypot()inet_ntop() inet_pton()putenv() getopt() microtime() gettimeofday() stream_set_timeout() realpath() fnmatch() crypt()chroot() glob() touch() openlog() syslog() closelog() define_syslog_variables() ftok() Dave
[PHP-DOC] cvs: phpdoc /en/reference/ircg/functions ircg-list.xml
yannick Tue Aug 10 16:31:35 2004 EDT Modified files: /phpdoc/en/reference/ircg/functions ircg-list.xml Log: WS http://cvs.php.net/diff.php/phpdoc/en/reference/ircg/functions/ircg-list.xml?r1=1.1r2=1.2ty=u Index: phpdoc/en/reference/ircg/functions/ircg-list.xml diff -u phpdoc/en/reference/ircg/functions/ircg-list.xml:1.1 phpdoc/en/reference/ircg/functions/ircg-list.xml:1.2 --- phpdoc/en/reference/ircg/functions/ircg-list.xml:1.1Thu Jan 29 05:30:22 2004 +++ phpdoc/en/reference/ircg/functions/ircg-list.xmlTue Aug 10 16:31:35 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.1 $ -- +!-- $Revision: 1.2 $ -- refentry id=function.ircg-list refnamediv refnameircg_list/refname @@ -8,7 +8,7 @@ refsect1 titleDescription/title methodsynopsis - typebool/type methodnameircg_list/methodname + typebool/typemethodnameircg_list/methodname methodparamtyperesource/typeparameterconnection/parameter/methodparam methodparamtypestring/typeparameterchannel/parameter/methodparam /methodsynopsis
Re: [PHP-DOC] System-dependent functions
I think this information should be individualized per function. Each would mention the conditions that need to be met, and why it may not be met. Having one entity for this will only scare the user and force extra work on those who will have it available. I am guessing that some of these conditions are always true (natively or artificially by PHP) so that's something else to consider. A few examples. The money_format() docs have the following note: The function money_format() is only defined if the system has strfmon capabilities. For example, Windows does not, so money_format() is undefined in Windows. In this case the user at least knows they need strfmon. It is meant to show Windows is not the only problem here. Another example is touch(). It requires utime which I assume all OS's have although I don't know. And if not I assume PHP might essentially say No utime huh? Let's use mtime/atime/ctime instead and define HAVE_UTIME as true. Again, I don't know this topic of utime so am only guessing here. In summary: I agree something needs to be done although feel one entity will not do the job. Extra work, but worth it. Regards, Philip On Wed, 11 Aug 2004, Dave Barr wrote: Some functions are system-dependent in that if they're not detected at compile time, they won't be included in PHP. Currently the documentation does not tell the user any information about this type of function availability and could cause some confusion when a user tries to use a function and it says Call to undefined function. Opinions of the proposed entity?: !ENTITY note.func.sysdep 'noteparaThis function is system-dependent and may not be available in your copy of PHP. Use functionfunction_exists/function to be certain./para/note' Looking at php-src/ext/standard/basic_functions.c for example, these functions may or may not be available in your copy of PHP, depending on various factors: time_nanosleep() strftime() gmstrftime() strcoll() money_format() nl_langinfo() readlink() linkinfo() symlink() link() proc_open()proc_close() proc_terminate() proc_get_status() proc_nice()getservbyname() getservbyport()getprotobyname() getprotobynumber() asinh() aconh()atanh() hypot()inet_ntop() inet_pton()putenv() getopt() microtime() gettimeofday() stream_set_timeout() realpath() fnmatch() crypt()chroot() glob() touch() openlog() syslog() closelog() define_syslog_variables() ftok() Dave
[PHP-DOC] cvs: phpdoc /en/language functions.xml
seanTue Aug 10 17:32:50 2004 EDT Modified files: /phpdoc/en/language functions.xml Log: grammar, and para-note http://cvs.php.net/diff.php/phpdoc/en/language/functions.xml?r1=1.53r2=1.54ty=u Index: phpdoc/en/language/functions.xml diff -u phpdoc/en/language/functions.xml:1.53 phpdoc/en/language/functions.xml:1.54 --- phpdoc/en/language/functions.xml:1.53 Tue Aug 10 04:43:59 2004 +++ phpdoc/en/language/functions.xmlTue Aug 10 17:32:49 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.53 $ -- +!-- $Revision: 1.54 $ -- chapter id=language.functions titleFunctions/title @@ -131,7 +131,7 @@ PHP 3 does not support variable numbers of arguments to functions, although default arguments are supported (see link linkend=functions.arguments.defaultDefault argument -values/link for more information). PHP 4 and above supports both: see link +values/link for more information). Both are supported, as of PHP4: see link linkend=functions.variable-arg-listVariable-length argument lists/link and the function references for functionfunc_num_args/function, @@ -339,9 +339,11 @@ /screen /para -para - Default value for arguments passed by reference is supported since PHP 5. -/para +note + simpara + As of PHP 5, default values may be passed by reference. + /simpara +/note /sect2
[PHP-DOC] cvs: phpdoc /en/language functions.xml
seanTue Aug 10 17:53:00 2004 EDT Modified files: /phpdoc/en/language functions.xml Log: PHP4-PHP 4 (shame on me) http://cvs.php.net/diff.php/phpdoc/en/language/functions.xml?r1=1.54r2=1.55ty=u Index: phpdoc/en/language/functions.xml diff -u phpdoc/en/language/functions.xml:1.54 phpdoc/en/language/functions.xml:1.55 --- phpdoc/en/language/functions.xml:1.54 Tue Aug 10 17:32:49 2004 +++ phpdoc/en/language/functions.xmlTue Aug 10 17:52:59 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.54 $ -- +!-- $Revision: 1.55 $ -- chapter id=language.functions titleFunctions/title @@ -131,7 +131,7 @@ PHP 3 does not support variable numbers of arguments to functions, although default arguments are supported (see link linkend=functions.arguments.defaultDefault argument -values/link for more information). Both are supported, as of PHP4: see link +values/link for more information). Both are supported, as of PHP 4: see link linkend=functions.variable-arg-listVariable-length argument lists/link and the function references for functionfunc_num_args/function,
Re: [PHP-DOC] Proposal: CHANGELOG
I'll work on some examples, this is going to be good. Here's an example where: * Two new sections: Parameter listing and CHANGELOG * The parameter listing is a variablelist * The CHANGELOG is a table http://livedocs.phpp.org/index.php?l=enq=function.exif-thumbnail This looks pretty nice except the table has a title and we don't need that so next we'll use an informal table. Also, the following has a long description that pushes down the parameter listing but it doesn't appear to be a major (or common) problem: http://livedocs.phpp.org/index.php?l=enq=function.exif-read-data Overall this seems like the way to go. The exif extension had an enormous number of changes in PHP 4.3.0 so keep that in mind. Thanks to Sean for hosting this wonderful version of livedocs! :) Regards, Philip
[PHP-DOC] cvs: phpdoc /en/reference/misc/functions php-strip-whitespace.xml
daveTue Aug 10 19:28:15 2004 EDT Modified files: /phpdoc/en/reference/misc/functions php-strip-whitespace.xml Log: - Document php_strip_whitespace() with example. http://cvs.php.net/diff.php/phpdoc/en/reference/misc/functions/php-strip-whitespace.xml?r1=1.1r2=1.2ty=u Index: phpdoc/en/reference/misc/functions/php-strip-whitespace.xml diff -u phpdoc/en/reference/misc/functions/php-strip-whitespace.xml:1.1 phpdoc/en/reference/misc/functions/php-strip-whitespace.xml:1.2 --- phpdoc/en/reference/misc/functions/php-strip-whitespace.xml:1.1 Sun May 2 11:46:21 2004 +++ phpdoc/en/reference/misc/functions/php-strip-whitespace.xml Tue Aug 10 19:28:14 2004 @@ -1,5 +1,5 @@ ?xml version='1.0' encoding='iso-8859-1'? -!-- $Revision: 1.1 $ -- +!-- $Revision: 1.2 $ -- refentry id=function.php-strip-whitespace refnamediv refnamephp_strip_whitespace/refname @@ -8,13 +8,57 @@ /refpurpose /refnamediv refsect1 - titleDescription/title + reftitle.description; methodsynopsis typestring/typemethodnamephp_strip_whitespace/methodname - methodparamtypestring/typeparameterfile_name/parameter/methodparam + methodparamtypestring/typeparameterfilename/parameter/methodparam /methodsynopsis - warn.undocumented.func; + para + Returns the PHP source code in parameterfilename/parameter with + PHP comments and whitespace removed. This may be useful for determining the + amount of actual code in your scripts compared with the amount of comments. + /para + /refsect1 + refsect1 + reftitle.returnvalues; + para + The stripped source code will be returned on success, or an empty string + on failure. + /para + /refsect1 + refsect1 + reftitle.examples; + para + example +titlefunctionphp_strip_whitespace/function example/title +programlisting role=php +![CDATA[ +?php +// PHP comment here + +/* + * Another PHP comment + */ +echophp_strip_whitespace($_SERVER['PHP_SELF']); +// Newlines are considered whitespace, and are removed too: +do_nothing(); +? +]] +/programlisting +example.outputs; +screen +![CDATA[ +?php + echo php_strip_whitespace($_SERVER['PHP_SELF']); do_nothing(); ? +]] +/screen +para + Notice the PHP comments are gone, as are the whitespace and newline + after the first echo statement. +/para + /example + /para /refsect1 /refentry
[PHP-DOC] cvs: phpdoc /en/reference/bc/functions bcscale.xml
didou Tue Aug 10 19:43:37 2004 EDT Modified files: /phpdoc/en/reference/bc/functions bcscale.xml Log: fix build # sorry http://cvs.php.net/diff.php/phpdoc/en/reference/bc/functions/bcscale.xml?r1=1.5r2=1.6ty=u Index: phpdoc/en/reference/bc/functions/bcscale.xml diff -u phpdoc/en/reference/bc/functions/bcscale.xml:1.5 phpdoc/en/reference/bc/functions/bcscale.xml:1.6 --- phpdoc/en/reference/bc/functions/bcscale.xml:1.5Tue Aug 10 19:40:27 2004 +++ phpdoc/en/reference/bc/functions/bcscale.xmlTue Aug 10 19:43:37 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.5 $ -- +!-- $Revision: 1.6 $ -- !-- splitted from ./en/functions/bc.xml, last change in rev 1.2 -- refentry id=function.bcscale refnamediv @@ -22,9 +22,9 @@ /refsect1 refsect1 reftitle.examples; - example - titlefunctionbcscale/function example/title - programlisting role=php +example + titlefunctionbcscale/function example/title + programlisting role=php ![CDATA[ ?php @@ -37,9 +37,8 @@ ? ]] - /programlisting - /example -/para + /programlisting +/example /refsect1 /refentry
[PHP-DOC] cvs: phpdoc /en/reference/misc/functions php-strip-whitespace.xml
daveTue Aug 10 20:00:49 2004 EDT Modified files: /phpdoc/en/reference/misc/functions php-strip-whitespace.xml Log: - Add note about prior 5.0.1 bug #29606. http://cvs.php.net/diff.php/phpdoc/en/reference/misc/functions/php-strip-whitespace.xml?r1=1.2r2=1.3ty=u Index: phpdoc/en/reference/misc/functions/php-strip-whitespace.xml diff -u phpdoc/en/reference/misc/functions/php-strip-whitespace.xml:1.2 phpdoc/en/reference/misc/functions/php-strip-whitespace.xml:1.3 --- phpdoc/en/reference/misc/functions/php-strip-whitespace.xml:1.2 Tue Aug 10 19:28:14 2004 +++ phpdoc/en/reference/misc/functions/php-strip-whitespace.xml Tue Aug 10 20:00:48 2004 @@ -1,5 +1,5 @@ ?xml version='1.0' encoding='iso-8859-1'? -!-- $Revision: 1.2 $ -- +!-- $Revision: 1.3 $ -- refentry id=function.php-strip-whitespace refnamediv refnamephp_strip_whitespace/refname @@ -18,6 +18,14 @@ PHP comments and whitespace removed. This may be useful for determining the amount of actual code in your scripts compared with the amount of comments. /para + note + para +This function works as described as of PHP 5.0.1. Before this it would +only return an empty string. For more information on this bug and its +prior behavior, see bug report +ulink url=url.php.bugs;29606#29606/ulink. + /para + /note /refsect1 refsect1 reftitle.returnvalues;
[PHP-DOC] cvs: phpdoc /en/reference/misc/functions php-strip-whitespace.xml
daveTue Aug 10 20:21:26 2004 EDT Modified files: /phpdoc/en/reference/misc/functions php-strip-whitespace.xml Log: - Similar to php -w. http://cvs.php.net/diff.php/phpdoc/en/reference/misc/functions/php-strip-whitespace.xml?r1=1.3r2=1.4ty=u Index: phpdoc/en/reference/misc/functions/php-strip-whitespace.xml diff -u phpdoc/en/reference/misc/functions/php-strip-whitespace.xml:1.3 phpdoc/en/reference/misc/functions/php-strip-whitespace.xml:1.4 --- phpdoc/en/reference/misc/functions/php-strip-whitespace.xml:1.3 Tue Aug 10 20:00:48 2004 +++ phpdoc/en/reference/misc/functions/php-strip-whitespace.xml Tue Aug 10 20:21:26 2004 @@ -1,5 +1,5 @@ ?xml version='1.0' encoding='iso-8859-1'? -!-- $Revision: 1.3 $ -- +!-- $Revision: 1.4 $ -- refentry id=function.php-strip-whitespace refnamediv refnamephp_strip_whitespace/refname @@ -17,6 +17,8 @@ Returns the PHP source code in parameterfilename/parameter with PHP comments and whitespace removed. This may be useful for determining the amount of actual code in your scripts compared with the amount of comments. + This is similar to using commandphp -w/command from the + link linkend=features.commandlinecommandline/link. /para note para
Re: [PHP-DOC] cvs: phpdoc /en/reference/bc/functions bcadd.xml bccomp.xml bcdiv.xml bcmod.xml bcmul.xml bcpow.xml bcpowmod.xml bcscale.xml bcsqrt.xml bcsub.xml
Log: Switched bcmath to the new doc style # also moved a note before the example and removed unneeded screen tags We're not ready to convert old documentation to the new doc style, please wait until the new style is finalized. The changelog and parameter listing implementations are still being worked on. Regards, Philip
Re: [PHP-DOC] cvs: phpdoc /en/reference/bc/functions bcadd.xml bccomp.xml bcdiv.xml bcmod.xml bcmul.xml bcpow.xml bcpowmod.xml bcscale.xml bcsqrt.xml bcsub.xml
Oups, didn't have the time to read the ChangeLog thread, really sorry. I'll wait and have a look :) didou Philip Olson wrote: Log: Switched bcmath to the new doc style # also moved a note before the example and removed unneeded screen tags We're not ready to convert old documentation to the new doc style, please wait until the new style is finalized. The changelog and parameter listing implementations are still being worked on. Regards, Philip
[PHP-DOC] cvs: phpdoc /en/reference/strings/functions sprintf.xml
daveTue Aug 10 21:50:46 2004 EDT Modified files: /phpdoc/en/reference/strings/functions sprintf.xml Log: - Document sign specifier. http://cvs.php.net/diff.php/phpdoc/en/reference/strings/functions/sprintf.xml?r1=1.12r2=1.13ty=u Index: phpdoc/en/reference/strings/functions/sprintf.xml diff -u phpdoc/en/reference/strings/functions/sprintf.xml:1.12 phpdoc/en/reference/strings/functions/sprintf.xml:1.13 --- phpdoc/en/reference/strings/functions/sprintf.xml:1.12 Sat Aug 7 21:30:40 2004 +++ phpdoc/en/reference/strings/functions/sprintf.xml Tue Aug 10 21:50:46 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.12 $ -- +!-- $Revision: 1.13 $ -- !-- splitted from ./en/functions/strings.xml, last change in rev 1.2 -- refentry id=function.sprintf refnamediv @@ -33,6 +33,15 @@ orderedlist listitem simpara +An optional emphasissign specifier/emphasis that forces a sign +(- or +) to be used on a number. By default, only the - sign is used +on a number if it's negative. This modifier forces positive numbers +to have the + sign attached as well. This specifier was added in +PHP 4.3.0. + /simpara + /listitem + listitem + simpara An optional emphasispadding specifier/emphasis that says what character will be used for padding the results to the right string size. This may be a space character or a @@ -97,7 +106,7 @@ /member member literalf/literal - the argument is treated as a - typefloat/type, and presented as a floating-point number. + float, and presented as a floating-point number. /member member literalo/literal - the argument is treated as an @@ -212,6 +221,9 @@ printf(%%s = '%s'\n, $n); // string representation printf(%%x = '%x'\n, $n); // hexadecimal representation (lower-case) printf(%%X = '%X'\n, $n); // hexadecimal representation (upper-case) + +printf(%%+d = '%+d'\n, $n); // sign specifier on a positive integer +printf(%%+d = '%+d'\n, $u); // sign specifier on a negative integer ? ]] /programlisting @@ -231,6 +243,8 @@ %s = '43951789' %x = '29ea6ad' %X = '29EA6AD' +%+d = '+43951789' +%+d = '-43951789' ]] /screen /example
[PHP-DOC] cvs: phpdoc /en/reference/strings/functions sprintf.xml
daveTue Aug 10 21:52:42 2004 EDT Modified files: /phpdoc/en/reference/strings/functions sprintf.xml Log: - Fix wording. http://cvs.php.net/diff.php/phpdoc/en/reference/strings/functions/sprintf.xml?r1=1.13r2=1.14ty=u Index: phpdoc/en/reference/strings/functions/sprintf.xml diff -u phpdoc/en/reference/strings/functions/sprintf.xml:1.13 phpdoc/en/reference/strings/functions/sprintf.xml:1.14 --- phpdoc/en/reference/strings/functions/sprintf.xml:1.13 Tue Aug 10 21:50:46 2004 +++ phpdoc/en/reference/strings/functions/sprintf.xml Tue Aug 10 21:52:42 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.13 $ -- +!-- $Revision: 1.14 $ -- !-- splitted from ./en/functions/strings.xml, last change in rev 1.2 -- refentry id=function.sprintf refnamediv @@ -35,9 +35,8 @@ simpara An optional emphasissign specifier/emphasis that forces a sign (- or +) to be used on a number. By default, only the - sign is used -on a number if it's negative. This modifier forces positive numbers -to have the + sign attached as well. This specifier was added in -PHP 4.3.0. +on a number if it's negative. This specifier forces positive numbers +to have the + sign attached as well, and was added in PHP 4.3.0. /simpara /listitem listitem
[PHP-DOC] cvs: phpdoc /en/reference/misc/functions uniqid.xml
daveTue Aug 10 23:04:15 2004 EDT Modified files: /phpdoc/en/reference/misc/functions uniqid.xml Log: - Fix protos. - Update version-specific information. - Expand LCG acronym. - Clean up example. http://cvs.php.net/diff.php/phpdoc/en/reference/misc/functions/uniqid.xml?r1=1.6r2=1.7ty=u Index: phpdoc/en/reference/misc/functions/uniqid.xml diff -u phpdoc/en/reference/misc/functions/uniqid.xml:1.6 phpdoc/en/reference/misc/functions/uniqid.xml:1.7 --- phpdoc/en/reference/misc/functions/uniqid.xml:1.6 Thu Jul 22 20:18:22 2004 +++ phpdoc/en/reference/misc/functions/uniqid.xml Tue Aug 10 23:04:14 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.6 $ -- +!-- $Revision: 1.7 $ -- !-- splitted from ./en/functions/misc.xml, last change in rev 1.2 -- refentry id=function.uniqid refnamediv @@ -10,31 +10,33 @@ titleDescription/title methodsynopsis typestring/typemethodnameuniqid/methodname - methodparamtypestring/typeparameterprefix/parameter/methodparam - methodparam choice=opttypebool/typeparameterlcg/parameter/methodparam + methodparam choice=opttypestring/typeparameterprefix/parameter/methodparam + methodparam choice=opttypebool/typeparametermore_entropy/parameter/methodparam /methodsynopsis simpara functionuniqid/function returns a prefixed unique identifier - based on the current time in microseconds. The prefix can be - useful for instance if you generate identifiers simultaneously on - several hosts that might happen to generate the identifier at the - same microsecond. parameterPrefix/parameter can be up to 114 + based on the current time in microseconds. parameterprefix/parameter + is optional but can be useful, for instance, if you generate identifiers + simultaneously on several hosts that might happen to generate the + identifier at the same microsecond. Up until PHP 4.3.1, + parameterprefix/parameter could only be a maximum of 114 characters long. /simpara simpara - If the optional parameterlcg/parameter parameter is true;, - functionuniqid/function will add additional combined LCG - entropy at the end of the return value, which should make the - results more unique. + If the optional parametermore_entropy/parameter parameter is + true;, functionuniqid/function will add additional entropy (using + the combined linear congruential generator) at the end of the return + value, which should make the results more unique. /simpara simpara With an empty parameterprefix/parameter, the returned string - will be 13 characters long. If parameterlcg/parameter is + will be 13 characters long. If parametermore_entropy/parameter is true;, it will be 23 characters. /simpara note simpara - The parameterlcg/parameter parameter was introduced in PHP 3.0.13. + The parametermore_entropy/parameter parameter was introduced + in PHP 3.0.13. /simpara /note para @@ -48,7 +50,7 @@ ![CDATA[ ?php // no prefix -$token = md5(uniqid()); +$token = md5(uniqid()); // better, difficult to guess $better_token = md5(uniqid(rand(), true));
[PHP-DOC] Socket_Set_Option
There should be a reference saying that socket_setop is a alias of http://us2.php.net/manual/en/function.socket-set-option.php. -Anoynomus
