svn: /phpdoc/ru/trunk/reference/com/ book.xml com.xml dotnet.xml error-handling.xml examples.xml ini.xml reference.xml setup.xml variant.xml

[email protected] (Sergey Panteleev)
Newsgroups php.doc.ru
Message-ID <[email protected]>
sergey                                   Tue, 01 Oct 2019 13:09:32 +0000

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

Log:
docs(ru): Review

Changed paths:
    U   phpdoc/ru/trunk/reference/com/book.xml
    U   phpdoc/ru/trunk/reference/com/com.xml
    U   phpdoc/ru/trunk/reference/com/dotnet.xml
    U   phpdoc/ru/trunk/reference/com/error-handling.xml
    U   phpdoc/ru/trunk/reference/com/examples.xml
    U   phpdoc/ru/trunk/reference/com/ini.xml
    U   phpdoc/ru/trunk/reference/com/reference.xml
    U   phpdoc/ru/trunk/reference/com/setup.xml
    U   phpdoc/ru/trunk/reference/com/variant.xml
svn-diffs-348114.txt (text/x-diff, 19.8 KB)
Modified: phpdoc/ru/trunk/reference/com/book.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/book.xml	2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/book.xml	2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 347691 Maintainer: mch Status: ready-->
 <!-- $Revision$ -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->

 <book xml:id="book.com" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="bundled" ?>
@@ -26,13 +26,13 @@
    Подмножество COM, известное как OLE Automation, включает набор
    COM-интерфейсов, которые позволяют осуществлять легкое связывание COM-объектов, также любой
    объект можно проанализировать и вызывать во время работы без знания о деталях его работы
-   на этапе компиляции. PHP-расширение COM использует интерфейсы OLE Automation,
+   на этапе компиляции. PHP-модуль COM использует интерфейсы OLE Automation,
    позволяющие вам создавать и вызывать совместимые объекты из ваших скриптов.
-   Говоря техническим языком, это следовало бы назвать "<literal>Расширение OLE Automation для PHP</literal>",
+   Говоря техническим языком, это следовало бы назвать "<literal>Модуль OLE Automation для PHP</literal>",
    так как не все COM-объекты являются OLE-совместимыми.
   </para>
   <para>
-   Теперь, почему вам следует использовать COM ? COM — один из основных способов
+   Теперь, почему вам следует использовать COM? COM — один из основных способов
    склеить вместе приложения и компоненты на платформе Windows. Используя
    COM, вы можете запустить Microsoft Word, заполнить шаблон документа и сохранить
    результаты как документ Word, и затем отправить посетителю вашего веб-сайта. Вы также можете
@@ -40,7 +40,7 @@
    вашего IIS-сервера. Это только обычные применения, с COM вы сможете больше.
   </para>
   <para>
-   Дополнительно расширение поддерживает создание экземпляра
+   Дополнительно модуль поддерживает создание экземпляра
    класса и создание .NET-сборок, используя слой взаимодействия с COM,
    предоставляемый Miсrosoft.
   </para>

Modified: phpdoc/ru/trunk/reference/com/com.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/com.xml	2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/com.xml	2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 347690 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <!-- splitted from ./en/functions/com.xml, last change in rev 1.12 -->
 <phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.com" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
@@ -52,7 +52,7 @@
    <title>Перегруженные методы</title>
    <para>
     Возвращаемые объекты являются перегруженными, то есть PHP
-    не видит каких либо фиксированных методов, как это происходит
+    не видит каких-либо фиксированных методов, как это происходит
     с обычными классами. Вместо этого свойства и доступ к методам
     передается через COM.
    </para>
@@ -60,13 +60,13 @@
     PHP автоматически определяет методы, которые
     обращаются к свойствам по ссылкам и автоматически преобразуют
     стандартные переменные PHP в вид, который можно передавать по ссылке.
-    Это означает, что вы можете вызывать методы не внося каких либо
+    Это означает, что вы можете вызывать методы не внося каких-либо
     дополнений в свой код.
    </para>
   </section>

   <section xml:id="class.com.examples">
-   <title>Примеры COM</title>
+   <title>Примеры использования COM</title>
    <para>
     <example xml:id="example.com1">
      <title>Первый пример</title>
@@ -74,8 +74,8 @@
 <![CDATA[
 <?php
 // запускаем word
-$word = new COM("word.application") or die("Unable to instantiate Word");
-echo "Loaded Word, version {$word->Version}\n";
+$word = new COM("word.application") or die("Невозможно создать экземпляр Word");
+echo "Загружен Word, версия {$word->Version}\n";

 //делаем его активным окном
 $word->Visible = 1;
@@ -84,8 +84,8 @@
 $word->Documents->Add();

 //Что то с ним делаем
-$word->Selection->TypeText("This is a test...");
-$word->Documents[1]->SaveAs("Useless test.doc");
+$word->Selection->TypeText("Это проверка...");
+$word->Documents[1]->SaveAs("Бесполезный тест.doc");

 //закрываем word
 $word->Quit();

Modified: phpdoc/ru/trunk/reference/com/dotnet.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/dotnet.xml	2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/dotnet.xml	2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 347690 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.dotnet" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <titleabbrev>DOTNET</titleabbrev>
@@ -57,7 +57,7 @@
    <title>Перегруженные методы</title>
    <para>
     Возвращаемый объект является перегруженным, то есть PHP
-    не видит каких либо фиксированных методов, как это происходит
+    не видит каких-либо фиксированных методов, как это происходит
     с обычными классами; вместо этого свойства и доступ к методам
     передается через COM, а оттуда в
     DOTNET. Другими словами, объект .Net отображается через уровень взаимодействия COM,
@@ -79,7 +79,7 @@
 <?php
 $stack = new DOTNET("mscorlib", "System.Collections.Stack");
 $stack->Push(".Net");
-$stack->Push("Hello ");
+$stack->Push("Привет ");
 echo $stack->Pop() . $stack->Pop();
 ?>
 ]]>

Modified: phpdoc/ru/trunk/reference/com/error-handling.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/error-handling.xml	2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/error-handling.xml	2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,14 +1,14 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 347691 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <chapter xml:id="com.error-handling" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Ошибки и их обработка</title>

  <para>
-  Это расширение вызывает исключения класса <classname>com_exception</classname>
+  Модуль выбрасывает исключения класса <classname>com_exception</classname>
   в случае потенциальной фатальной ошибки возвращенной COM.
-  Исключения COM имеют четко определенное свойство<literal>code</literal>,
+  Исключения COM имеют четко определенное свойство <literal>code</literal>,
   соответствующее возвращенному из различных операций COM значению HRESULT.
   На основании этого кода вы можете построить логику обработки данных ошибок.
  </para>

Modified: phpdoc/ru/trunk/reference/com/examples.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/examples.xml	2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/examples.xml	2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 347687 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <chapter xml:id="com.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.examples;
@@ -9,7 +9,7 @@
   <title>For Each</title>
   <para>
    Вы можете использовать конструкцию &foreach; для итерации
-   контента стандартного COM/OLE IEnumVariant.  Другими словами,
+   контента стандартного COM/OLE IEnumVariant. Другими словами,
    это означает, что вы можете использовать foreach там, где вы использовали
    <literal>For Each</literal> в коде VB/ASP.
   </para>
@@ -56,7 +56,7 @@
    <itemizedlist>
     <listitem>
      <para>
-      Доступ к многомерным массивам или свойствам COM используя
+      Доступ к многомерным массивам или свойствам COM, используя
       синтаксис доступа к массивам. Также вы можете записывать и
       создавать свойства таким же образом.
      </para>
@@ -63,7 +63,7 @@
     </listitem>
     <listitem>
      <para>
-      Итерация SafeArray ("настоящие" массивы) используя &foreach;.
+      Итерация SafeArray ("настоящие" массивы), используя &foreach;.
       Это работает, поскольку SafeArrays включает в себя информацию о своем размере.
       Если свойство реализует IEnumVariant, то вы также можете использовать
       для него foreach. Более подробно читайте в разделе

Modified: phpdoc/ru/trunk/reference/com/ini.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/ini.xml	2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/ini.xml	2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 347687 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <section xml:id="com.configuration" xmlns="http://docbook.org/ns/docbook">
  &reftitle.runtime;
@@ -86,7 +86,7 @@
       Если включено, PHP попробует зарегистрировать константы
       библиотеки типов создаваемых объектов <classname>COM</classname>,
       если эти объекты реализуют
-      интерфейс, требуемый лоя получения данной информации.
+      интерфейс, требуемый для получения данной информации.
       Регистрозависимость регистрируемых констант контролируется
       <xref
       linkend="ini.com.autoregister-casesensitive"/> директивой конфигурации.
@@ -129,7 +129,7 @@
     <listitem>
      <para>
       Контролирует кодировку по умолчанию при передаче строк объектам COM.
-      Если задано пустой строкой, PHP будет считать, что вы хотите использовать
+      Если задана пустая строка, PHP будет считать, что вы хотите использовать
       <constant>CP_ACP</constant> - системная кодировка ANSI по умолчанию.
      </para>
      <para>
@@ -136,8 +136,8 @@
       Если текст в вашем скрипте содержится в кодировке отличной от
       кодировки по умолчанию, то установка этого параметра позволит вам не указывать
       кодировку каждый раз при создании объекта класса <xref
-      linkend="class.com"/> в его конструкторе.  Пожалуйста помните, что
-      исполь этой директивы (как и любой другой директивы конфигурации) делает
+      linkend="class.com"/> в его конструкторе. Пожалуйста помните, что
+      использование этой директивы (как и любой другой директивы конфигурации) делает
       ваш скрипт менее переносимым, так что все же рекомендуется указывать кодировку
       при каждом создании объекта COM.
      </para>
@@ -150,7 +150,7 @@
     </term>
     <listitem>
      <para>
-      Значение должно соответствовать пути на файловой системе до
+      Значение должно соответствовать пути в файловой системе до
       файла, содержащего список библиотек типов, которые необходимо
       загрузить при запуске. Каждая строка файла будет рассматриваться
       как имя библиотеки типов, которая будет загружена как только

Modified: phpdoc/ru/trunk/reference/com/reference.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/reference.xml	2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/reference.xml	2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 341294 Maintainer: mch Status: ready -->
 <!-- $Revision$ -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->

 <reference xml:id="ref.com" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <title>COM &Functions;</title>
+ <title>&Functions; COM</title>

  <partintro>
   <section xml:id="com.seealso">

Modified: phpdoc/ru/trunk/reference/com/setup.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/setup.xml	2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/setup.xml	2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 347693 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <chapter xml:id="com.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.setup;
@@ -21,12 +21,12 @@
  <section xml:id="com.installation">
   &reftitle.install;
   <para>
-   С PHP 5.3.15 / 5.4.5, это расширение требует разрешение
+   С PHP 5.3.15 / 5.4.5, модуль требует включение
    <filename>php_com_dotnet.dll</filename> в &php.ini;. В предыдущих версиях
-   PHP это расширение было включено по умолчанию.
+   PHP модуль был включен по умолчанию.
   </para>
   <para>
-   Поддержку для различных вариантов объектов COM (например MS Word) необходимо
+   Поддержку для различных вариантов объектов COM (например, MS Word) необходимо
    устанавливать самостоятельно. Мы не можем и не будем включать все эти модули в PHP.
   </para>
  </section>

Modified: phpdoc/ru/trunk/reference/com/variant.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/variant.xml	2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/variant.xml	2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 347688 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.variant" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <titleabbrev>VARIANT</titleabbrev>
@@ -13,8 +13,8 @@
    <para>
     VARIANT - это эквивалент zval для COM; это структура, которая может
     содержать значения различных допустимых типов. Класс VARIANT
-    входит в расширение COM и позволяет более полно контролировать
-    значения передаваемые от PHP к COM и обратно.
+    входит в модуль COM и позволяет больше контролировать
+    значения, передаваемые от PHP к COM и обратно.
    </para>
   </section>
 <!-- }}} -->
@@ -67,8 +67,8 @@
      к потере информации. Во всех остальных случаях результат вернется в виде
      экземпляра класса VARIANT. Вы можете принудительно указать PHP
      конвертировать значения в типы PHP используя оператор приведения типов
-     или же преобразовывать их в строку используя функцию <function>print</function>.
-     Вы можете использовать множество функций класса для арефметических
+     или же преобразовывать их в строку, используя функцию <function>print</function>.
+     Вы можете использовать множество функций класса для арифметических
      операций без приведения значений к типам PHP с риском потери информации.
     </para>
    </note>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.