## page was renamed from RemoteUpdate
== Remote Update ==

'''This extension is not distributed with Mercurial.'''

''Author: Ryan Seto''

Repository: http://bitbucket.org/MrWerewolf/rupdate

''TortoiseHg supports this extension in version 2.1 or better.''

=== Overview ===

Remote Update is an extension for Mercurial (Hg) that adds the ability to
update a remote repository's working directory to a specified revision
if the remote repository is hosted via ssh.

This can help simplify the process for maintaining a website that is a
Mercurial repository with it's own working directory.

=== Configuration ===

Configure your .hgrc or mercurial.ini to enable the extension by adding the
following lines:

{{{
[extensions]
rupdate = /path/to/rupdate
}}}

Note: Your `/path/to/rupdate` should be the path to the ''folder'' that you copied
the extension to.

=== Usage ===

{{{
hg rupdate [OPTIONS] [-d DEST] REV
}}}

To update the ''default'' remote repository to revision e9e4e6afc30a:

To update the default remote repository to revision 11.

{{{
hg rupdate e9e4e6afc30a
}}}

==== Options ====

`-p`, `--push`
  Performs a push to the remote repository before updating it. If you have not setup passwordless authentication you will be asked for a password more than once.

`-f`, `--force`
  This will perform the equivalent of `hg push --force` when pushing.  This only has an effect if the `--push` option is used.

`--new-branch`
  This will perform the equivalent of `hg push --new-branch`, allowing new branchs to be pushed.  This only has an effect if the `--push` option is used.

`-C`, `--clean`
  Discards uncommited remote changes (no backup). This is equivalent to running `hg update --clean` on the remote location.

`-d` ''DEST'', `--dest` ''DEST''
  Specifies the remote location to update. This can be an alias or a full `ssh://` path.

`-r` ''REV'', `--rev` ''REV'', ''REV''
  Secifies the revision to update to on the remote location. You can use the same format that you would with `hg update REV`.  This means ''REV'' can be a branch name or a tag name.

  '''Note:''' ''It is dangerous to use the revision number. To update a specific revision, use unique identifier (hash code).''


----
CategoryExtensionsByOthers