svn: /phpdoc/bg/trunk/ features/remote-files.xml reference/math/functions/floor.xml reference/math/functions/is-nan.xml reference/math/functions/log1p.xml reference/math/functions/mt-getrandmax.xml

Modified: phpdoc/bg/trunk/features/remote-files.xml
===================================================================
--- phpdoc/bg/trunk/features/remote-files.xml	2016-04-10 15:50:22 UTC (rev 338985)
+++ phpdoc/bg/trunk/features/remote-files.xml	2016-04-10 16:24:51 UTC (rev 338986)
@@ -1,67 +1,50 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: blum Status: ready -->
- <chapter xml:id="features.remote-files" xmlns="http://docbook.org/ns/docbook">
-  <title>Използване на отдалечени файлове</title>
-
-  <para>
-   Ако настройката <option>allow_url_fopen</option> от &php.ini; е включена,
-   можете да използвате <acronym>HTTP</acronym> и
-   <acronym>FTP</acronym> URL с повечето от функциите, които приемат
-   име на файл като параметър. Също така URL може да бъде използвано със
-   заявките <function>include</function>, <function>include_once</function>,
-   <function>require</function> и <function>require_once</function> (от
-   версия 5.2.0 нататък, опцията <option>allow_url_include</option> трябва да е
-   активна за да се използват последните). Вижте
-   <xref linkend="wrappers"/> за повече информация относно протоколите, които
-   поддържа PHP.
-  </para>
-  <note>
-   <para>
-    В PHP 4.0.3 и по-стари версии, за да използвате URL опаковка, беше
-    задължително да конфигурирате PHP с
-    опцията <option>--enable-url-fopen-wrapper</option>.
-   </para>
-  </note>
-  <para>
-   <note>
-    <para>
-     Версиите на PHP за Windows по-стари от 4.3 не поддържаха достъп до
-     отдалечен файл със следните функции: <function>include</function>,
-     <function>include_once</function>,<function>require</function>,
-     <function>require_once</function>, както и функциите на
-     imagecreatefromXXX от разширението <xref linkend="ref.image"/>.
-    </para>
-   </note>
-  </para>
-  <para>
-   Например, можете да използвате тази функционалност, за да отворите файл на
-   отдалечен уеб-сървър, да анализирате съдържанието му за данните, от които се
-   нуждаете и след това да ги вложите в заявка към база от данни, или просто да
-   ги визуализирате на страницата ви.
-  </para>
-  <para>
-   <example>
-    <title>Взимане на заглавие от отдалечена страница</title>
-    <programlisting role="php">
-     <![CDATA[
-     <?php
-     $file = fopen ("http://www.example.com/", "r");
-     if (!$file) {
-         echo "<p>Unable to open remote file.\n";
-         exit;
-     }
-     while (!feof ($file)) {
-        $line = fgets ($file, 1024);
-        /* Това работи само ако заглавието и неговите тагове са на един ред */
-        if (eregi ("<title>(.*)</title>", $line, $out)) {
-            $title = $out[1];
-            break;
-        }
-     }
-     fclose($file);
-     ?>
-     ]]>
+<!-- EN-Revision: 334726 Maintainer: stanprog Status: ready -->
+<!-- CREDITS: blum -->
+<chapter xml:id="features.remote-files" xmlns="http://docbook.org/ns/docbook">
+ <title>Използване на отдалечени файлове</title>
+
+ <para>
+  Ако настройката <option>allow_url_fopen</option> от &php.ini; е включена,
+  можете да използвате <acronym>HTTP</acronym> и <acronym>FTP</acronym>
+  URL-и с повечето от функциите,
+  които приемат име на файл като параметър. Също така URL може да бъде
+  използван с <function>include</function>,
+  <function>include_once</function>, <function>require</function> и
+  <function>require_once</function> (от версия 5.2.0 нататък,
+  опцията <option>allow_url_include</option> трябва да е активна за да се използват последните).
+  Вижте <xref linkend="wrappers"/> за повече информация относно протоколите, които
+  поддържа PHP.
+ </para>
+ <para>
+  Например, можете да използвате тази функционалност, за да отворите файл на
+  отдалечен уеб-сървър, да анализирате съдържанието му за данните, от които се
+  нуждаете и след това да ги вложите в заявка към база от данни, или просто да
+  ги визуализирате на страницата ви.
+ </para>
+ <para>
+  <example>
+   <title>Взимане на заглавие от отдалечена страница</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$file = fopen ("http://www.example.com/", "r");
+if (!$file) {
+    echo "<p>Unable to open remote file.\n";
+    exit;
+}
+while (!feof ($file)) {
+    $line = fgets ($file, 1024);
+    /* Това работи само ако заглавието и неговите тагове са на един ред */
+    if (preg_match ("@\<title\>(.*)\</title\>@i", $line, $out)) {
+        $title = $out[1];
+        break;
+    }
+}
+fclose($file);
+?>
+]]>
     </programlisting>
    </example>
   </para>
@@ -75,26 +58,26 @@
   <para>
    За да се свържете като потребител, различен от 'anonymous', трябва
    да упоменете потребителско име (и вероятно парола) вътре в URL адреса, например
-   'ftp://user:[email protected]/path/to/file'.(Използвайте същия
-   синтаксис, за да осъществите достъп до файлове през HTTP, когато се изисква
+   '<literal>ftp://user:[email protected]/path/to/file</literal>'.(Използвайте същия
+   синтаксис, за да осъществите достъп до файлове през <acronym>HTTP</acronym>, когато се изисква
    основна идентификация.)
   </para>
   <para>
    <example>
     <title>Записване на данни на отдалечен сървър</title>
     <programlisting role="php">
-     <![CDATA[
-     <?php
-     $file = fopen ("ftp://ftp.example.com/incoming/outputfile", "w");
-     if (!$file) {
-         echo "<p>Unable to open remote file for writing.\n";
-         exit;
-     }
-     /* Записваме данните тук. */
-     fwrite ($file, $_SERVER['HTTP_USER_AGENT'] . "\n");
-     fclose ($file);
-     ?>
-     ]]>
+<![CDATA[
+<?php
+$file = fopen ("ftp://ftp.example.com/incoming/outputfile", "w");
+if (!$file) {
+    echo "<p>Unable to open remote file for writing.\n";
+    exit;
+}
+/* Записваме данните тук. */
+fwrite ($file, $_SERVER['HTTP_USER_AGENT'] . "\n");
+fclose ($file);
+?>
+]]>
     </programlisting>
    </example>
   </para>
@@ -109,7 +92,7 @@
     </para>
    </note>
   </para>
-
+
  </chapter>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/bg/trunk/reference/math/functions/floor.xml
===================================================================
--- phpdoc/bg/trunk/reference/math/functions/floor.xml	2016-04-10 15:50:22 UTC (rev 338985)
+++ phpdoc/bg/trunk/reference/math/functions/floor.xml	2016-04-10 16:24:51 UTC (rev 338986)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: blum Status: ready -->
+<!-- EN-Revision: 337718 Maintainer: stanprog Status: ready -->
+<!-- CREDITS: blum -->
 <refentry xml:id="function.floor" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>floor</refname>
@@ -8,12 +9,12 @@
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
-   <methodsynopsis>
-    <type>float</type><methodname>floor</methodname>
-    <methodparam><type>float</type><parameter>value</parameter></methodparam>
-   </methodsynopsis>
+  <methodsynopsis>
+   <type>mixed</type><methodname>floor</methodname>
+   <methodparam><type>float</type><parameter>value</parameter></methodparam>
+  </methodsynopsis>
   <simpara>
-   Връща следващата по-малка целочислена стойност чрез закръглане на
+   Връща следващата по-малка целочислена стойност (като число с плаваща запетая) чрез закръгляне на
    <parameter>value</parameter>, ако е необходимо.
   </simpara>
  </refsect1>
@@ -25,7 +26,7 @@
      <term><parameter>number</parameter></term>
      <listitem>
       <para>
-       Числена стойност, която ще се закръгля
+       Числената стойност, която ще се закръгля
       </para>
      </listitem>
     </varlistentry>
@@ -35,11 +36,10 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Стойността на параметъра <parameter>value</parameter> закръглена до
-   по-малкото цяло число. Върнатата стойност на функцията
-   <function>floor</function> е пак число с плаваща запетая, тъй като
-   диапазона на числата с плаваща запетая обикновено е по-голям от този на
-   целочислените числа.
+   Стойността на параметъра <parameter>value</parameter> закръглена до по-малкото цяло число.
+   Върнатата стойност на функцията <function>floor</function> е пак
+   число с плаваща запетая, тъй като диапазона на числата с плаваща запетая
+   обикновено е по-голям от този на целочислените числа. Функцията връща FALSE при възникване на грешка (напр. предаване на масив).
   </para>
  </refsect1>
  <refsect1 role="examples">

Modified: phpdoc/bg/trunk/reference/math/functions/is-nan.xml
===================================================================
--- phpdoc/bg/trunk/reference/math/functions/is-nan.xml	2016-04-10 15:50:22 UTC (rev 338985)
+++ phpdoc/bg/trunk/reference/math/functions/is-nan.xml	2016-04-10 16:24:51 UTC (rev 338986)
@@ -1,11 +1,13 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: blum Status: ready -->
+<!-- EN-Revision: 297028 Maintainer: stanprog Status: ready -->
+<!-- CREDITS: blum -->
 <refentry xml:id='function.is-nan' xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>is_nan</refname>
   <refpurpose>Проверява дали зададеният параметър е не-число</refpurpose>
  </refnamediv>
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
@@ -17,6 +19,7 @@
    като например резултата от <literal>acos(1.01)</literal>.
   </para>
  </refsect1>
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -32,6 +35,7 @@
    </variablelist>
   </para>
  </refsect1>
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
@@ -39,6 +43,34 @@
    в противен случай връща &false;.
   </para>
  </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+ <para>
+  <example>
+   <title>Пример за <function>is_nan</function></title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+// Невалидна калкулация, връща
+// стойност NaN
+$nan = acos(8);
+
+var_dump($nan, is_nan($nan));
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+float(NAN)
+bool(true)
+]]>
+    </screen>
+   </example>
+ </para>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -48,6 +80,7 @@
    </simplelist>
   </para>
  </refsect1>
+
 </refentry>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/bg/trunk/reference/math/functions/log1p.xml
===================================================================
--- phpdoc/bg/trunk/reference/math/functions/log1p.xml	2016-04-10 15:50:22 UTC (rev 338985)
+++ phpdoc/bg/trunk/reference/math/functions/log1p.xml	2016-04-10 16:24:51 UTC (rev 338986)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: blum Status: ready -->
+<!-- EN-Revision: 297028 Maintainer: stanprog Status: ready -->
+<!-- CREDITS: blum -->
 <refentry xml:id='function.log1p' xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>log1p</refname>
@@ -15,7 +16,6 @@
    <type>float</type><methodname>log1p</methodname>
    <methodparam><type>float</type><parameter>number</parameter></methodparam>
   </methodsynopsis>
-  &warn.experimental.func;
   <para>
    Функцията <function>log1p</function> връща log(1 +
    <parameter>number</parameter>), изчислено по начин, който е точен дори и
@@ -23,7 +23,6 @@
    Функцията <function>log</function> в този случай би върнала само log(1)
    поради липса на точност.
   </para>
-  &note.no-windows;
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
@@ -46,6 +45,29 @@
    log(1 + <parameter>number</parameter>)
   </para>
  </refsect1>
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>5.3.0</entry>
+       <entry>
+        Сега функцията е налична на всички платформи
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+ </para>
+ </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>

Modified: phpdoc/bg/trunk/reference/math/functions/mt-getrandmax.xml
===================================================================
--- phpdoc/bg/trunk/reference/math/functions/mt-getrandmax.xml	2016-04-10 15:50:22 UTC (rev 338985)
+++ phpdoc/bg/trunk/reference/math/functions/mt-getrandmax.xml	2016-04-10 16:24:51 UTC (rev 338986)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: blum Status: ready -->
+<!-- EN-Revision: 336046 Maintainer: blum Status: ready -->
 <refentry xml:id="function.mt-getrandmax" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mt_getrandmax</refname>
@@ -20,10 +20,38 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Връща най-голямата случайна стойност, която
-   функцията <function>mt_rand</function> може да генерира.
+   Връща най-голямата случайна стойност, която може да върне
+   функция <function>mt_rand</function> при извикване без аргументи, която е максималната стойност
+   която може да бъде използвана за параметъра <parameter>max</parameter> без
+   резултата да се закръгля (и съответно да бъде по-малко случаен).
   </para>
  </refsect1>
+<refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example><title>Изчисляване на случйно число с плаваща запетая</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+function randomFloat($min = 0, $max = 1) {
+    return $min + mt_rand() / mt_getrandmax() * ($max - $min);
+}
+
+var_dump(randomFloat());
+var_dump(randomFloat(2, 20));
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <screen>
+<![CDATA[
+float(0.91601131712832)
+float(16.511210331931)
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>