Hello!
I've added long options to features/commandline.xml. I have not
committed it yet because I'm not satisfied with word wrapping of these
options. Is there a way in Docbook how to say that table cell
shouldn't be wrapped (like <td nowrap>) or is there some special
character non-breaking-dash?
Jakub Vrana
Index: commandline.xml
===================================================================
RCS file: /repository/phpdoc/en/features/commandline.xml,v
retrieving revision 1.23
diff -u -r1.23 commandline.xml
--- commandline.xml 18 Jun 2003 10:38:43 -0000 1.23
+++ commandline.xml 11 Dec 2003 12:35:24 -0000
@@ -96,11 +96,11 @@
</para>
<para>
CLI is started up in quiet mode by default, though the <literal>-q</literal>
- switch is kept for compatibility so that you can use older CGI scripts.
+ and <literal>--no-header</literal> switches are kept for compatibility so that
you can use older CGI scripts.
</para>
<para>
It does not change the working directory to that of the script.
- (<literal>-C</literal> switch kept for compatibility)
+ (<literal>-C</literal> and <literal>--no-chdir</literal> switches kept for
compatibility)
</para>
<para>
Plain text error messages (no HTML formatting).
@@ -492,18 +492,21 @@
which start with <literal>-</literal> to your script.
</para>
<para>
+ Long options are available since PHP 4.3.3.
<table>
<title>Command line options</title>
<tgroup cols="2">
<thead>
<row>
<entry>Option</entry>
+ <entry>Long Option</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>-s</entry>
+ <entry>--syntax-highlight</entry>
<entry>
<para>
Display colour syntax highlighted source.
@@ -524,7 +527,17 @@
</entry>
</row>
<row>
+ <entry>-s</entry>
+ <entry>--syntax-highlighting</entry>
+ <entry>
+ <para>
+ Alias of <literal>--syntax-highlight</literal>.
+ </para>
+ </entry>
+ </row>
+ <row>
<entry>-w</entry>
+ <entry>--strip</entry>
<entry>
<para>
Display source with stripped comments and whitespace.
@@ -539,6 +552,7 @@
</row>
<row>
<entry>-f</entry>
+ <entry>--file</entry>
<entry>
<para>
Parses and executed the given filename to the <literal>-f</literal>
@@ -549,6 +563,7 @@
</row>
<row>
<entry>-v</entry>
+ <entry>--version</entry>
<entry>
<para>
Writes the PHP, PHP SAPI, and Zend version to standard output, e.g.
@@ -564,6 +579,7 @@
</row>
<row>
<entry>-c</entry>
+ <entry>--php-ini</entry>
<entry>
<para>
With this option one can either specify a directory where to look for
@@ -580,19 +596,17 @@
</entry>
</row>
<row>
- <entry>-a</entry>
+ <entry>-n</entry>
+ <entry>--no-php-ini</entry>
<entry>
<para>
- Runs PHP interactively.
- <!--
- mfischer, 20020510: Couldn't come up with a decent useful description
- of the current implementation of the interactive mode.
- -->
+ Ignore php.ini at all. This switch is available since PHP 4.3.0.
</para>
</entry>
</row>
<row>
<entry>-d</entry>
+ <entry>--define</entry>
<entry>
<para>
This option allows you to set a custom value for any of the configuration
@@ -631,7 +645,21 @@
</entry>
</row>
<row>
+ <entry>-a</entry>
+ <entry>--interactive</entry>
+ <entry>
+ <para>
+ Runs PHP interactively.
+ <!--
+ mfischer, 20020510: Couldn't come up with a decent useful description
+ of the current implementation of the interactive mode.
+ -->
+ </para>
+ </entry>
+ </row>
+ <row>
<entry>-e</entry>
+ <entry>--profile-info</entry>
<entry>
<para>
Generate extended information for debugger/profiler.
@@ -644,6 +672,7 @@
</row>
<row>
<entry>-z</entry>
+ <entry>--zend-extension</entry>
<entry>
<para>
Load Zend extension. If only a filename is given, PHP tries to load
@@ -658,6 +687,7 @@
</row>
<row>
<entry>-l</entry>
+ <entry>--syntax-check</entry>
<entry>
<para>
This option provides a convenient way to only perform a syntax check
@@ -683,6 +713,7 @@
</row>
<row>
<entry>-m</entry>
+ <entry>--modules</entry>
<entry>
<para>
Using this option, PHP prints out the built in (and loaded) PHP and
@@ -710,6 +741,7 @@
</row>
<row>
<entry>-i</entry>
+ <entry>--info</entry>
<entry>
This command line option calls <function>phpinfo</function>, and prints
out the results. If <literal>PHP</literal> is not working correctly, it is
@@ -721,6 +753,7 @@
</row>
<row>
<entry>-r</entry>
+ <entry>--run</entry>
<entry>
<para>
This option allows execution of <literal>PHP</literal> right from
@@ -791,11 +824,29 @@
</row>
<row>
<entry>-h</entry>
+ <entry>--help</entry>
<entry>
With this option, you can get information about the actual list of
command line options and some one line descriptions about what they do.
</entry>
</row>
+ <row>
+ <entry>-?</entry>
+ <entry>--usage</entry>
+ <entry>
+ Alias of <literal>--help</literal>.
+ </entry>
+ </row>
+ <!--
+ new, not in PHP 4.3.4, but are in php_cli.c 1.102 or cgi_main.c 1.243
+ -b <address:port>|<port> bindpath Bind Path for external FASTCGI Server mode,
only CGI, no Windows
+ -B <begin_code> process-begin Run PHP <begin_code> before processing input
lines
+ -R <code> process-code Run PHP <code> for every input line
+ -F <file> process-file Parse and execute <file> for every input line
+ -E <end_code> process-end Run PHP <end_code> after processing all input
lines
+ -H hide-args Hide any passed arguments from external tools.
+ -g global Define global variables on command line
+ -->
</tbody>
</tgroup>
</table>
