cvs: phpdoc / faqurls.ent /en/faq common.xml html.xml
| From: | Hojtsy Gabor | Date: | Sun, 14 Oct 2001 10:41:35 +0000 |
| Subject: | cvs: phpdoc / faqurls.ent /en/faq common.xml html.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969337973@lists.php.net to get a copy of this message | ||
goba Sun Oct 14 06:41:35 2001 EDT
Modified files:
/phpdoc faqurls.ent
/phpdoc/en/faq common.xml html.xml
Log:
General updates, adding more info to HTML array generation
Index: phpdoc/faqurls.ent diff -u phpdoc/faqurls.ent:1.14 phpdoc/faqurls.ent:1.15 --- phpdoc/faqurls.ent:1.14 Sun Oct 14 05:16:30 2001 +++ phpdoc/faqurls.ent Sun Oct 14 06:41:34 2001 @@ -1,6 +1,6 @@ <!-- -*- SGML -*- - $Id: faqurls.ent,v 1.14 2001/10/14 09:16:30 goba Exp $ + $Id: faqurls.ent,v 1.15 2001/10/14 10:41:34 goba Exp $ Contains "macros" for all the XML documents within the FAQ. @@ -43,6 +43,8 @@ <!ENTITY faqurl.php.bugs "http://bugs.php.net/"> <!ENTITY faqurl.php.download "http://www.php.net/downloads.php"> <!ENTITY faqurl.php.manual "http://www.php.net/manual/"> +<!ENTITY faqurl.php.news "news://news.php.net/"> +<!ENTITY faqurl.php.newsweb "http://news.php.net/"> <!ENTITY faqurl.php.support "http://www.php.net/support.php"> <!ENTITY faqurl.php.support.winbuild "http://www.php.net/extra/win32build.zip"> <!ENTITY faqurl.readline "ftp://prep.ai.mit.edu/pub/gnu/readline/"> Index: phpdoc/en/faq/common.xml diff -u phpdoc/en/faq/common.xml:1.6 phpdoc/en/faq/common.xml:1.7 --- phpdoc/en/faq/common.xml:1.6 Sun Sep 30 17:46:11 2001 +++ phpdoc/en/faq/common.xml Sun Oct 14 06:41:34 2001 @@ -1,13 +1,13 @@ <?xml encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <chapter id="faq.common"> <title>Common Problems</title> <titleabbrev>Common Problems</titleabbrev> - <para> - Here is a bunch of common problems, met every - day with PHP, and solved the easy way! - </para> + <para> + Here is a bunch of common problems, met every + day with PHP, and solved the easy way! + </para> <qandaset> <qandaentry id="faq.common.nodata"> @@ -27,59 +27,60 @@ to help the developers pinpoint the problem. If you are using PHP as an Apache module try something like: <itemizedlist> - <listitem> - <para> + <listitem> + <para> Stop your httpd processes - </para> - </listitem> - <listitem> - <para> + </para> + </listitem> + <listitem> + <para> gdb httpd - </para> - </listitem> - <listitem> - <para> + </para> + </listitem> + <listitem> + <para> Stop your httpd processes - </para> - </listitem> - <listitem> - <para> + </para> + </listitem> + <listitem> + <para> > run -X -f /path/to/httpd.conf - </para> - </listitem> - <listitem> - <para> + </para> + </listitem> + <listitem> + <para> Then fetch the URL causing the problem with your browser - </para> - </listitem> - <listitem> - <para> + </para> + </listitem> + <listitem> + <para> > run -X -f /path/to/httpd.conf - </para> - </listitem> - <listitem> - <para> + </para> + </listitem> + <listitem> + <para> If you are getting a core dump, gdb should inform you of this now - </para> - </listitem> - <listitem> - <para> + </para> + </listitem> + <listitem> + <para> type: bt - </para> - </listitem> - <listitem> - <para> + </para> + </listitem> + <listitem> + <para> You should include your backtrace in your bug report. This should be submitted to <ulink url="&faqurl.php.bugs;">&faqurl.php.bugs;</ulink> - </para> - </listitem> + </para> + </listitem> </itemizedlist> </para> <para> If your script uses the regular expression functions - (<function>ereg()</function> and friends), you should make sure + (<function>ereg</function> and friends), you should make sure that you compiled PHP and Apache with the same regular - expression package. (This should happen automatically with PHP and Apache 1.3.x) + expression package. This should happen automatically with + PHP and Apache 1.3.x </para> </answer> </qandaentry> @@ -94,10 +95,10 @@ </question> <answer> <para> - Environment variables are now normal global variables, so you must - either declare them as global variables in your function (by using - "<literal>global $DOCUMENT_ROOT;</literal>", for example) or by using - the global variable array (ie, "<literal>$GLOBALS["DOCUMENT_ROOT"]</literal>". + Environment variables are normal global variables, so you must + either declare them as global variables in your function (by using + "<literal>global $DOCUMENT_ROOT;</literal>", for example) or by using + the global variable array (ie, "<literal>$GLOBALS["DOCUMENT_ROOT"]</literal>". </para> </answer> </qandaentry> @@ -106,7 +107,7 @@ <question> <para> I patched Apache with the FrontPage extensions patch, and suddenly PHP stopped - working. Is PHP incompatible with the Apache FrontPage extensions? + working. Is PHP incompatible with the Apache FrontPage extensions? </para> </question> <answer> @@ -124,7 +125,7 @@ <question> <para> I think I found a bug! Who should I tell? - </para> + </para> </question> <answer> <para> Index: phpdoc/en/faq/html.xml diff -u phpdoc/en/faq/html.xml:1.4 phpdoc/en/faq/html.xml:1.5 --- phpdoc/en/faq/html.xml:1.4 Fri Sep 21 18:47:31 2001 +++ phpdoc/en/faq/html.xml Sun Oct 14 06:41:34 2001 @@ -1,13 +1,13 @@ <?xml encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <chapter id="faq.html"> <title>PHP and HTML</title> <titleabbrev>PHP and HTML</titleabbrev> - <para> - PHP and HTML interact a lot : PHP generate HTML, and HTML - has informations that will be sent to PHP. - </para> + <para> + PHP and HTML interact a lot : PHP generate HTML, and HTML + has informations that will be sent to PHP. + </para> <qandaset> <qandaentry id="faq.html.arrays"> @@ -20,28 +20,42 @@ you name the <input>, <select> or <textarea> elements like this: <programlisting> - <input name="MyArray[]"> - <input name="MyArray[]"> - <input name="MyArray[]"> - <input name="MyArray[]"> +<![CDATA[ +<input name="MyArray[]"> +<input name="MyArray[]"> +<input name="MyArray[]"> +<input name="MyArray[]"> +]]> </programlisting> Notice the square brackets after the variable name, that's what makes it an array. You can group the elements into different arrays by assigning the same name to different elements: <programlisting> - <input name="MyArray[]"> - <input name="MyArray[]"> - <input name="MyOtherArray[]"> - <input name="MyOtherArray[]"> +<![CDATA[ +<input name="MyArray[]"> +<input name="MyArray[]"> +<input name="MyOtherArray[]"> +<input name="MyOtherArray[]"> +]]> </programlisting> This produces two arrays, MyArray and MyOtherArray, that gets sent to the PHP script. </para> <para> - <emphasis>Note that you must not use indices with arrays in HTML!</emphasis> - The array gets filled in the order the elements appear in the form. For - functions you can use to process these arrays once you get them into - your scripts, please see the Arrays section in the manual. + <note> + <para> + You need not use indices with arrays in HTML, although you can + specify number or associative indices, so you can exactly specify + what indices will contain the information provided by that + input element. If you do not specify indices, the array gets + filled in the order the elements appear in the form. + </para> + </note> + </para> + <para> + For functions you can use to process these arrays once you get + them into your scripts, please see the + <link linkend="ref.array">Arrays section</link>. </para> </answer> </qandaentry>
Index: phpdoc/faqurls.ent diff -u phpdoc/faqurls.ent:1.14 phpdoc/faqurls.ent:1.15 --- phpdoc/faqurls.ent:1.14 Sun Oct 14 05:16:30 2001 +++ phpdoc/faqurls.ent Sun Oct 14 06:41:34 2001 @@ -1,6 +1,6 @@ <!-- -*- SGML -*- - $Id: faqurls.ent,v 1.14 2001/10/14 09:16:30 goba Exp $ + $Id: faqurls.ent,v 1.15 2001/10/14 10:41:34 goba Exp $ Contains "macros" for all the XML documents within the FAQ. @@ -43,6 +43,8 @@ <!ENTITY faqurl.php.bugs "http://bugs.php.net/"> <!ENTITY faqurl.php.download "http://www.php.net/downloads.php"> <!ENTITY faqurl.php.manual "http://www.php.net/manual/"> +<!ENTITY faqurl.php.news "news://news.php.net/"> +<!ENTITY faqurl.php.newsweb "http://news.php.net/"> <!ENTITY faqurl.php.support "http://www.php.net/support.php"> <!ENTITY faqurl.php.support.winbuild "http://www.php.net/extra/win32build.zip"> <!ENTITY faqurl.readline "ftp://prep.ai.mit.edu/pub/gnu/readline/"> Index: phpdoc/en/faq/common.xml diff -u phpdoc/en/faq/common.xml:1.6 phpdoc/en/faq/common.xml:1.7 --- phpdoc/en/faq/common.xml:1.6 Sun Sep 30 17:46:11 2001 +++ phpdoc/en/faq/common.xml Sun Oct 14 06:41:34 2001 @@ -1,13 +1,13 @@ <?xml encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <chapter id="faq.common"> <title>Common Problems</title> <titleabbrev>Common Problems</titleabbrev> - <para> - Here is a bunch of common problems, met every - day with PHP, and solved the easy way! - </para> + <para> + Here is a bunch of common problems, met every + day with PHP, and solved the easy way! + </para> <qandaset> <qandaentry id="faq.common.nodata"> @@ -27,59 +27,60 @@ to help the developers pinpoint the problem. If you are using PHP as an Apache module try something like: <itemizedlist> - <listitem> - <para> + <listitem> + <para> Stop your httpd processes - </para> - </listitem> - <listitem> - <para> + </para> + </listitem> + <listitem> + <para> gdb httpd - </para> - </listitem> - <listitem> - <para> + </para> + </listitem> + <listitem> + <para> Stop your httpd processes - </para> - </listitem> - <listitem> - <para> + </para> + </listitem> + <listitem> + <para> > run -X -f /path/to/httpd.conf - </para> - </listitem> - <listitem> - <para> + </para> + </listitem> + <listitem> + <para> Then fetch the URL causing the problem with your browser - </para> - </listitem> - <listitem> - <para> + </para> + </listitem> + <listitem> + <para> > run -X -f /path/to/httpd.conf - </para> - </listitem> - <listitem> - <para> + </para> + </listitem> + <listitem> + <para> If you are getting a core dump, gdb should inform you of this now - </para> - </listitem> - <listitem> - <para> + </para> + </listitem> + <listitem> + <para> type: bt - </para> - </listitem> - <listitem> - <para> + </para> + </listitem> + <listitem> + <para> You should include your backtrace in your bug report. This should be submitted to <ulink url="&faqurl.php.bugs;">&faqurl.php.bugs;</ulink> - </para> - </listitem> + </para> + </listitem> </itemizedlist> </para> <para> If your script uses the regular expression functions - (<function>ereg()</function> and friends), you should make sure + (<function>ereg</function> and friends), you should make sure that you compiled PHP and Apache with the same regular - expression package. (This should happen automatically with PHP and Apache 1.3.x) + expression package. This should happen automatically with + PHP and Apache 1.3.x </para> </answer> </qandaentry> @@ -94,10 +95,10 @@ </question> <answer> <para> - Environment variables are now normal global variables, so you must - either declare them as global variables in your function (by using - "<literal>global $DOCUMENT_ROOT;</literal>", for example) or by using - the global variable array (ie, "<literal>$GLOBALS["DOCUMENT_ROOT"]</literal>". + Environment variables are normal global variables, so you must + either declare them as global variables in your function (by using + "<literal>global $DOCUMENT_ROOT;</literal>", for example) or by using + the global variable array (ie, "<literal>$GLOBALS["DOCUMENT_ROOT"]</literal>". </para> </answer> </qandaentry> @@ -106,7 +107,7 @@ <question> <para> I patched Apache with the FrontPage extensions patch, and suddenly PHP stopped - working. Is PHP incompatible with the Apache FrontPage extensions? + working. Is PHP incompatible with the Apache FrontPage extensions? </para> </question> <answer> @@ -124,7 +125,7 @@ <question> <para> I think I found a bug! Who should I tell? - </para> + </para> </question> <answer> <para> Index: phpdoc/en/faq/html.xml diff -u phpdoc/en/faq/html.xml:1.4 phpdoc/en/faq/html.xml:1.5 --- phpdoc/en/faq/html.xml:1.4 Fri Sep 21 18:47:31 2001 +++ phpdoc/en/faq/html.xml Sun Oct 14 06:41:34 2001 @@ -1,13 +1,13 @@ <?xml encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <chapter id="faq.html"> <title>PHP and HTML</title> <titleabbrev>PHP and HTML</titleabbrev> - <para> - PHP and HTML interact a lot : PHP generate HTML, and HTML - has informations that will be sent to PHP. - </para> + <para> + PHP and HTML interact a lot : PHP generate HTML, and HTML + has informations that will be sent to PHP. + </para> <qandaset> <qandaentry id="faq.html.arrays"> @@ -20,28 +20,42 @@ you name the <input>, <select> or <textarea> elements like this: <programlisting> - <input name="MyArray[]"> - <input name="MyArray[]"> - <input name="MyArray[]"> - <input name="MyArray[]"> +<![CDATA[ +<input name="MyArray[]"> +<input name="MyArray[]"> +<input name="MyArray[]"> +<input name="MyArray[]"> +]]> </programlisting> Notice the square brackets after the variable name, that's what makes it an array. You can group the elements into different arrays by assigning the same name to different elements: <programlisting> - <input name="MyArray[]"> - <input name="MyArray[]"> - <input name="MyOtherArray[]"> - <input name="MyOtherArray[]"> +<![CDATA[ +<input name="MyArray[]"> +<input name="MyArray[]"> +<input name="MyOtherArray[]"> +<input name="MyOtherArray[]"> +]]> </programlisting> This produces two arrays, MyArray and MyOtherArray, that gets sent to the PHP script. </para> <para> - <emphasis>Note that you must not use indices with arrays in HTML!</emphasis> - The array gets filled in the order the elements appear in the form. For - functions you can use to process these arrays once you get them into - your scripts, please see the Arrays section in the manual. + <note> + <para> + You need not use indices with arrays in HTML, although you can + specify number or associative indices, so you can exactly specify + what indices will contain the information provided by that + input element. If you do not specify indices, the array gets + filled in the order the elements appear in the form. + </para> + </note> + </para> + <para> + For functions you can use to process these arrays once you get + them into your scripts, please see the + <link linkend="ref.array">Arrays section</link>. </para> </answer> </qandaentry>