svn update
Prev | svn Subcommands | Next

## Name

svn update — Update your working copy.

## Synopsis

    svn update [PATH...]

## Description

svn update brings changes from the repository into your working copy. If no revision is given, it brings your working copy up to date with the `HEAD` revision. Otherwise, it synchronizes the working copy to the revision given by the `--revision` option. As part of the synchronization, svn update also removes any stale locks (see the section called “Sometimes You Just Need to Clean Up”) found in the working copy.

For each updated item, it prints a line that starts with a character reporting the action taken. These characters have the following meaning:

`A`

  Added

`B`

  Broken lock (third column only)

`D`

  Deleted

`U`

  Updated

`C`

  Conflicted

`G`

  Merged

`E`

  Existed

A character in the first column signifies an update to the actual file, whereas updates to the file's properties are shown in the second column. Lock information is printed in the third column.

As with most subcommands, you can limit the scope of the update operation to a particular tree depth using the `--depth` option. Alternatively, you can use the `--set-depth` option to set a new “sticky” working copy depth on the update target. Currently, the depth of a working copy directory can only be increased (telescoped more deeply); you cannot make a directory more shallow.

## Alternate names

up

## Changes

Working copy

## Accesses repository

Yes

## Options

    --accept ARG
    --changelist
    --depth ARG
    --diff3-cmd CMD
    --editor-cmd ARG
    --force
    --ignore-externals
    --quiet (-q)
    --revision (-r) REV
    --set-depth ARG

## Examples

Pick up repository changes that have happened since your last update:

    $ svn update
    A  newdir/toggle.c
    A  newdir/disclose.c
    A  newdir/launch.c
    D  newdir/README
    Updated to revision 32.

You can also “update” your working copy to an older revision (Subversion doesn't have the concept of “sticky” files like CVS does; see Appendix B, Subversion for CVS Users):

    $ svn update -r30
    A  newdir/README
    D  newdir/toggle.c
    D  newdir/disclose.c
    D  newdir/launch.c
    U  foo.c
    Updated to revision 30.

### Tip

If you want to examine an older revision of a single file, you may want to use svn cat instead—it won't change your working copy.

Prev | Up | Next
svn unlock | Home | svnadmin