1
0
mirror of https://github.com/php/doc-en.git synced 2026-03-23 23:32:18 +01:00

phpdbg: fix XML to remove useless wrapping para tags via script

This commit is contained in:
Gina Peter Banyard
2026-01-26 15:26:30 +00:00
parent 53208f9bd0
commit 17aa1d3744
3 changed files with 350 additions and 364 deletions

View File

@@ -1,7 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<book xml:id="book.phpdbg" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.phpdbg">
<?phpdoc extension-membership="bundled" ?>
<title>Interactive PHP Debugger</title>
<titleabbrev>phpdbg</titleabbrev>
@@ -46,184 +45,182 @@
</itemizedlist>
</para>
<para>
<table>
<title>Command line options</title>
<tgroup cols="2">
<thead>
<row>
<entry>Option</entry>
<entry>Example Argument</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>-c</entry>
<entry>-c/my/php.ini</entry>
<entry>
Set php.ini file to load
</entry>
</row>
<row>
<entry>-d</entry>
<entry>-dmemory_limit=4G</entry>
<entry>
Set a php.ini directive
</entry>
</row>
<row>
<entry>-n</entry>
<entry></entry>
<entry>
Disable default php.ini
</entry>
</row>
<row>
<entry>-q</entry>
<entry></entry>
<entry>
Suppress welcome banner
</entry>
</row>
<row>
<entry>-v</entry>
<entry></entry>
<entry>
Enable oplog output
</entry>
</row>
<row>
<entry>-b</entry>
<entry></entry>
<entry>
Disable color
</entry>
</row>
<row>
<entry>-i</entry>
<entry>-imy.init</entry>
<entry>
Set .phpdbginit file
</entry>
</row>
<row>
<entry>-I</entry>
<entry></entry>
<entry>
Ignore default .phpdbginit
</entry>
</row>
<row>
<entry>-O</entry>
<entry>-Omy.oplog</entry>
<entry>
Set oplog output file
</entry>
</row>
<row>
<entry>-r</entry>
<entry></entry>
<entry>
Run execution context
</entry>
</row>
<row>
<entry>-rr</entry>
<entry></entry>
<entry>
Run execution context and quit after execution (not respecting breakpoints)
</entry>
</row>
<row>
<entry>-e</entry>
<entry></entry>
<entry>
Generate extended information for debugger/profiler
</entry>
</row>
<row>
<entry>-E</entry>
<entry></entry>
<entry>
Enable step through eval, careful!
</entry>
</row>
<row>
<entry>-s</entry>
<entry>-s=, -s=foo</entry>
<entry>
Read code to execute from stdin with an optional delimiter
</entry>
</row>
<row>
<entry>-S</entry>
<entry>-Scli</entry>
<entry>
Override SAPI name, careful!
</entry>
</row>
<row>
<entry></entry>
<entry></entry>
<entry>
<para>
</para>
</entry>
</row>
<row>
<entry>-l</entry>
<entry>-l4000</entry>
<entry>
Setup remote console ports
</entry>
</row>
<row>
<entry>-a</entry>
<entry>-a192.168.0.3</entry>
<entry>
Setup remote console bind address
</entry>
</row>
<row>
<entry>-x</entry>
<entry></entry>
<entry>
Enable xml output (instead of normal text output)
</entry>
</row>
<row>
<entry>-p</entry>
<entry>-p, -p=func, -p*</entry>
<entry>
Output opcodes and quit
</entry>
</row>
<row>
<entry>-h</entry>
<entry></entry>
<entry>
Print the help overview
</entry>
</row>
<row>
<entry>-V</entry>
<entry></entry>
<entry>
Print version number
</entry>
</row>
<row>
<entry>--</entry>
<entry>-- arg1 arg2</entry>
<entry>
Use to delimit phpdbg arguments and php $argv; append any $argv argument after it
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<table>
<title>Command line options</title>
<tgroup cols="2">
<thead>
<row>
<entry>Option</entry>
<entry>Example Argument</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>-c</entry>
<entry>-c/my/php.ini</entry>
<entry>
Set php.ini file to load
</entry>
</row>
<row>
<entry>-d</entry>
<entry>-dmemory_limit=4G</entry>
<entry>
Set a php.ini directive
</entry>
</row>
<row>
<entry>-n</entry>
<entry/>
<entry>
Disable default php.ini
</entry>
</row>
<row>
<entry>-q</entry>
<entry/>
<entry>
Suppress welcome banner
</entry>
</row>
<row>
<entry>-v</entry>
<entry/>
<entry>
Enable oplog output
</entry>
</row>
<row>
<entry>-b</entry>
<entry/>
<entry>
Disable color
</entry>
</row>
<row>
<entry>-i</entry>
<entry>-imy.init</entry>
<entry>
Set .phpdbginit file
</entry>
</row>
<row>
<entry>-I</entry>
<entry/>
<entry>
Ignore default .phpdbginit
</entry>
</row>
<row>
<entry>-O</entry>
<entry>-Omy.oplog</entry>
<entry>
Set oplog output file
</entry>
</row>
<row>
<entry>-r</entry>
<entry/>
<entry>
Run execution context
</entry>
</row>
<row>
<entry>-rr</entry>
<entry/>
<entry>
Run execution context and quit after execution (not respecting breakpoints)
</entry>
</row>
<row>
<entry>-e</entry>
<entry/>
<entry>
Generate extended information for debugger/profiler
</entry>
</row>
<row>
<entry>-E</entry>
<entry/>
<entry>
Enable step through eval, careful!
</entry>
</row>
<row>
<entry>-s</entry>
<entry>-s=, -s=foo</entry>
<entry>
Read code to execute from stdin with an optional delimiter
</entry>
</row>
<row>
<entry>-S</entry>
<entry>-Scli</entry>
<entry>
Override SAPI name, careful!
</entry>
</row>
<row>
<entry/>
<entry/>
<entry>
<para>
</para>
</entry>
</row>
<row>
<entry>-l</entry>
<entry>-l4000</entry>
<entry>
Setup remote console ports
</entry>
</row>
<row>
<entry>-a</entry>
<entry>-a192.168.0.3</entry>
<entry>
Setup remote console bind address
</entry>
</row>
<row>
<entry>-x</entry>
<entry/>
<entry>
Enable xml output (instead of normal text output)
</entry>
</row>
<row>
<entry>-p</entry>
<entry>-p, -p=func, -p*</entry>
<entry>
Output opcodes and quit
</entry>
</row>
<row>
<entry>-h</entry>
<entry/>
<entry>
Print the help overview
</entry>
</row>
<row>
<entry>-V</entry>
<entry/>
<entry>
Print version number
</entry>
</row>
<row>
<entry>--</entry>
<entry>-- arg1 arg2</entry>
<entry>
Use to delimit phpdbg arguments and php $argv; append any $argv argument after it
</entry>
</row>
</tbody>
</tgroup>
</table>
</preface>
@@ -232,7 +229,6 @@
&reference.phpdbg.reference;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View File

@@ -1,99 +1,95 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<appendix xml:id="phpdbg.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<appendix xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="phpdbg.constants">
&reftitle.constants;
&extension.constants;
<para>
<variablelist>
<varlistentry xml:id="constant.phpdbg-version">
<term>
<constant>PHPDBG_VERSION</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.phpdbg-file">
<term>
<constant>PHPDBG_FILE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Removed as of PHP 7.3.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.phpdbg-method">
<term>
<constant>PHPDBG_METHOD</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Removed as of PHP 7.3.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.phpdbg-lineno">
<term>
<constant>PHPDBG_LINENO</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Removed as of PHP 7.3.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.phpdbg-func">
<term>
<constant>PHPDBG_FUNC</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Removed as of PHP 7.3.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.phpdbg-color-prompt">
<term>
<constant>PHPDBG_COLOR_PROMPT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.phpdbg-color-notice">
<term>
<constant>PHPDBG_COLOR_NOTICE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.phpdbg-color-error">
<term>
<constant>PHPDBG_COLOR_ERROR</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry xml:id="constant.phpdbg-version">
<term>
<constant>PHPDBG_VERSION</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.phpdbg-file">
<term>
<constant>PHPDBG_FILE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Removed as of PHP 7.3.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.phpdbg-method">
<term>
<constant>PHPDBG_METHOD</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Removed as of PHP 7.3.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.phpdbg-lineno">
<term>
<constant>PHPDBG_LINENO</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Removed as of PHP 7.3.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.phpdbg-func">
<term>
<constant>PHPDBG_FUNC</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Removed as of PHP 7.3.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.phpdbg-color-prompt">
<term>
<constant>PHPDBG_COLOR_PROMPT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.phpdbg-color-notice">
<term>
<constant>PHPDBG_COLOR_NOTICE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.phpdbg-color-error">
<term>
<constant>PHPDBG_COLOR_ERROR</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View File

@@ -1,104 +1,98 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<section xml:id="phpdbg.configuration" xmlns="http://docbook.org/ns/docbook">
<section xmlns="http://docbook.org/ns/docbook" xml:id="phpdbg.configuration">
&reftitle.runtime;
&extension.runtime;
<para>
<table>
<title>phpdbg &ConfigureOptions;</title>
<tgroup cols="4">
<thead>
<row>
<entry>&Name;</entry>
<entry>&Default;</entry>
<entry>&Changeable;</entry>
<entry>&Changelog;</entry>
</row>
</thead>
<tbody>
<row>
<entry><link linkend="ini.phpdbg.eol">phpdbg.eol</link></entry>
<entry>2</entry>
<entry><constant>INI_ALL</constant></entry>
<entry>Removed as of PHP 8.1.0</entry>
</row>
<row>
<entry><link linkend="ini.phpdbg.path">phpdbg.path</link></entry>
<entry></entry>
<entry>6</entry>
<entry>Removed as of PHP 8.1.0</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<table>
<title>phpdbg &ConfigureOptions;</title>
<tgroup cols="4">
<thead>
<row>
<entry>&Name;</entry>
<entry>&Default;</entry>
<entry>&Changeable;</entry>
<entry>&Changelog;</entry>
</row>
</thead>
<tbody>
<row>
<entry><link linkend="ini.phpdbg.eol">phpdbg.eol</link></entry>
<entry>2</entry>
<entry><constant>INI_ALL</constant></entry>
<entry>Removed as of PHP 8.1.0</entry>
</row>
<row>
<entry><link linkend="ini.phpdbg.path">phpdbg.path</link></entry>
<entry/>
<entry>6</entry>
<entry>Removed as of PHP 8.1.0</entry>
</row>
</tbody>
</tgroup>
</table>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry xml:id="ini.phpdbg.eol">
<term>
<parameter>phpdbg.eol</parameter>
<type>mixed</type>
</term>
<listitem>
<para>
The kind of line ending to use for output. For setting the value, one of
the string aliases must be used.
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry><type>int</type> Value</entry>
<entry><type>string</type> Alias</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>0</literal></entry>
<entry>
<literal>CRLF</literal>, <literal>crlf</literal>,
<literal>DOS</literal>, <literal>dos</literal>
</entry>
</row>
<row>
<entry><literal>1</literal></entry>
<entry>
<literal>LF</literal>, <literal>lf</literal>,
<literal>UNIX</literal>, <literal>unix</literal>
</entry>
</row>
<row>
<entry><literal>2</literal></entry>
<entry>
<literal>CR</literal>, <literal>cr</literal>,
<literal>MAC</literal>, <literal>mac</literal>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.phpdbg.path">
<term>
<parameter>phpdbg.path</parameter>
<type>string</type>
</term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
<variablelist>
<varlistentry xml:id="ini.phpdbg.eol">
<term>
<parameter>phpdbg.eol</parameter>
<type>mixed</type>
</term>
<listitem>
<para>
The kind of line ending to use for output. For setting the value, one of
the string aliases must be used.
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry><type>int</type> Value</entry>
<entry><type>string</type> Alias</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>0</literal></entry>
<entry>
<literal>CRLF</literal>, <literal>crlf</literal>,
<literal>DOS</literal>, <literal>dos</literal>
</entry>
</row>
<row>
<entry><literal>1</literal></entry>
<entry>
<literal>LF</literal>, <literal>lf</literal>,
<literal>UNIX</literal>, <literal>unix</literal>
</entry>
</row>
<row>
<entry><literal>2</literal></entry>
<entry>
<literal>CR</literal>, <literal>cr</literal>,
<literal>MAC</literal>, <literal>mac</literal>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.phpdbg.path">
<term>
<parameter>phpdbg.path</parameter>
<type>string</type>
</term>
<listitem>
<para>
</variablelist>
</para>
</para>
</listitem>
</varlistentry>
</variablelist>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml