What's a simple way to undelete a file in subversion?

These instructions are a little intimidating and confusing: <http://svnbook.red-bean.com/en/1.0/ch04s04.html#svn-ch-4-sect-4.3> . And also they don't seem to mention that it's much simpler if you haven't yet checked in after doing the "svn rm" [1].

So I thought this would be a good place to record a simpler answer for those googling for this.

[1] To an svn newbie, it might appear that "svn rm" immediately destroys the file. I recall doing svn rm thinking that would just remove it from source control and freaking out when the file itself actually disappeared. So a sub-question is, what's the right way to remove a file from version control without actually removing your local copy?

If you just did

svn rm foo.txt

then you can undo that with simply

svn revert foo.txt

If you already checked in after doing the "svn rm" then you can look at the log (svn log), find the last revision where the file existed, and grab it from that version.

One way to do that is to merge in the old revision that has the file. Assuming the current revision is 123 and the last version with that file is 120, then do this:

svn merge -r123:120

Maybe first do a dry run to make sure it won't do anything you don't want:

svn --dry-run merge -r123:120

---

For the sub-question, how to remove a file from svn without removing the local copy:

svn rm foo.txt --keep-local

Or, of course, you could just copy to a temp file before svn rm'ing and then copy back:

cp foo.txt foo.txt-tmp
svn rm foo.txt
(svn ci -m "just removed foo.txt from the repository")
cp foo.txt-tmp foo.txt

for whatever reason, the -r arg wasn't working for me (svn version 1.6.9). I tried before and after the src, but kept getting a message that the file was not found in the current revision (duh). Same with --revision. Using the @ style syntax worked though:

svn cp url/to/removed/foo.txt@4 foo.txt

To remove a file but keep it in the working copy, use

svn rm foo.txt --keep-local

To get a file back after you've committed the remove, you can use either the merge command, or the copy command - both will preserve the file history. Since the merge way is already described elsewhere, here's the copy way:

svn rm foo.txt
svn ci foo.txt -m "removed file"
(now at r5 as an example)
svn cp url/to/removed/foo.txt -r4 foo.txt
svn ci foo.txt -m "got file back"

For TortoiseSVN users, this is very easily accomplished via the Repo Browser. Within the Repo Browser switch to the revision before the file was deleted (you can change the version using the "Revision:" button at the top right):

You should then be able to see the deleted file in its original location in the Repo Browser. Right-click on it and choose "Copy to working copy...":

The file will then be restored to your working copy ready to commit (as though svn added) and with its log history intact.

To revert a deleted file in SVN. Find the revision number just before delete (say 341). Then revert that file alone to that revision number.

svn up -r341 [path_to_deletedFile]

i used the copy menu item from the previous revision using tortoise, worked for me and kept the history.