Subversion 2


Description
Create a directory with a name given by the final component of the PATH or URL. A directory specified by a working copy PATH is scheduled for addition in the working copy....
Alternate Names
None...
Changes
Working copy, repository if operating on a URL...
Accesses Repository
Only if operating on a URL...
Switches
--message (-m) TEXT --file (-F) FILE --quiet (-q) --username USER --password PASS --no-auth-cache --non-interactive --editor-cmd EDITOR --encoding ENC --force-log --config-dir DIR...
Examples
Create a directory in your working copy:$ svn mkdir newdir A newdir Create one in the repository (instant commit, so a log message is required):$ svn mkdir -m "Making a new dir.&quo...

svn move Move a file or directory....
Synopsis
svn move SRC DST...
Description
This command moves a file or directory in your working copy or in the repository....

This command is equivalent to an svn copy followed by svn delete....

Subversion does not support moving between working copies and URLs. In addition, you can only move files within a single repositorySubversion does not support cross-repositor...
Alternate Names
mv, rename, ren...
Changes
Working copy, repository if operating on a URL...
Accesses Repository
Only if operating on a URL...
Switches
--message (-m) TEXT --file (-F) FILE --revision (-r) REV --quiet (-q) --force --username USER --password PASS --no-auth-cache --non-interactive --editor-cmd EDITOR --encoding ENC --force-log --con...
Examples
Move a file in your working copy:$ svn move foo.c bar.c A bar.c D foo.c Move a file in the repository (an immediate commit, so it requires a commit message):$ svn move -m "Move...

svn propdel Remove a property from an item....
Synopsis
svn propdel PROPNAME [PATH...]svn propdel PROPNAME --revprop -r REV [URL]...
Description
This removes properties from files, directories, or revisions. The first form removes versioned properties in your working copy, while the second removes unversioned remote prope...
Alternate Names
pdel, pd...
Changes
Working copy, repository only if operating on a URL...
Accesses Repository
Only if operating on a URL...
Switches
--quiet (-q) --recursive (-R) --revision (-r) REV --revprop --username USER --password PASS --no-auth-cache --non-interactive --config-dir DIR...
Examples
Delete a property from a file in your working copy$ svn propdel svn:mime-type some-script property 'svn:mime-type' deleted from 'some-script'. Delete a revision property:$ svn propdel --revp...

svn propedit Edit the property of one or more items under version control....
Synopsis
svn propedit PROPNAME PATH...svn propedit PROPNAME --revprop -r REV [URL]...
Description
Edit one or more properties using your favorite editor. The first form edits versioned properties in your working copy, while the second edits unversioned remote properties on a...
Alternate Names
pedit, pe...
Changes
Working copy, repository only if operating on a URL...
Accesses Repository
Only if operating on a URL...
Switches
--revision (-r) REV --revprop --username USER --password PASS --no-auth-cache --non-interactive --encoding ENC --editor-cmd EDITOR --config-dir DIR...
Examples
svn propedit makes it easy to modify properties that have multiple values:$ svn propedit svn:keywords foo.c <svn will launch your favorite editor here, with a buffer open containing t...

svn propget Print the value of a property....
Synopsis
svn propget PROPNAME [TARGET[@REV]...]svn propget PROPNAME --revprop -r REV [URL]...
Description
Print the value of a property on files, directories, or revisions. The first form prints the versioned property of an item or items in your working copy, while the second prints...
Alternate Names
pget, pg...
Changes
Working copy, repository only if operating on a URL...
Accesses Repository
Only if operating on a URL...
Switches
--recursive (-R) --revision (-r) REV --revprop --strict --username USER --password PASS --no-auth-cache --non-interactive --config-dir DIR...
Examples
Examine a property of a file in your working copy:$ svn propget svn:keywords foo.c Author Date Rev The same goes for a revision property:$ svn propget svn:log --revprop -r 20 Began journal....

svn proplist List all properties....
Synopsis
svn proplist [TARGET[@REV]...]svn proplist --revprop -r REV [URL]...
Description
List all properties on files, directories, or revisions. The first form lists versioned properties in your working copy, while the second lists unversioned remote properties on a...
Alternate Names
plist, pl...
Changes
Working copy, repository only if operating on a URL...
Accesses Repository
Only if operating on a URL...
Switches
--verbose (-v) --recursive (-R) --revision (-r) REV --quiet (-q) --revprop --username USER --password PASS --no-auth-cache --non-interactive --config-dir DIR...
Examples
You can use proplist to see the properties on an item in your working copy:$ svn proplist foo.c Properties on 'foo.c': svn:mime-type svn:keywords owner But with the --verbose flag, svn...

svn propset Set PROPNAME to PROPVAL on files, directories, or revisions....
Synopsis
svn propset PROPNAME [PROPVAL | -F VALFILE] PATH...svn propset PROPNAME --revprop -r REV [PROPVAL | -F VALFILE] [URL]...
Description
Set PROPNAME to PROPVAL on files, directories, or revisions. The first example creates a versioned, local property change in the working copy, and the second creates an unv...

Subversion has a number of special properties that affect its behavior. See for more on these properties....
Alternate Names
pset, ps...
Changes
Working copy, repository only if operating on a URL...
Accesses Repository
Only if operating on a URL...
Switches
--file (-F) FILE --quiet (-q) --revision (-r) REV --targets FILENAME --recursive (-R) --revprop --username USER --password PASS --no-auth-cache --non-interactive --encoding ENC --force --config-di...
Examples
Set the mimetype on a file:$ svn propset svn:mime-type image/jpeg foo.jpg property 'svn:mime-type' set on 'foo.jpg' On a UNIX system, if you want a file to have the executable permission set...

By default, you cannot modify revision properties in a Subversion repository. Your repository administrator must explicitly enable revision property modifications by creating...

svn resolved Remove conflicted state on working copy files or directories....
Synopsis
svn resolved PATH......
Description
Remove conflicted state on working copy files or directories. This routine does not semantically resolve conflict markers; it merely removes conflict-related artifact files and...
Alternate Names
None...
Changes
Working copy...
Accesses Repository
No...
Switches
--targets FILENAME --recursive (-R) --quiet (-q) --config-dir DIR...
Examples
If you get a conflict on an update, your working copy will sprout three new files:$ svn update C foo.c Updated to revision 31. $ ls foo.c foo.c.mine foo.c.r30 foo.c.r31 Once you've resolved...

You can just remove the conflict files and commit, but svn resolved fixes up some bookkeeping data in the working copy administrative area in addition to removing the c...

svn revert Undo all local edits....
Synopsis
svn revert PATH......
Description
Reverts any local changes to a file or directory and resolves any conflicted states. svn revert will not only revert the contents of an item in your working copy, but also any pr...
Alternate Names
None...
Changes
Working copy...
Accesses Repository
No...
Switches
--targets FILENAME --recursive (-R) --quiet (-q) --config-dir DIR...
Examples
Discard changes to a file:$ svn revert foo.c Reverted foo.c If you want to revert a whole directory of files, use the --recursive flag:$ svn revert --recursive . Reverted newdir/afile Revert...

If you provide no targets to svn revert, it will do nothingto protect you from accidentally losing changes in your working copy, svn revert requires you to provide at...

svn status Print the status of working copy files and directories....
Synopsis
svn status [PATH...]...
Description
Print the status of working copy files and directories. With no arguments, it prints only locally modified items (no repository access). With --show-updates, add working revision...
Alternate Names
stat, st...
Changes
Nothing...
Accesses Repository
Only if using --show-updates...
Switches
--show-updates (-u) --verbose (-v) --non-recursive (-N) --quiet (-q) --no-ignore --username USER --password PASS --no-auth-cache --non-interactive --config-dir --ignore-externals...
Examples
This is the easiest way to find out what changes you have made to your working copy:$ svn status wc M wc/bar.c A + wc/qax.c If you want to find out what files in your working copy a...

--show-updates only places an asterisk next to items that are out of date (that is, items that will be updated from the repository if you run svn update). --show-updates...

svn switch Update working copy to a different URL....
Synopsis
svn switch URL [PATH]switch --relocate FROM TO [PATH...]...
Description
This subcommand updates your working copy to mirror a new URLusually a URL which shares a common ancestor with your working copy, although not necessarily. This is the Subversio...
Alternate Names
sw...
Changes
Working copy...
Accesses Repository
Yes...
Switches
--revision (-r) REV --non-recursive (-N) --quiet (-q) --diff3-cmd CMD --relocate --username USER --password PASS --no-auth-cache --non-interactive --config-dir DIR...
Examples
If you're currently inside the directory vendors which was branched to vendors-with-fix and you'd like to switch your working copy to that branch:$ svn switch http://svn.red-bean...

You can just switch part of your working copy to a branch if you don't want to switch your entire working copy.Sometimes an administrator might change the base location of yo...

Be careful when using the --relocate option. If you mistype the argument, you might end up creating nonsensical URLs within your working copy that render the whole workspace...

svn unlock Unlock working copy paths or URLs....
Synopsis
svn unlock TARGET......
Description
Unlock each TARGET. If any TARGET is either locked by another user or no valid lock token exists in the working copy, print a warning and continue unlocking the rest of the...
Alternate Names
None...
Changes
Working Copy, Repository...
Accesses Repository
Yes...
Switches
--targets ARG --username ARG --password ARG --no-auth-cache --non-interactive --config-dir ARG --force...
Examples
Unlock two files in your working copy: $ svn unlock tree.jpg house.jpg 'tree.jpg' unlocked. 'house.jpg' unlocked. Unlock a file in your working copy that is currently locked by another user:...

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 given, it brings your working copy up-to-date with the HEAD revision. Otherwise, it syn...
Alternate Names
up...
Changes
Working copy...
Accesses Repository
Yes...
Switches
--revision (-r) REV --non-recursive (-N) --quiet (-q) --diff3-cmd CMD --username USER --password PASS --no-auth-cache --non-interactive --config-dir DIR --ignore-externals...
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...

If you want to examine an older revision of a single file, you may want to use svn cat.. .svn unlocksvnadmin...

svnadmin create Create a new, empty repository....
Synopsis
svnadmin create REPOS_PATH...
Description
Create a new, empty repository at the path provided. If the provided directory does not exist, it will be created for you.[55] As of Subversion 1.2, svnadmin creates new...
Switches
--bdb-txn-nosync --bdb-log-keep --config-dir DIR --fs-type TYPE...
Examples
Creating a new repository is just this easy:$ svnadmin create /usr/local/svn/repos In Subversion 1.0, a Berkeley DB repository is always created. In Subversion 1.1, a Berkeley DB repository...

svnadmin deltify Deltify changed paths in a revision range....
Synopsis
svnadmin deltify [-r LOWER[:UPPER]] REPOS_PATH...
Description
svnadmin deltify only exists in 1.0.x due to historical reasons. This command is deprecated and no longer needed.It dates from a time when Subversion offered administrators great...
Switches
--revision (-r) --quiet . .svnadmin createsvnadmin dump...

svnadmin dump Dump the contents of filesystem to stdout....
Synopsis
svnadmin dump REPOS_PATH [-r LOWER[:UPPER]] [--incremental]...
Description
Dump the contents of filesystem to stdout in a dumpfile portable format, sending feedback to stderr. Dump revisions LOWER rev through UPPER rev. If no revisions are...
Switches
--revision (-r) --incremental --quiet --deltas...
Examples
Dump your whole repository:$ svnadmin dump /usr/local/svn/repos SVN-fs-dump-format-version: 1 Revision-number: 0 * Dumped revision 0. Prop-content-length: 56 Content-length: 56 Incrementally dum...

svnadmin help...
Synopsis
svnadmin help [SUBCOMMAND...]...
Description
This subcommand is useful when you're trapped on a desert island with neither a net connection nor a copy of this book....
Alternate Names
?, h. .svnadmin dumpsvnadmin hotcopy...

svnadmin hotcopy Make a hot copy of a repository....
Synopsis
svnadmin hotcopy REPOS_PATH NEW_REPOS_PATH...
Description
This subcommand makes a full hot backup of your repository, including all hooks, configuration files, and, of course, database files. If you pass the --clean-logs switch,...
Switches
--clean-logs . .svnadmin helpsvnadmin list-dblogs...

svnadmin list-dblogs Ask Berkeley DB which log files exist for a given Subversion repository (applies only to repositories using the bdb backend)....
Synopsis
svnadmin list-dblogs REPOS_PATH...
Description
Berkeley DB creates logs of all changes to the repository, which allow it to recover in the face of catastrophe. Unless you enable DB_LOG_AUTOREMOVE, the log files accumula...

svnadmin list-unused-dblogs Ask Berkeley DB which log files can be safely deleted (applies only to repositories using the bdb backend)....
Synopsis
svnadmin list-unused-dblogs REPOS_PATH...
Description
Berkeley DB creates logs of all changes to the repository, which allow it to recover in the face of catastrophe. Unless you enable DB_LOG_AUTOREMOVE, the log files accumula...
Examples
Remove all unused log files from a repository:$ svnadmin list-unused-dblogs /path/to/repos /path/to/repos/log.0000000031 /path/to/repos/log.0000000032 /path/to/repos/log.0000000033 $ svnadmin list...

svnadmin load Read a dumpfile-formatted stream from stdin....
Synopsis
svnadmin load REPOS_PATH...
Description
Read a dumpfile-formatted stream from stdin, committing new revisions into the repository's filesystem. Send progress feedback to stdout....
Switches
--quiet (-q) --ignore-uuid --force-uuid --use-pre-commit-hook --use-post-commit-hook --parent-dir...
Example
This shows the beginning of loading a repository from a backup file (made, of course, with svnadmin dump):$ svnadmin load /usr/local/svn/restored < repos-backup <<< Started...

svnadmin lslocks Print descriptions of all locks....
Synopsis
svnadmin lslocks REPOS_PATH...
Description
Print descriptions of all locks in a repository....
Switches
None...
- - | 1 2 3 4 | - -


- -