svn: /phpdoc/ en/trunk/install/windows/index.xml en/trunk/language/basic-syntax.xml en/trunk/language/control-structures/continue.xml sr/trunk/install/windows/index.xml sr/trunk/language/basic-syntax.xml sr/trunk/language/control-structures/alternative-syntax.xml sr/trunk/language/control-structures/continue.xml sr/trunk/language/control-structures/include-once.xml sr/trunk/language/control-structures/require-once.xml sr/trunk/language/control-structures/require.xml

[email protected] (Nikola Smolenski) Mon, 02 May 2011 04:36:29 +0000
Newsgroups php.doc.cvs,php.doc.sr
Message-ID <[email protected]>
nikola                                   Mon, 02 May 2011 04:36:29 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=310698

Log:
en/language/control-structures/continue.xml: a few smaller fixes, reword
misleading claim about behaviour of print()

en/language/basic-syntax.xml: minor fix

en/install/windows/index.xml: rm duplication, dilute "advertisement" for
Visual Studio.

New sr translations.

Changed paths:
    U   phpdoc/en/trunk/install/windows/index.xml
    U   phpdoc/en/trunk/language/basic-syntax.xml
    U   phpdoc/en/trunk/language/control-structures/continue.xml
    U   phpdoc/sr/trunk/install/windows/index.xml
    U   phpdoc/sr/trunk/language/basic-syntax.xml
    A   phpdoc/sr/trunk/language/control-structures/alternative-syntax.xml
    A   phpdoc/sr/trunk/language/control-structures/continue.xml
    A   phpdoc/sr/trunk/language/control-structures/include-once.xml
    A   phpdoc/sr/trunk/language/control-structures/require-once.xml
    A   phpdoc/sr/trunk/language/control-structures/require.xml
svn-diffs-310698.txt (text/x-diff, 19.7 KB)
Modified: phpdoc/en/trunk/install/windows/index.xml
===================================================================
--- phpdoc/en/trunk/install/windows/index.xml	2011-05-01 22:32:01 UTC (rev 310697)
+++ phpdoc/en/trunk/install/windows/index.xml	2011-05-02 04:36:29 UTC (rev 310698)
@@ -5,8 +5,7 @@
    <para>
     This section applies to Windows 98/Me and Windows NT/2000/XP/2003. PHP
     will not work on 16 bit platforms such as Windows 3.1 and sometimes
-    we refer to the supported Windows platforms as Win32. Windows 95
-    is no longer supported as of PHP 4.3.0.
+    we refer to the supported Windows platforms as Win32.
    </para>
    <note>
     <para>
@@ -24,7 +23,7 @@
     or by using the <link linkend="install.windows.installer">installer</link>.
    </para>
    <para>
-    If you have Microsoft Visual Studio, you can also
+    If you have a development environment such as Microsoft Visual Studio, you can also
     <link linkend="install.windows.building">build</link>
     PHP from the original source code.
    </para>

Modified: phpdoc/en/trunk/language/basic-syntax.xml
===================================================================
--- phpdoc/en/trunk/language/basic-syntax.xml	2011-05-01 22:32:01 UTC (rev 310697)
+++ phpdoc/en/trunk/language/basic-syntax.xml	2011-05-02 04:36:29 UTC (rev 310698)
@@ -197,7 +197,7 @@
     <informalexample>
      <programlisting role="php">
 <![CDATA[
-<h1>This is an <?php # echo 'simple';?> example.</h1>
+<h1>This is an <?php # echo 'simple';?> example</h1>
 <p>The header above will say 'This is an  example'.</p>
 ]]>
      </programlisting>

Modified: phpdoc/en/trunk/language/control-structures/continue.xml
===================================================================
--- phpdoc/en/trunk/language/control-structures/continue.xml	2011-05-01 22:32:01 UTC (rev 310697)
+++ phpdoc/en/trunk/language/control-structures/continue.xml	2011-05-02 04:36:29 UTC (rev 310698)
@@ -43,7 +43,7 @@
 while ($i++ < 5) {
     echo "Outer<br />\n";
     while (1) {
-        echo "&nbsp;&nbsp;Middle<br />\n";
+        echo "&nbsp;Middle<br />\n";
         while (1) {
             echo "&nbsp;&nbsp;Inner<br />\n";
             continue 3;
@@ -75,7 +75,7 @@
 ]]>
     </programlisting>
     <para>
-     One can expect the result to be :
+     One can expect the result to be:
     </para>
     <screen>
 <![CDATA[
@@ -86,7 +86,7 @@
 ]]>
     </screen>
     <para>
-     but this script will output :
+     but this script will output:
     </para>
     <screen>
 <![CDATA[
@@ -94,9 +94,11 @@
 ]]>
     </screen>
     <para>
-     because the return value of the <function>print</function>
-     call is <literal>int(1)</literal>, and it will look like the
-     optional numeric argument mentioned above.
+     because the entire <literal>continue print "$i\n";</literal> is evaluated
+     as a single expression, and so <function>print</function> is called only
+     when <literal>$i == 2</literal> is true. (The return value of
+     <literal>print</literal> is passed to <literal>continue</literal> as the
+     numeric argument.)
     </para>
    </informalexample>
   </para>

Modified: phpdoc/sr/trunk/install/windows/index.xml
===================================================================
--- phpdoc/sr/trunk/install/windows/index.xml	2011-05-01 22:32:01 UTC (rev 310697)
+++ phpdoc/sr/trunk/install/windows/index.xml	2011-05-02 04:36:29 UTC (rev 310698)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 309893 Maintainer: nikola Status: ready -->
+<!-- EN-Revision: 310698 Maintainer: nikola Status: ready -->
   <chapter xml:id="install.windows" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
    <title>Инсталирање на Виндовс системима</title>
    <para>

Modified: phpdoc/sr/trunk/language/basic-syntax.xml
===================================================================
--- phpdoc/sr/trunk/language/basic-syntax.xml	2011-05-01 22:32:01 UTC (rev 310697)
+++ phpdoc/sr/trunk/language/basic-syntax.xml	2011-05-02 04:36:29 UTC (rev 310698)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297962 Maintainer: nikola Status: ready -->
+<!-- EN-Revision: 310698 Maintainer: nikola Status: ready -->

  <chapter xml:id="language.basic-syntax" xmlns="http://docbook.org/ns/docbook">
   <title>Основна синтакса</title>

Added: phpdoc/sr/trunk/language/control-structures/alternative-syntax.xml
===================================================================
--- phpdoc/sr/trunk/language/control-structures/alternative-syntax.xml	                        (rev 0)
+++ phpdoc/sr/trunk/language/control-structures/alternative-syntax.xml	2011-05-02 04:36:29 UTC (rev 310698)
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 291258 Maintainer: nikola Status: ready -->
+
+<sect1 xml:id="control-structures.alternative-syntax"  xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>Друга синтакса за контролне структуре</title>
+ <para>
+  ПХП нуди и другу синтаксу за неке од његових контролних
+  структура; наиме, <literal>if</literal>,
+  <literal>while</literal>, <literal>for</literal>,
+  <literal>foreach</literal>, и <literal>switch</literal>.
+  У сваком случају, основни облик друге синтаксе је да се отворена велика заграда промени
+  у двотачку (:) а затворена велика заграда у
+  <literal>endif;</literal>, <literal>endwhile;</literal>,
+  <literal>endfor;</literal>, <literal>endforeach;</literal>, или
+  <literal>endswitch;</literal>, тим редом.
+  <informalexample>
+   <programlisting role="php">
+<![CDATA[
+<?php if ($a == 5): ?>
+А је једнако 5
+<?php endif; ?>
+]]>
+   </programlisting>
+  </informalexample>
+ </para>
+ <simpara>
+  У горњем примеру, ХТМЛ блок „А је једнако 5“ је угнежђен унутар
+  <literal>if</literal> исказа написаног у другој синтакси.
+  ХТМЛ блок ће бити приказан само ако је <varname>$a</varname> једнако 5.
+ </simpara>
+ <para>
+  Ова друга синтакса се примењује и на <literal>else</literal> и
+  <literal>elseif</literal>. Следи
+  <literal>if</literal> конструкција са <literal>elseif</literal> и
+  <literal>else</literal> у другој синтакси:
+  <informalexample>
+   <programlisting role="php">
+<![CDATA[
+<?php
+if ($a == 5):
+    echo "a је једнако 5";
+    echo "...";
+elseif ($a == 6):
+    echo "a је једнако 6";
+    echo "!!!";
+else:
+    echo "a нити је 5 нити 6";
+endif;
+?>
+]]>
+   </programlisting>
+  </informalexample>
+ </para>
+ <note>
+  <para>
+   Мешање синтакси у истом контролном блоку није подржано.
+  </para>
+ </note>
+ <para>
+  Видите <link linkend="control-structures.while">while</link>,
+  <link linkend="control-structures.for">for</link>, и <link
+  linkend="control-structures.if">if</link> за још примера.
+ </para>
+</sect1>
+
+<!-- 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:"~/.phpdoc/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
+-->


Property changes on: phpdoc/sr/trunk/language/control-structures/alternative-syntax.xml
___________________________________________________________________
Added: svn:keywords
   + Revision

Added: phpdoc/sr/trunk/language/control-structures/continue.xml
===================================================================
--- phpdoc/sr/trunk/language/control-structures/continue.xml	                        (rev 0)
+++ phpdoc/sr/trunk/language/control-structures/continue.xml	2011-05-02 04:36:29 UTC (rev 310698)
@@ -0,0 +1,127 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 310698 Maintainer: nikola Status: ready -->
+
+<sect1 xml:id="control-structures.continue" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title><literal>continue</literal></title>
+ <simpara>
+  <literal>continue</literal> (срп. настави) се користи унутар петљи да
+  прескочи остатак тренутног понављања петље и настави извршавање
+  код вредновања услова и затим почетка следећег понављања.
+ </simpara>
+ <note>
+  <simpara>
+   Обратите пажњу да се у ПХП-у
+   исказ <link linkend="control-structures.switch">switch</link>
+   посматра као петља што се тиче коришћења
+   <literal>continue</literal>-а.
+  </simpara>
+ </note>
+ <simpara>
+  <literal>continue</literal> прихвата необавезни бројчани аргумент
+  који му говори из колико међусобно угнежђених петљи треба да
+  изађе.
+ </simpara>
+ <note>
+  <para>
+   <literal>continue 0;</literal> и <literal>continue 1;</literal> су исто
+   што и <literal>continue;</literal>.
+  </para>
+ </note>
+ <para>
+  <informalexample>
+   <programlisting role="php">
+<![CDATA[
+<?php
+while (list($key, $value) = each($arr)) {
+    if (!($key % 2)) { // прескочи непарне чланове
+        continue;
+    }
+    uradi_nesto_neparno($value);
+}
+
+$i = 0;
+while ($i++ < 5) {
+    echo "Спољашња<br />\n";
+    while (1) {
+        echo "&nbsp;Средња<br />\n";
+        while (1) {
+            echo "&nbsp;&nbsp;Унутрашња<br />\n";
+            continue 3;
+        }
+        echo "Ово се никад не исписује.<br />\n";
+    }
+    echo "А ни ово.<br />\n";
+}
+?>
+]]>
+   </programlisting>
+   </informalexample>
+  </para>
+  <para>
+   Изостављање тачка-зареза после <literal>continue</literal> може бити
+   збуњујуће. Ево примера шта не треба радити.
+  </para>
+  <para>
+   <informalexample>
+    <programlisting role="php">
+<![CDATA[
+<?php
+for ($i = 0; $i < 5; ++$i) {
+    if ($i == 2)
+        continue
+    print "$i\n";
+}
+?>
+]]>
+    </programlisting>
+    <para>
+     Могло би се очекивати да ће резултат бити:
+    </para>
+    <screen>
+<![CDATA[
+0
+1
+3
+4
+]]>
+    </screen>
+    <para>
+     али ће ова скрипта ипак исписати:
+    </para>
+    <screen>
+<![CDATA[
+2
+]]>
+    </screen>
+    <para>
+     јер се <literal>continue print "$i\n";</literal> вреднује
+     као један израз, тако да се <function>print</function> позива само
+     кад је <literal>$i == 2</literal> тачно. (Повратна вредност
+     <literal>print</literal> се прослеђује као бројчани аргумент
+     <literal>continue</literal>-у.)
+    </para>
+   </informalexample>
+  </para>
+</sect1>
+
+<!-- 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:"~/.phpdoc/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
+-->


Property changes on: phpdoc/sr/trunk/language/control-structures/continue.xml
___________________________________________________________________
Added: svn:keywords
   + Revision

Added: phpdoc/sr/trunk/language/control-structures/include-once.xml
===================================================================
--- phpdoc/sr/trunk/language/control-structures/include-once.xml	                        (rev 0)
+++ phpdoc/sr/trunk/language/control-structures/include-once.xml	2011-05-02 04:36:29 UTC (rev 310698)
@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 288721 Maintainer: nikola Status: ready -->
+
+<sect1 xml:id="function.include-once" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title><function>include_once</function></title>
+ <para>
+  Исказ <function>include_once</function> (срп. укључи једном) укључује и извреднује
+  наведени фајл током извршења скрипте.
+  Ово понашање је слично <function>include</function> исказу,
+  са једином разликом да ако је ко̂д из фајла већ
+  био укључен, неће бити опет укључен. Као што име каже,
+  биће укључен само једном.
+ </para>
+ <para>
+  <function>include_once</function> се може користити у случајевима у којима
+  би исти фајл могао бити укључен и извреднован више од једном током
+  одређеног извршења скрипте, па у том случају може помоћи да се избегну
+  проблеми као што су поновна дефиниција функција, поновна додела вредности променљивима, итд.
+ </para>
+ <para>
+  Видите документацију о <function>include</function>-у за информације о томе
+  како ова функција ради.
+ </para>
+ <para>
+  <note>
+  <para>
+   У ПХП-у 4, <literal>_once</literal> понашање се разликује у
+   оперативним системима који не разликују велика и мала слова у именима фајлова (као што је Виндовс), тако да је на пример:
+   <example>
+    <title><function>include_once</function> са ОС-ом који не разликује велика и мала слова у ПХП-у 4</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+include_once "a.php"; // ово ће укључити a.php
+include_once "A.php"; // ово ће укључити a.php опет! (само у ПХП-у 4)
+?>
+]]>
+     </programlisting>
+    </example>
+   </para>
+   <para>
+    Ово понашање се променило у ПХП-у 5, тако да се на пример у Виндовсу путања прво нормализује тако да
+    постане јасно да је <filename>C:\PROGRA~1\A.php</filename> исто што и
+    <filename>C:\Program Files\a.php</filename> и фајл ће бити укључен само једном.
+   </para>
+  </note>
+ </para>
+</sect1>
+
+<!-- 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:"~/.phpdoc/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
+-->


Property changes on: phpdoc/sr/trunk/language/control-structures/include-once.xml
___________________________________________________________________
Added: svn:keywords
   + Revision

Added: phpdoc/sr/trunk/language/control-structures/require-once.xml
===================================================================
--- phpdoc/sr/trunk/language/control-structures/require-once.xml	                        (rev 0)
+++ phpdoc/sr/trunk/language/control-structures/require-once.xml	2011-05-02 04:36:29 UTC (rev 310698)
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 288721 Maintainer: nikola Status: ready -->
+
+<sect1 xml:id="function.require-once" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title><function>require_once</function></title>
+ <para>
+  Исказ <function>require_once</function> (срп. захтевај једном) ради потпуно исто као
+  <function>require</function> осим што ће ПХП проверити да ли је фајл
+  већ био укључен, и ако јесте, неће га укључити (захтевати) поново.
+ </para>
+ <para>
+  Видите документацију о <function>include_once</function>-у за информације
+  о <literal>_once</literal> понашању, и како се оно разликује од
+  не-<literal>_once</literal> сродника.
+ </para>
+
+</sect1>
+
+<!-- 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:"~/.phpdoc/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
+-->


Property changes on: phpdoc/sr/trunk/language/control-structures/require-once.xml
___________________________________________________________________
Added: svn:keywords
   + Revision

Added: phpdoc/sr/trunk/language/control-structures/require.xml
===================================================================
--- phpdoc/sr/trunk/language/control-structures/require.xml	                        (rev 0)
+++ phpdoc/sr/trunk/language/control-structures/require.xml	2011-05-02 04:36:29 UTC (rev 310698)
@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 301574 Maintainer: nikola Status: ready -->
+
+<sect1 xml:id="function.require" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title><function>require</function></title>
+
+ <para>
+  <function>require</function> (срп. захтевај) је идентична са <function>include</function>
+  осим што ће у случају неуспеха направити и фаталну грешку <constant>E_COMPILE_ERROR</constant>
+  нивоа. Другим речима, зауставиће извршавање скрипте док
+  <function>include</function> само избацује упозорење
+  (<constant>E_WARNING</constant>) што дозвољава скрипти да настави.
+ </para>
+ <para>
+  Видите документацију о <function>include</function>-у за више информација о томе како ово ради.
+ </para>
+
+</sect1>
+
+<!-- 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:"~/.phpdoc/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
+-->


Property changes on: phpdoc/sr/trunk/language/control-structures/require.xml
___________________________________________________________________
Added: svn:keywords
   + Revision