Update basic-syntax.xml to en

Author: mmalferov

language/basic-syntax.xml

@@ -1,23 +1,30 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f4f96ef8b2a95283c92ea2183fe1dedf06f3ad22 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 0e618211e53c66f33762be225a4d57c08ef4b2f7 Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
-<chapter xml:id="language.basic-syntax" xmlns="http://docbook.org/ns/docbook">
+ <chapter xml:id="language.basic-syntax" xmlns="http://docbook.org/ns/docbook" annotations="interactive">
  <title>Основы синтаксиса</title>
  <sect1 xml:id="language.basic-syntax.phptags">
   <title>PHP-теги</title>
   <para>
-   При разборе файла PHP-интерпретатор ищет открывающие и закрывающие теги.
-   Тег <literal>&lt;?php</literal> сообщает PHP, когда начинать интерпретацию PHP-кода,
-   а тег <literal>?&gt;</literal>, когда заканчивать. Такой способ разбора разрешает
-   встраивать PHP-код в разные документы, поскольку PHP-парсер проигнорирует всё,
-   что разместили вне пары открывающего и закрывающего тегов.
+   При разборе файла PHP-интерпретатор распознаёт открывающие и закрывающие теги
+   <literal>&lt;?php</literal> и <literal>?&gt;</literal>,
+   чтобы определить границы выполнения PHP-кода.
+   PHP-парсер игнорирует содержимое за пределами этих тегов, что разрешает
+   бесшовно встраивать PHP-код в документы одного или другого типа.
   </para>
 
   <para>
-   PHP включает короткий echo-тег <literal>&lt;?=</literal> —
-   сокращение более многословного синтаксиса <code>&lt;?php echo</code>.
+   За тегом <literal>&lt;?php</literal> обязательно указывают
+   пробельный символ наподобие пробела, символа табуляции или новой строки,
+   чтобы правильно разделить токены.
+   Без пробельного символа возникнет синтаксическая ошибка.
   </para>
 
+   <para>
+    PHP также включает короткий echo-тег <literal>&lt;?=</literal> —
+    сокращение более многословного синтаксиса <code>&lt;?php echo</code>.
+   </para>
+
   <para>
    <example>
     <title>Открывающие и закрывающие теги PHP</title>
@@ -54,26 +61,28 @@
   </para>
 
   <para>
-   Лучше опустить PHP-тег, которым закрывают блок PHP-кода в конце файла, если файл состоит только из PHP-кода.
+   Лучше не закрывать PHP-тегом блок PHP-кода, который стоит в конце файла.
    Это предотвращает случайное добавление пробелов или переводов
    строк после закрывающего PHP-тега, которые иногда становятся причиной нежелательных
    эффектов, поскольку PHP начнёт буферизацию вывода, если программист не намерен
    отправлять вывод в этой точке скрипта.
-   <informalexample>
+  </para>
+  <para>
+   <example>
+    <title>Файл только с PHP-кодом</title>
     <programlisting role="php">
 <![CDATA[
 <?php
 
-echo "Hello world";
+echo "Привет, мир!\n";
 
-// ... ещё код
-
-echo "Последняя инструкция";
+// …ещё код
 
+echo "Последняя инструкция\n";
 // Скрипт заканчивается в этом месте без PHP-тега, которым закрывается блок кода
 ]]>
     </programlisting>
-   </informalexample>
+   </example>
   </para>
  </sect1>
 
@@ -83,15 +92,20 @@ echo "Последняя инструкция";
    PHP-интерпретатор игнорирует всё, что разместили вне пары открывающего и закрывающего тегов,
    что разрешает добавлять в файлы смешанное содержимое. Это разрешает встраивать PHP-код
    в HTML-документы, чтобы, например, создавать шаблоны.
-   <informalexample>
+  </para>
+  <para>
+   <example>
+    <title>PHP-код, который встроили в HTML-разметку</title>
     <programlisting role="php">
 <![CDATA[
 <p>PHP-интерпретатор проигнорирует разбор PHP-кода в этом параграфе, а текст отобразится в браузере.</p>
 <?php echo 'А эту строку файла — разберёт.'; ?>
 <p>Этот параграф PHP тоже не станет анализировать как PHP-код и отправит в браузер.</p>
 ]]>
     </programlisting>
-   </informalexample>
+   </example>
+  </para>
+  <para>
    Это работает предсказуемо, поскольку когда PHP-интерпретатор встречает закрывающие теги ?&gt;,
    он просто начинает выводить всё, что находит, — за исключением перевода строки, который
    идёт сразу за закрывающим тегом, как описывает раздел
@@ -165,53 +179,61 @@ echo "Последняя инструкция";
    </para>
 
   <para>
-   Примеры входа в режим PHP-парсера и выхода из него:
-
-   <informalexample>
+   <example>
+    <title>Примеры входа в режим PHP-парсера и выхода из него</title>
     <programlisting role="php">
 <![CDATA[
 <?php
-    echo 'Это тест';
+
+echo "Это тест\n";
+
 ?>
 
-<?php echo 'Это тест' ?>
+<?php echo "Это тест\n" ?>
 
-<?php echo 'Мы опустили последний закрывающий тег';
+<?php echo "Не закрываем блок кода в конце файла PHP-тегом\n";
 ]]>
-     </programlisting>
-    </informalexample>
-    <note>
-     <para>
-      Тег, которым закрывается блок PHP-кода в конце файла, необязателен,
-      а при подключении файлов выражением <function>include</function>
-      или <function>require</function> пропуск тега иногда приносит пользу,
-      чтобы нежелательные пробелы не появлялись в конце файлов и не мешали позже
-      добавлять к ответу сервера дополнительные HTTP-заголовки. При буферизации вывода
-      пропуск тега также помогает исключить нежелательные пробелы в конце частей,
-      которые сгенерировали подключаемые файлы.
-     </para>
-    </note>
-   </para>
+    </programlisting>
+   </example>
+  </para>
+  <para>
+   <note>
+    <para>
+     Тег, которым закрывается блок PHP-кода в конце файла, необязателен,
+     а при подключении файлов выражением <function>include</function>
+     или <function>require</function> пропуск тега иногда приносит пользу,
+     чтобы нежелательные пробелы не появлялись в конце файлов и не мешали позже
+     добавлять к ответу сервера дополнительные HTTP-заголовки. При буферизации вывода
+     пропуск тега также помогает исключить нежелательные пробелы в конце частей,
+     которые сгенерировали подключаемые файлы.
+    </para>
+   </note>
+  </para>
  </sect1>
  <sect1 xml:id="language.basic-syntax.comments">
   <title>Комментарии</title>
   <para>
    PHP поддерживает комментарии в стиле языков программирования C, C++
    и в стиле командной оболочки Unix-систем, которая унаследовала стиль комментариев из языка Perl. Например:
 
-   <informalexample>
+  </para>
+  <para>
+   <example>
+    <title>Пример комментариев</title>
     <programlisting role="php">
 <![CDATA[
 <?php
-    echo "Это тест"; // Это однострочный комментарий в стиле языка C++
-    /* Это многострочный комментарий
-       ещё одна строка комментария */
-    echo "Это ещё один тест";
-    echo "Последний тест"; # Это комментарий в стиле Unix-оболочки
+
+echo "Это тест"; // Это однострочный комментарий в стиле языка C++
+/* Это многострочный комментарий
+   ещё одна строка комментария */
+echo "Это ещё один тест\n";
+echo "Ещё один последний тест\n"; # Это комментарий в стиле Unix-оболочки
+
 ?>
 ]]>
      </programlisting>
-    </informalexample>
+    </example>
    </para>
    <simpara>
     Однострочные комментарии распространяются только до конца строки PHP-кода
@@ -222,14 +244,15 @@ echo "Последняя инструкция";
     или <literal>#</literal> не влияют на это.
    </simpara>
    <para>
-    <informalexample>
+    <example>
+     <title>Пример однострочных комментариев</title>
      <programlisting role="php">
 <![CDATA[
 <h1>Это <?php # echo "простой";?> пример</h1>
 <p>Заголовок вверху выведет 'Это  пример'.</p>
 ]]>
     </programlisting>
-   </informalexample>
+   </example>
    </para>
    <simpara>
     Комментарии в стиле языка C заканчиваются, когда обнаруживается первая последовательность
@@ -242,9 +265,11 @@ echo "Последняя инструкция";
      <programlisting role="php">
 <![CDATA[
 <?php
- /*
+
+/*
     echo "Это тест"; /* Этот комментарий вызовет ошибку */
- */
+*/
+
 ?>
 ]]>
     </programlisting>