svn: /phpdoc/bg/trunk/reference/strings/functions/ setlocale.xml

Modified: phpdoc/bg/trunk/reference/strings/functions/setlocale.xml
===================================================================
--- phpdoc/bg/trunk/reference/strings/functions/setlocale.xml	2016-03-16 22:51:12 UTC (rev 338755)
+++ phpdoc/bg/trunk/reference/strings/functions/setlocale.xml	2016-03-16 23:15:39 UTC (rev 338756)
@@ -1,12 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: stanprog Status: ready -->
-<refentry xml:id="function.setlocale" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<!-- EN-Revision: 336805 Maintainer: stanprog Status: ready -->
+<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.setlocale">
  <refnamediv>
   <refname>setlocale</refname>
   <refpurpose>Установява локал</refpurpose>
  </refnamediv>
-
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
@@ -16,7 +16,7 @@
    <methodparam choice="opt"><type>string</type><parameter>...</parameter></methodparam>
   </methodsynopsis>
   <methodsynopsis>
-  <type>string</type><methodname>setlocale</methodname>
+   <type>string</type><methodname>setlocale</methodname>
    <methodparam><type>int</type><parameter>category</parameter></methodparam>
    <methodparam><type>array</type><parameter>locale</parameter></methodparam>
   </methodsynopsis>
@@ -24,7 +24,7 @@
    Установява информация за локал.
   </para>
  </refsect1>
-
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -33,85 +33,94 @@
      <term><parameter>category</parameter></term>
      <listitem>
       <para>
-   <parameter>category</parameter> константа (или низ), който указва
-   категорията на засегнатите от локала функции:
-   <itemizedlist>
-    <listitem>
-     <simpara>
-      LC_ALL - всички функции
-     </simpara>
-    </listitem>
-    <listitem>
-     <simpara>
-      LC_COLLATE - функции за сравняване на низове, вж. <function>strcoll</function>
-     </simpara>
-    </listitem>
-    <listitem>
-     <simpara>
-      LC_CTYPE - функции за класифициране и преобразуване на низове, например <function>strtoupper</function>
-     </simpara>
-    </listitem>
-    <listitem>
-     <simpara>
-      LC_MONETARY - функция <function>localeconv</function>
-     </simpara>
-    </listitem>
-    <listitem>
-     <simpara>
-      LC_NUMERIC - задава знак за десетичния разделител (Вж. също
-      <function>localeconv</function>)
-     </simpara>
-    </listitem>
-    <listitem>
-     <simpara>
-      LC_TIME за дата и време форматирани посредством
-      <function>strftime</function>
-     </simpara>
-    </listitem>
-    <listitem>
-     <simpara>
-      LC_MESSAGES за системни съобщения (достъпно ако PHP е компилирано с
-      <literal>libintl</literal>)
-     </simpara>
-    </listitem>
-   </itemizedlist>
-  </para>
+       <parameter>category</parameter> константа (или низ), който указва
+       категорията на засегнатите от локала функции:
+       <itemizedlist>
+        <listitem>
+         <simpara>
+          <constant>LC_ALL</constant> за всички по-долу
+         </simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          <constant>LC_COLLATE</constant> за сравняване на низове, вж.
+          <function>strcoll</function>
+         </simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          <constant>LC_CTYPE</constant> за класифициране и преобразуване на низове,
+          например <function>strtoupper</function>
+         </simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          <constant>LC_MONETARY</constant> за <function>localeconv</function>
+         </simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          <constant>LC_NUMERIC</constant> за десетичния разделител (Вж. също
+          <function>localeconv</function>)
+         </simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          <constant>LC_TIME</constant> за дата и време форматирани посредством
+          <function>strftime</function>
+         </simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          <constant>LC_MESSAGES</constant> за системни съобщения (достъпно ако PHP е компилирано с
+          <literal>libintl</literal>)
+         </simpara>
+        </listitem>
+       </itemizedlist>
+      </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><parameter>locale</parameter></term>
      <listitem>
-  <para>
-   Ако параметърът <parameter>locale</parameter> има стойност &null;
-   или празен низ <literal>""</literal>, имената на локалите ще
-   бъдат установени на базата на променливите на обкръжението
-   със същите имена като по-горните категории или от "LANG".
-  </para>
-  <para>
-   Ако параметърът <parameter>locale</parameter> има стойност <literal>"0"</literal>,
-   локала няма да бъде засегнат, а ще се върне единствено текущия локал.
-  </para>
-  <para>
-   Ако параметърът <parameter>locale</parameter> е масив или след него има
-   други параметри, то с всеки елемент на масива или параметър ще се
-   направи опит да бъде установен като нов локал, докато тази операция успее.
-   Този подход е полезен в случаите, когато даден локал е познат под няколко
-   имена на различни системи или с цел подсигуряване за локал който
-   може и да не е наличен.
-  </para>
+      <para>
+       Ако параметърът <parameter>locale</parameter> има стойност &null; или празен низ
+       <literal>""</literal>, имената на локалите ще бъдат установени на базата на
+       променливите на обкръжението със същите имена като по-горните
+       категории или от "LANG".
+      </para>
+      <para>
+       Ако параметърът <parameter>locale</parameter> има стойност <literal>"0"</literal>,
+       локала няма да бъде засегнат, а ще се върне единствено текущия локал.
+      </para>
+      <para>
+       Ако параметърът <parameter>locale</parameter> е масив или след него има други
+       параметри, то с всеки елемент на масива или параметър ще се направи опит да бъде установен като
+       нов локал, докато тази операция успее. Този подход е полезен в случаите, когато даден локал е познат под
+       няколко имена на различни системи или с цел подсигуряване за локал който
+       може и да не е наличен.
+      </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><parameter>...</parameter></term>
      <listitem>
       <para>
+       (Незадължителни параметри във вид на низ или масив, за установяване на настройките на локала,
+       до първия успешен опит.)
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
+   <note>
+    <para>
+     Под Windows, setlocale(LC_ALL, '') установява имената на локала от системните
+     регионални/езикови настройки (достъпни чрез Панела за управление).
+    </para>
+   </note>
   </para>
  </refsect1>
-
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
@@ -120,21 +129,20 @@
    или името на категорията е невалидно.
   </para>
   <para>
-   Невалидно име на категория генерира предупреждение. Наименованията
-   на категориите и локалите могат да бъдат видяни в
-   <link xlink:href="&url.rfc;1766">RFC 1766</link> и
-   <link xlink:href="&url.iso-639;">ISO 639</link>.
+   Невалидно име на категория генерира предупреждение. Наименованията на категориите и локалите
+   могат да бъдат видени в <link xlink:href="&url.rfc;1766">RFC 1766</link>
+   и <link xlink:href="&url.iso-639;">ISO 639</link>.
    Различните системи разполагат с различни схеми за именуване на локалите.
   </para>
   <note>
    <para>
     Стойността, която връща функцията <function>setlocale</function>
     зависи от системата на която е стартиран PHP. Тя връща точно това,
-    което връща и системната функция за установяване на локал.
+    което връща и системната функция <literal>setlocale</literal> за установяване на локал.
    </para>
   </note>
  </refsect1>
-
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <para>
@@ -148,33 +156,26 @@
      </thead>
      <tbody>
       <row>
+       <entry>7.0.0</entry>
+       <entry>
+        Поддръжката на параметъра <parameter>category</parameter> подаден като низ е
+        премахната. Само константите <literal>LC_*</literal> могат да се използват от тази версия.
+       </entry>
+      </row>
+      <row>
        <entry>5.3.0</entry>
        <entry>
-        Функцията хвърля E_DEPRECATED съобщение, ако вместо някоя от
+        Функцията хвърля <constant>E_DEPRECATED</constant> съобщение, ако вместо някоя от
         <literal>LC_*</literal> константите, като параметър <parameter>category</parameter>
         е предаден низ.
        </entry>
       </row>
-      <row>
-       <entry>4.3.0</entry>
-       <entry>
-        Става възможно предаването на множество локали.
-       </entry>
-      </row>
-      <row>
-       <entry>4.2.0</entry>
-       <entry>
-        Предаването на низ за параметъра <parameter>category</parameter> е непрепоръчително,
-        като вместо него могат да се ползват константите по-горе. Предаването им като низ
-       (в кавички) ще предизвика съобщение от тип предупреждение.
-       </entry>
-      </row>
      </tbody>
     </tgroup>
    </informaltable>
   </para>
  </refsect1>
-
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -218,36 +219,33 @@
    </example>
   </para>
  </refsect1>
-
+
  <refsect1 role="notes">
   &reftitle.notes;
   <warning>
    <para>
-    Информацията за локала се поддържа на ниво процес, а не на ниво нишка.
-    Ако PHP работи на многонишков сървърен API, като IIS или Apache под
-    Windows, може да станете свидетели на неочаквани промени на локала
-    по време на изпълнение на скрипта, въпреки че, в самия скрипт
-    никога не е извикана функцията <function>setlocale</function>.
-    Това е така, тъй като други скриптове, стартирани в други
-    нишки на същия процес, в същото време са променили локала
-    на ниво процес, посредством <function>setlocale</function>.
+    Информацията за локала се поддържа на ниво процес, а не на ниво нишка.  Ако PHP работи
+    на многонишков сървърен API, като IIS, HHVM или Apache под
+    Windows, може да станете свидетели на неочаквани промени на локала по време на
+    изпълнение на скрипта, въпреки че, в самия скрипт никога не е извикана функцията
+    <function>setlocale</function>. Това е така, тъй като други скриптове,
+    стартирани в други нишки на същия процес, в същото време
+    са променили локала на ниво процес, посредством <function>setlocale</function>.
    </para>
   </warning>
   <tip>
    <para>
-    Потребителите на операционната система Windows могат да намерят
-    полезна информация относно низове на локали на сайта на <acronym>MSDN</acronym>.
-    Поддържаните низове за езици могат да бъдат видяни на
-    <link xlink:href="&url.setlocale.lang.win32;">&url.setlocale.lang.win32;</link>
+    Потребителите на операционната система Windows могат да намерят полезна информация относно
+    низове на <parameter>locale</parameter> на сайта на <acronym>MSDN</acronym>.
+    Поддържаните низове за езици могат да бъдат видени
+    на
+    <link xlink:href="&url.setlocale.lang.win32;">документацията за езиковите низове</link>
     а поддрържаните низове за страни и региони на
-    <link xlink:href="&url.setlocale.country.win32;">&url.setlocale.country.win32;</link>.
-    Windows системите поддржат трибуквени кодове за страни и региони дефинирани
-    в <literal>ISO 3166-Alpha-3</literal>, който стандарт може да бъде видян
-    на <link xlink:href="&url.iso-3166-3;">сайта на Unicode</link>.
+    <link xlink:href="&url.setlocale.country.win32;">документация за низовете за държава/регион</link>.
    </para>
   </tip>
  </refsect1>
-
+
 </refentry>

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