[PHP-DOC] cvs: phpdoc /en/language basic-syntax.xml
derek Thu Jan 20 03:42:56 2005 EDT
Modified files:
/phpdoc/en/language basic-syntax.xml
Log:
restructured the docbook elements to follow
this
that
the other
Rewrote the sections, which were redundant, and added a few more
examples.
http://cvs.php.net/diff.php/phpdoc/en/language/basic-syntax.xml?r1=1.39r2=1.40ty=u
Index: phpdoc/en/language/basic-syntax.xml
diff -u phpdoc/en/language/basic-syntax.xml:1.39
phpdoc/en/language/basic-syntax.xml:1.40
--- phpdoc/en/language/basic-syntax.xml:1.39Tue Jan 11 08:43:09 2005
+++ phpdoc/en/language/basic-syntax.xml Thu Jan 20 03:42:54 2005
@@ -1,85 +1,76 @@
?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.39 $ --
+!-- $Revision: 1.40 $ --
chapter id=language.basic-syntax
titleBasic syntax/title
-
- !--
-
-NOTE: Last modified: 2001-05-16 13:00 GMT
-
-the language part is currently under heavy revision. Please do not
-not make any heavy (i.e. structural) modifications to this part
-for a moment.
-
-You'd also better not start any translation yet.
-
-Comments are always welcome at phpdoc@lists.php.net
-
-Progress:
-
- intro : DOESN'T EXIST - yet?
- new chapter, with some introductionary remarks?
- Will be discussed on the ML soon.
- basic-syntax:
- FINISHED
- except maybe moving the 'advanced escaping'
- to a better place?
- TODO:
- - nada
- types : Being revised. Added all new types
- Boolean and Integer are more or less finished.
- The rest isn't.
- TODO:
- - why is $foo[bar] bad syntax?
- - what's the difference between unset($bla) and
-$bla = NULL; (it is different!)
- - $obj-{expr} syntax
- - (unset) cast?
- - $bla = unset == should've been nuked, don't mention it
- - $str{offset} syntax, rather than $str[offset]
- - read notes and apply when any of them are useful
- - remove notes which have been included here.
- - ...
- the rest: Not yet started with.
- TODO:
- - ?
- oop : has been revised by Kristian, DONE.
- --
-
sect1 id=language.basic-syntax.phpmode
titleEscaping from HTML/title
-
para
-When PHP parses a file, it simply passes the text of the file
-through until it encounters one of the special tags which tell it
-to start interpreting the text as PHP code. The parser then
-executes all the code it finds, up until it runs into a PHP
-closing tag, which tells the parser to just start passing the text
-through again. This is the mechanism which allows you to embed PHP
-code inside HTML: everything outside the PHP tags is left utterly
-alone, while everything inside is parsed as code.
+When PHP parses a file, it looks for opening and closing tags,
+which tell PHP to start and stop interpreting the code between
+them. Parsing in this manner allows php to be embedded in all
+sorts of different documents, as everything outside of a pair
+of opening and closing tags is ignored by the PHP parser.
+Most of the time you will see php embedded in HTML documents,
+as in this example.
+informalexample
+ programlisting role=php
+![CDATA[
+pThis is going to be ignored./p
+?php echo 'While this is going to be parsed.'; ?
+pThis will also be ignored./p
+]]
+ /programlisting
+/informalexample
/para
-
para
-There are four sets of tags which can be used to denote blocks of
-PHP code. Of these, only two (lt;?php. . .?gt; and lt;script
-language=phpgt;. . .lt;/scriptgt;) are always available; the
-others can be turned on or off from the
-php.ini; configuration file. While the
-short-form tags and ASP-style tags may be convenient, they are not
-as portable as the longer versions. Also, if you intend to embed
-PHP code in XML or XHTML, you will need to use the
-lt;?php. . .?gt; form to conform to the XML.
+You can also use more advanced structures:
+example
+ titleAdvanced escaping/title
+ programlisting role=php
+![CDATA[
+?php
+if ($expression) {
+?
+strongThis is true./strong
+?php
+} else {
+?
+strongThis is false./strong
+?php
+}
+?
+]]
+ /programlisting
+/example
+This works as expected, because when PHP hits the ?gt; closing
+tags, it simply starts outputting whatever it finds until it hits
+another opening tag. The example given here is contrived, of
+course, but for outputting large blocks of text, dropping out of
+PHP parsing mode is generally more efficient than sending all of
+the text through functionecho/function or
+functionprint/function.
/para
-
para
-The tags supported by PHP are:
[PHP-DOC] cvs: phpdoc /en/reference/funchand/functions call-user-func.xml
hsc Thu Jan 20 07:44:59 2005 EDT Modified files: /phpdoc/en/reference/funchand/functions call-user-func.xml Log: listendand; entity added http://cvs.php.net/diff.php/phpdoc/en/reference/funchand/functions/call-user-func.xml?r1=1.12r2=1.13ty=u Index: phpdoc/en/reference/funchand/functions/call-user-func.xml diff -u phpdoc/en/reference/funchand/functions/call-user-func.xml:1.12 phpdoc/en/reference/funchand/functions/call-user-func.xml:1.13 --- phpdoc/en/reference/funchand/functions/call-user-func.xml:1.12 Sun Sep 12 05:49:55 2004 +++ phpdoc/en/reference/funchand/functions/call-user-func.xml Thu Jan 20 07:44:59 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.12 $ -- +!-- $Revision: 1.13 $ -- !-- splitted from ./en/functions/funchand.xml, last change in rev 1.1 -- refentry id=function.call-user-func refnamediv @@ -89,7 +89,7 @@ See also: functionis_callable/function, functioncall_user_func_array/function, - and seealso.callback; + listendand; seealso.callback;. /para /refsect1 /refentry
[PHP-DOC] #31622 [NEW]: [DOC] [French] Translation problem
From: nicolas dot pingard at laposte dot net Operating system: Irrelevant PHP version: Irrelevant PHP Bug Type: Documentation problem Bug description: [DOC] [French] Translation problem Description: Petit problème de traduction sur la page de la fonction ora_numrows : http://fr2.php.net/manual/fr/function.ora-numrows.php Cette fonction retourne le nombre de *lignes* (rows) du resultset d'une requête, pas le nombre de colonnes. -- Edit bug report at http://bugs.php.net/?id=31622edit=1 -- Try a CVS snapshot (php4): http://bugs.php.net/fix.php?id=31622r=trysnapshot4 Try a CVS snapshot (php5.0): http://bugs.php.net/fix.php?id=31622r=trysnapshot50 Try a CVS snapshot (php5.1): http://bugs.php.net/fix.php?id=31622r=trysnapshot51 Fixed in CVS:http://bugs.php.net/fix.php?id=31622r=fixedcvs Fixed in release:http://bugs.php.net/fix.php?id=31622r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=31622r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=31622r=needscript Try newer version: http://bugs.php.net/fix.php?id=31622r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=31622r=support Expected behavior: http://bugs.php.net/fix.php?id=31622r=notwrong Not enough info: http://bugs.php.net/fix.php?id=31622r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=31622r=submittedtwice register_globals:http://bugs.php.net/fix.php?id=31622r=globals PHP 3 support discontinued: http://bugs.php.net/fix.php?id=31622r=php3 Daylight Savings:http://bugs.php.net/fix.php?id=31622r=dst IIS Stability: http://bugs.php.net/fix.php?id=31622r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=31622r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=31622r=float No Zend Extensions: http://bugs.php.net/fix.php?id=31622r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=31622r=mysqlcfg
[PHP-DOC] #31622 [Opn-Csd]: [DOC] [French] Translation problem
ID: 31622 Updated by: [EMAIL PROTECTED] Reported By: nicolas dot pingard at laposte dot net -Status: Open +Status: Closed Bug Type: Documentation problem Operating System: Irrelevant PHP Version: Irrelevant 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: [2005-01-20 15:01:10] nicolas dot pingard at laposte dot net Description: Petit problème de traduction sur la page de la fonction ora_numrows : http://fr2.php.net/manual/fr/function.ora-numrows.php Cette fonction retourne le nombre de *lignes* (rows) du resultset d'une requête, pas le nombre de colonnes. -- Edit this bug report at http://bugs.php.net/?id=31622edit=1
[PHP-DOC] State of Livedocs
Hello, I noticed (actually, Nuno pointed it out to me) that Jacques has been given livedocs karma. There's been much off-list talk (IRC) about livedocs, recently. Can someone (I'm thinking Jacques, as he must've been granted karma for a reason) please give a summary of the current status of livedocs, and what the development process will entail in the future? (I ask because there were rumours of a fork, a second CVS repository, non-centralized bug databases, patch queues, etc etc) Thanks, S
Re: [PHP-DOC] cvs: phpdoc /en/language basic-syntax.xml
Just some thoughts: * You can remove the PHP 3 stuff; Not if you ask Philip for example :) I am hesitant on keeping old content or removing it... There are still PHP 3 deployments out there. Goba
Re: [PHP-DOC] greek language translation
Hi Yannis, I would like to help in the greek translation of the manual but I don't know what to do. Please give me some information on what I should do. Please read http://php.net/dochowto where you will be able to find info on the language specific mailing lists. The Greek mailing list is [EMAIL PROTECTED] Regards, Gabor Hojtsy
[PHP-DOC] cvs: phpdoc /en/reference/ftp/functions ftp-get.xml ftp-nb-fget.xml ftp-nb-get.xml
didou Thu Jan 20 13:11:54 2005 EDT Modified files: /phpdoc/en/reference/ftp/functions ftp-get.xml ftp-nb-fget.xml ftp-nb-get.xml Log: Another commit for mazzanet, fixing parts of #31567 http://cvs.php.net/diff.php/phpdoc/en/reference/ftp/functions/ftp-get.xml?r1=1.9r2=1.10ty=u Index: phpdoc/en/reference/ftp/functions/ftp-get.xml diff -u phpdoc/en/reference/ftp/functions/ftp-get.xml:1.9 phpdoc/en/reference/ftp/functions/ftp-get.xml:1.10 --- phpdoc/en/reference/ftp/functions/ftp-get.xml:1.9 Sun Jan 16 00:09:23 2005 +++ phpdoc/en/reference/ftp/functions/ftp-get.xml Thu Jan 20 13:11:54 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.9 $ -- +!-- $Revision: 1.10 $ -- refentry id=function.ftp-get refnamediv refnameftp_get/refname @@ -36,7 +36,7 @@ termparameterlocal_file/parameter/term listitem para - The local file path. + The local file path (will be overwritten if the file already exists). /para /listitem /varlistentry http://cvs.php.net/diff.php/phpdoc/en/reference/ftp/functions/ftp-nb-fget.xml?r1=1.8r2=1.9ty=u Index: phpdoc/en/reference/ftp/functions/ftp-nb-fget.xml diff -u phpdoc/en/reference/ftp/functions/ftp-nb-fget.xml:1.8 phpdoc/en/reference/ftp/functions/ftp-nb-fget.xml:1.9 --- phpdoc/en/reference/ftp/functions/ftp-nb-fget.xml:1.8 Sun Jan 16 00:09:23 2005 +++ phpdoc/en/reference/ftp/functions/ftp-nb-fget.xml Thu Jan 20 13:11:54 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.8 $ -- +!-- $Revision: 1.9 $ -- refentry id=function.ftp-nb-fget refnamediv refnameftp_nb_fget/refname @@ -125,7 +125,7 @@ memberfunctionftp_nb_get/function/member memberfunctionftp_nb_continue/function/member memberfunctionftp_fget/function/member -memberfunctionftp_fget/function/member +memberfunctionftp_get/function/member /simplelist /para /refsect1 http://cvs.php.net/diff.php/phpdoc/en/reference/ftp/functions/ftp-nb-get.xml?r1=1.9r2=1.10ty=u Index: phpdoc/en/reference/ftp/functions/ftp-nb-get.xml diff -u phpdoc/en/reference/ftp/functions/ftp-nb-get.xml:1.9 phpdoc/en/reference/ftp/functions/ftp-nb-get.xml:1.10 --- phpdoc/en/reference/ftp/functions/ftp-nb-get.xml:1.9Sun Jan 16 00:09:23 2005 +++ phpdoc/en/reference/ftp/functions/ftp-nb-get.xmlThu Jan 20 13:11:54 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.9 $ -- +!-- $Revision: 1.10 $ -- refentry id=function.ftp-nb-get refnamediv refnameftp_nb_get/refname @@ -41,7 +41,7 @@ termparameterlocal_file/parameter/term listitem para - The local file path. + The local file path (will be overwritten if the file already exists). /para /listitem /varlistentry @@ -173,7 +173,7 @@ memberfunctionftp_nb_fget/function/member memberfunctionftp_nb_continue/function/member memberfunctionftp_fget/function/member -memberfunctionftp_fget/function/member +memberfunctionftp_get/function/member /simplelist /para /refsect1
[PHP-DOC] cvs: phpdoc /en/reference/soap reference.xml
didou Thu Jan 20 13:36:04 2005 EDT Modified files: /phpdoc/en/reference/soap reference.xml Log: Add SoapClient-__setCookie() docs http://cvs.php.net/diff.php/phpdoc/en/reference/soap/reference.xml?r1=1.5r2=1.6ty=u Index: phpdoc/en/reference/soap/reference.xml diff -u phpdoc/en/reference/soap/reference.xml:1.5 phpdoc/en/reference/soap/reference.xml:1.6 --- phpdoc/en/reference/soap/reference.xml:1.5 Sun Jan 16 00:28:55 2005 +++ phpdoc/en/reference/soap/reference.xml Thu Jan 20 13:36:04 2005 @@ -1,5 +1,5 @@ ?xml version='1.0' encoding='iso-8859-1'? -!-- $Revision: 1.5 $ -- +!-- $Revision: 1.6 $ -- !-- Generated by xml_proto.php v2.0. Found in /scripts directory of phpdoc. -- reference id=ref.soap titleSOAP Functions/title @@ -79,6 +79,10 @@ listitem paraxref linkend='function.soap-soapclient-gettypes' / - Returns list of SOAP types/para /listitem + listitem + paraxref linkend='function.soap-soapclient-setcookie' / - Sets the + cookie that will be sent with the SOAP request/para + /listitem /itemizedlist /section /section
[PHP-DOC] cvs: phpdoc /en/reference/soap/functions soap-soapclient-setcookie.xml
didou Thu Jan 20 13:37:44 2005 EDT Added files: /phpdoc/en/reference/soap/functions soap-soapclient-setcookie.xml Log: Add SoapClient-__setCookie() docs http://cvs.php.net/co.php/phpdoc/en/reference/soap/functions/soap-soapclient-setcookie.xml?r=1.1p=1 Index: phpdoc/en/reference/soap/functions/soap-soapclient-setcookie.xml +++ phpdoc/en/reference/soap/functions/soap-soapclient-setcookie.xml ?xml version='1.0' encoding='iso-8859-1'? !-- $Revision: 1.1 $ -- refentry id=function.soap-soapclient-setcookie refnamediv refnameSoapClient-__setCookie()/refname refpurpose Sets the cookie that will be sent with the SOAP request /refpurpose /refnamediv refsect1 role=description reftitle.description; classsynopsis ooclassclassnameSoapClient/classname/ooclass methodsynopsis typevoid/type methodname__setCookie/methodname methodparamtypestring/typeparametername/parameter/methodparam methodparam choice=opttypestring/typeparametervalue/parameter/methodparam /methodsynopsis /classsynopsis para Defines a cookie to be sent along with the SOAP requests. /para note para Calling this method will affect all following calls to classnameSoapClient/classname methods. /para /note /refsect1 refsect1 role=parameters reftitle.parameters; para variablelist varlistentry termparametername/parameter/term listitem para The name of the cookie. /para /listitem /varlistentry varlistentry termparametervalue/parameter/term listitem para The value of the cookie. If not specified, the cookie will be deleted. /para /listitem /varlistentry /variablelist /para /refsect1 refsect1 role=returnvalues reftitle.returnvalues; para return.void; /para /refsect1 /refentry !-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:../../../../manual.ced sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --
[PHP-DOC] #31567 [Opn]: ref.ftp: missing stuff
ID: 31567 Updated by: [EMAIL PROTECTED] Reported By: didou at keliglia dot com Status: Open Bug Type:Documentation problem PHP Version: Irrelevant New Comment: The first was fixed by mazzanet Previous Comments: [2005-01-16 07:00:24] didou at keliglia dot com Also, the configure section doesn't mention PHP5. [2005-01-16 06:53:08] didou at keliglia dot com Description: Not mentionned: - ftp_*get() will overwrite the local files. - one can pass options to ftp_site, ftp_nlist, etc. We need to document this. This is because no escaping is performed in the C sources. It can also introduce bugs (for filenames with spaces, etc - ftp_connect() doesn't support proxies. (or maybe it's okay now ?) There are notes dealing with the subject. have fun! -- Edit this bug report at http://bugs.php.net/?id=31567edit=1
[PHP-DOC] chinese traditional
hello, i'd like to help with chinese traditional translation. the mailing somebody gave me is not valid, [EMAIL PROTECTED] and i don't think the translation have been updated recently, is anybody still doing it? thanks
Re: [PHP-DOC] chinese traditional
hello, i'd like to help with chinese traditional translation. the mailing somebody gave me is not valid, [EMAIL PROTECTED] and i don't think the translation have been updated recently, is anybody still doing it? thanks lists.php.net is our list server. Goba
Re: [PHP-DOC] cvs: phpdoc /en/language basic-syntax.xml
Just some thoughts: * You can remove the PHP 3 stuff; Not if you ask Philip for example :) I am hesitant on keeping old content or removing it... There are still PHP 3 deployments out there. From the 2003 Doc Meeting proposal: /RFC/2003_meeting_agenda.html In an effort to preserve history and possible PHP 3 users, we need to keep this information available but at the same time it adds clutter to the documentation. One proposal is to list all PHP 3 information in it's own appendix, and add appropriate links/notes to them. Within a manual page, one will see a simple link titled PHP 3 Note and it'll link to the appropriate location in the PHP 3 Appendix. In here it might mention a feature was added in PHP 3, etc. Most people seemed to like this idea, no specifics have been discussed. See Also: http://marc.theaimsgroup.com/?l=phpdocm=104328040919058 And from the 2003 Doc Meeting findings: /RFC/2003_meeting_findings.txt We discussed the complete removal of the Extending PHP 3 section, and the complete removal of the debugging section. For the rest of the manual, every PHP 3 specific section should be marked clearly as such. At this point we may want to create a PHP 3 section in the appendix that lists all PHP 3 specific information as anyone who still uses PHP 3 should read this entire section at one setting anyways. No need for PHP 3 notes within the docs. PHP 2 users have their own manual :) Regards, Philip
Re: [PHP-DOC] cvs: phpdoc /en/language basic-syntax.xml
Philip Olson wrote: Just some thoughts: * You can remove the PHP 3 stuff; Not if you ask Philip for example :) I am hesitant on keeping old content or removing it... There are still PHP 3 deployments out there. From the 2003 Doc Meeting proposal: /RFC/2003_meeting_agenda.html In an effort to preserve history and possible PHP 3 users, we need to keep this information available but at the same time it adds clutter to the documentation. One proposal is to list all PHP 3 information in it's own appendix, and add appropriate links/notes to them. Within a manual page, one will see a simple link titled PHP 3 Note and it'll link to the appropriate location in the PHP 3 Appendix. In here it might mention a feature was added in PHP 3, etc. Most people seemed to like this idea, no specifics have been discussed. See Also: http://marc.theaimsgroup.com/?l=phpdocm=104328040919058 And from the 2003 Doc Meeting findings: /RFC/2003_meeting_findings.txt We discussed the complete removal of the Extending PHP 3 section, and the complete removal of the debugging section. For the rest of the manual, every PHP 3 specific section should be marked clearly as such. At this point we may want to create a PHP 3 section in the appendix that lists all PHP 3 specific information as anyone who still uses PHP 3 should read this entire section at one setting anyways. No need for PHP 3 notes within the docs. PHP 2 users have their own manual :) Regards, Philip I'm not one for removing something from the manual just because it's old. A PHP3 Appendix will work, but will be difficult to write because the notes about PHP3 are sparse and distanced. Why should the Extending PHP3 sections be removed? Are there plans to write new documentation regarding writing Extensions? (There needs to be more/better documentation for extension writers; Whenever I started playing around I relied mostly on people on IRC for help, and didn't continue learning that monster of an API for very long.)
