From e60568fbb14bfba8b180b1cb9a3007ca83289d86 Mon Sep 17 00:00:00 2001
From: Nuno Lopes <nlopess@php.net>
Date: Sun, 11 Feb 2007 14:01:31 +0000
Subject: [PATCH] document --r* switches

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@229542 c90b9560-bf6c-de11-be94-00142212c4b1
---
 features/commandline.xml | 69 ++++++++++++++++++++++++++++++++++++++--
 1 file changed, 66 insertions(+), 3 deletions(-)

diff --git a/features/commandline.xml b/features/commandline.xml
index 375f16805e..9487a730a0 100644
--- a/features/commandline.xml
+++ b/features/commandline.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.44 $ -->
+<!-- $Revision: 1.45 $ -->
 <chapter id="features.commandline">
  <title>Using PHP from the command line</title>
  <para>
@@ -361,12 +361,12 @@ Usage: php [options] [-f] <file> [--] [args...]
        php [options] -- [args...]
        php [options] -a
 
-  -a               Run interactively
+  -a               Run as interactive shell
   -c <path>|<file> Look for php.ini file in this directory
   -n               No php.ini file will be used
   -d foo[=bar]     Define INI entry foo with value 'bar'
   -e               Generate extended information for debugger/profiler
-  -f <file>        Parse <file>.
+  -f <file>        Parse and execute <file>.
   -h               This help
   -i               PHP information
   -l               Syntax check only (lint)
@@ -384,6 +384,11 @@ Usage: php [options] [-f] <file> [--] [args...]
 
   args...          Arguments passed to script. Use -- args when first argument
                    starts with - or script is read from stdin
+
+  --rf <name>      Show information about function <name>.
+  --rc <name>      Show information about class <name>.
+  --re <name>      Show information about extension <name>.
+  --ri <name>      Show configuration for extension <name>.
 ]]>
   </screen>
  </para>
@@ -968,6 +973,64 @@ Zend Engine v1.3.0, Copyright (c) 1998-2002 Zend Technologies
        </para>
       </entry>
      </row>
+     <row>
+      <entry>--rf</entry>
+      <entry>--rfunction</entry>
+      <entry>
+       <para>
+        Shows information about the given function or class method (e.g.
+        number and name of the parameters). Available as of PHP 5.1.2.
+       </para>
+       <para>
+        <example>
+         <title>basic <literal>--rf</literal> usage</title>
+         <programlisting role="shell">
+<![CDATA[
+$ php --rf var_dump
+Function [ <internal> public function var_dump ] {
+
+  - Parameters [2] {
+    Parameter #0 [ <required> $var ]
+    Parameter #1 [ <optional> $... ]
+  }
+}
+]]>
+         </programlisting>
+        </example>
+       </para>
+      </entry>
+     </row>
+     <row>
+      <entry>--rc</entry>
+      <entry>--rclass</entry>
+      <entry>
+       <para>
+        Show information about the given class (list of constants, properties
+        and methods). Available as of PHP 5.1.2.
+       </para>
+      </entry>
+     </row>
+     <row>
+      <entry>--re</entry>
+      <entry>--rextension</entry>
+      <entry>
+       <para>
+        Show information about the given extension (list of &php.ini; options,
+        defined functions, constants and classes). Available as of PHP 5.1.2.
+       </para>
+      </entry>
+     </row>
+     <row>
+      <entry>-ri</entry>
+      <entry>--rextinfo</entry>
+      <entry>
+       <para>
+        Shows the configuration information for the given extension (the same
+        information that is returned by <function>phpinfo</function>).
+        Available as of PHP 5.2.2.
+       </para>
+      </entry>
+     </row>
     </tbody>
    </tgroup>
   </table>