Unix in a Nutshell, 4th Edition

Name

copy

Synopsis

svn copy src dst

Copy a file in a working copy or in the repository. src and dst can each be either a working copy (WC) path or a URL:

WC → WC

Copy and schedule an item for addition (with history).

WC → URL

Immediately commit a copy of WC to URL.

URL → WC

Check out URL into WC, and schedule it for addition.

URL → URL

Complete server-side copy. This is usually used to branch and tag.

Tip

You can only copy files within a single repository. Subversion does not support cross-repository copying.

Alternate Names:	cp
Changes:	Repository if destination is a URL
	Working copy if destination is a WC path
Accesses Repository:	If source or destination is in the repository, or if needed to look up the source revision number

Options

--config-dir dir	--no-auth-cache
--editor-cmd editor	--non-interactive
--encoding enc	--password pass
--filefile, -Ffile	--quiet (-q)
--force-log	--revisionrev, -rrev
--messagetext, -mtext	--username user

Examples

Copy an item within your working copy (just schedule the copy—nothing goes into the repository until you commit):

    $ svn 
 copy foo.txt bar.txt
    A         bar.txt
    $ svn status
    A  +   bar.txt

Copy an item from the repository to your working copy (just schedule the copy—nothing goes into the repository until you commit):

    $ svn copy file:///tmp/repos/test/far-away near-here
    A         near-here

Tip

This is the recommended way to resurrect a dead file in your repository!

And finally, copying between two URLs:

    $ svn copy file:///tmp/repos/test/far-away ...