Update proc-get-status.xml to En + infostyle

This commit is contained in:
Mikhail Alferov
2024-11-24 08:02:34 +03:00
committed by GitHub
parent d101c9c303
commit 024e886471

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 2b782ad1abad454105767b8377c8d01716f7e654 Maintainer: mch Status: ready -->
<!-- EN-Revision: af704f619e3f35940b874459ca7c625308e8968c Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id='function.proc-get-status' xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -67,50 +67,59 @@
<entry>running</entry>
<entry><type>bool</type></entry>
<entry>
&true;, если процесс всё ещё запущен, &false;, если он был
завершён.
Значение элемента равняется &true;, если процесс всё ещё запущен, &false;, если процесс
завершился.
</entry>
</row>
<row>
<entry>signaled</entry>
<entry><type>bool</type></entry>
<entry>
&true;, если дочерний процесс был завершён неперехваченным
сигналом. Всегда устанавливается в &false; в Windows.
Значение элемента равняется &true;, если дочерний процесс завершился неперехваченным
сигналом. В Windows независимо от условия завершения дочернего процесса значение элемента равняется &false;.
</entry>
</row>
<row>
<entry>stopped</entry>
<entry><type>bool</type></entry>
<entry>
&true;, если дочерний процесс был остановлен
сигналом. Всегда устанавливается в &false; в ОС Windows.
Значение элемента равняется &true;, если дочерний процесс остановился
сигналом. В Windows независимо от условия остановки дочернего процесса значение элемента равняется &false;.
</entry>
</row>
<row>
<entry>exitcode</entry>
<entry><type>int</type></entry>
<entry>
Код возврата, передаваемый процессом (имеет значение только в
том случае, если <literal>running</literal> равно &false;).
Только первый вызов этой функции возвратит реальное значение, последующие вызовы
будут возвращать <literal>-1</literal>.
Код завершения, который возвращается процессом и который несёт смысл, только
если значение элемента <literal>running</literal> равно &false;.
До PHP 8.3.0 только первый вызов функции возвращал реальное
значение, очередные вызовы возвращали значение <literal>-1</literal>.
</entry>
</row>
<row>
<entry>cached</entry>
<entry><type>bool</type></entry>
<entry>
С PHP 8.3.0 значение элемента равно &true;, когда код завершения закешировался.
Кеширование гарантирует, что код завершения не потеряется
при очередных вызовах к API-интерфейсу процесса.
</entry>
</row>
<row>
<entry>termsig</entry>
<entry><type>int</type></entry>
<entry>
Номер сигнала, который заставил дочерний процесс прекратить его
выполнение (имеет значение только в том случае, если <literal>signaled</literal> равно &true;).
Номер сигнала, который заставил дочерний процесс завершить
выполнение и который несёт смысл, только если значение элемента <literal>signaled</literal> равно &true;.
</entry>
</row>
<row>
<entry>stopsig</entry>
<entry><type>int</type></entry>
<entry>
Номер сигнала, который заставил дочерний процесс остановить его
выполнение (имеет значение только в том случае, если <literal>stopped</literal> равно &true;).
Номер сигнала, который заставил дочерний процесс остановить
выполнение и который несёт смысле, только если значение элемента <literal>stopped</literal> равно &true;.
</entry>
</row>
</tbody>
@ -119,6 +128,32 @@
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.3.0</entry>
<entry>
В массив возврата добавили запись <literal>"cached"</literal>.
До PHP 8.3.0 только первый вызов возвращал реальной код завершения.
Запись <literal>"cached"</literal> указывает на то, что код завершения
закешировался.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>