* add --installroot / -R option to install/upgrade commands

pear/PEAR/Command/Install.php

@@ -61,6 +61,11 @@ class PEAR_Command_Install extends PEAR_Command_Common
                     'shortopt' => 'Z',
                     'doc' => 'request uncompressed files when downloading',
                     ),
+                'installroot' => array(
+                    'shortopt' => 'R',
+                    'arg' => 'DIR',
+                    'doc' => 'root directory used when installing files (ala PHP\'s INSTALL_ROOT)',
+                    ),
                 ),
             'doc' => '<package> ...
 Installs one or more PEAR packages.  You can specify a package to
@@ -107,6 +112,11 @@ four ways of specifying packages.
                     'shortopt' => 'Z',
                     'doc' => 'request uncompressed files when downloading',
                     ),
+                'installroot' => array(
+                    'shortopt' => 'R',
+                    'arg' => 'DIR',
+                    'doc' => 'root directory used when installing files (ala PHP\'s INSTALL_ROOT)',
+                    ),
                 ),
             'doc' => '<package> ...
 Upgrades one or more PEAR packages.  See documentation for the
@@ -139,6 +149,11 @@ More than one package may be specified at once.
                     'shortopt' => 'Z',
                     'doc' => 'request uncompressed files when downloading',
                     ),
+                'installroot' => array(
+                    'shortopt' => 'R',
+                    'arg' => 'DIR',
+                    'doc' => 'root directory used when installing files (ala PHP\'s INSTALL_ROOT)',
+                    ),
                 ),
             'doc' => '
 Upgrades all packages that have a newer release available.  Upgrades are
@@ -159,6 +174,11 @@ more stable.
                     'shortopt' => 'r',
                     'doc' => 'do not remove files, only register the packages as not installed',
                     ),
+                'installroot' => array(
+                    'shortopt' => 'R',
+                    'arg' => 'DIR',
+                    'doc' => 'root directory used when installing files (ala PHP\'s INSTALL_ROOT)',
+                    ),
                 ),
             'doc' => '<package> ...
 Uninstalls one or more PEAR packages.  More than one package may be