Class: VersionControl_SVN_Update

VersionControl_SVN
   |
   --VersionControl_SVN_Update

[line 149]
Subversion Update command manager class

Bring changes from the repository into the working copy.

From 'svn update --help':

usage: update [PATH...]

If no revision given, bring working copy up-to-date with HEAD rev. Else synchronize working copy to revision given by -r.

For each updated item a line will start with a character reporting the action taken. These characters have the following meaning:

A Added D Deleted U Updated C Conflict G Merged

A character in the first column signifies an update to the actual file, while updates to the file's properties are shown in the second column.

Conversion of the above usage example to VersionControl_SVN_Switch:

 <?php

 require_once 'VersionControl/SVN.php';
 
 // Setup error handling -- always a good idea!
 $svnstack = &PEAR_ErrorStack::singleton('VersionControl_SVN');
 
 // Set up runtime options. Will be passed to all
 // subclasses.
 $options = array('fetchmode' => VERSIONCONTROL_SVN_FETCHMODE_RAW);
 
 $switches = array('r' => '30');
 $args = array('/path/to/working/copy');
 
 $svn = VersionControl_SVN::factory(array('update'), $options);
 print_r($svn->update->run($args));
 
 if (count($errs = $svnstack->getErrors())) {
     foreach ($errs as $err) {
         echo '<br />'.$err['message']."<br />\n";
         echo "Command used: " . $err['params']['cmd'];
     }
 }
 ?>

$switches is an array containing one or more command line options defined by the following associative keys:

 $switches = array(

  'r [revision]'  =>  'ARG (some commands also take ARG1:ARG2 range)
                        A revision argument can be one of:
                           NUMBER       revision number
                           "{" DATE "}" revision at start of the date
                           "HEAD"       latest in repository
                           "BASE"       base rev of item's working copy
                           "COMMITTED"  last commit at or before BASE
                           "PREV"       revision just before COMMITTED',
                      // either 'r' or 'revision' may be used
  'N'             =>  true|false,
                      // operate on single directory only
  'non-recursive' =>  true|false,
                      // operate on single directory only
  'q [quiet]'     =>  true|false,
                      // print as little as possible
  'diff3-cmd'     =>  'ARG',
                      // use ARG as merge command
  'username'      =>  'Subversion repository login',
  'password'      =>  'Subversion repository password',
  'no-auth-cache' =>  true|false,
                      // Do not cache authentication tokens
  'config-dir'    =>  'Path to a Subversion configuration directory
 );

Note: Subversion does not offer an XML output option for this subcommand

The non-interactive option available on the command-line svn client may also be set (true|false), but it is set to true by default.

$args = array()

[line 183]

Command-line arguments that should be passed outside of those specified in switches.

$min_args =  0

[line 192]

Minimum number of args required by this subcommand.

See Version Control with Subversion, Subversion Complete Reference for details on arguments for this subcommand.

$passthru =  false

[line 208]

Use exec or passthru to get results from command.

$required_switches = array()

[line 201]

Switches required by this subcommand.

See Version Control with Subversion, Subversion Complete Reference for details on arguments for this subcommand.

$valid_switches = array('r',
                                'revision',
                                'N',
                                'non-recursive',
                                'non_recursive',
                                'q',
                                'quiet',
                                'diff3-cmd',
                                'username',
                                'password',
                                'no-auth-cache',
                                'no_auth_cache',
                                'non-interactive',
                                'non_interactive',
                                'config-dir',
                                'config_dir'
                                )

[line 157]

Valid switches for svn update

parseOutput   [line 312]

---

parseOutputArray   [line 346]

---

prepare   [line 221]

---