<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>svn delete (del, remove, rm)</title>
<link rel="stylesheet" type="text/css" href="styles.css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1" />
<style type="text/css">
body { background-image: url('images/draft.png');
background-repeat: no-repeat;
background-position: top left;
/* The following properties make the watermark "fixed" on the page. */
/* I think that's just a bit too distracting for the reader... */
/* background-attachment: fixed; */
/* background-position: center center; */
}</style>
<link rel="home" href="index.html" title="Version Control with Subversion [DRAFT]" />
<link rel="up" href="svn.ref.svn.html" title="svn Reference—Subversion Command-Line Client" />
<link rel="prev" href="svn.ref.svn.c.copy.html" title="svn copy (cp)" />
<link rel="next" href="svn.ref.svn.c.diff.html" title="svn diff (di)" />
</head>
<body>
<div xmlns="" id="vcws-version-notice">
<p>This text is a work in progress—highly subject to
change—and may not accurately describe any released
version of the Apache™ Subversion® software.
Bookmarking or otherwise referring others to this page is
probably not such a smart idea. Please visit
<a href="http://www.svnbook.com/">http://www.svnbook.com/</a>
for stable versions of this book.</p>
</div>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">svn delete (del, remove, rm)</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.svn.c.copy.html">Prev</a> </td>
<th width="60%" align="center">svn Reference—Subversion Command-Line Client</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.ref.svn.c.diff.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry">
<a id="svn.ref.svn.c.delete"></a>
<div class="titlepage"></div>
<a id="idm11385" class="indexterm"></a>
<div class="refnamediv">
<h2>Name</h2>
<p>svn delete (del, remove, rm) — Delete an item from a working copy
or the repository.</p>
</div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<p>
<code class="literal">svn delete PATH...</code>
</p>
<p>
<code class="literal">svn delete URL...</code>
</p>
</div>
<div class="refsect1">
<a id="idm11397"></a>
<h2>Description</h2>
<p>Items specified by <em class="replaceable"><code>PATH</code></em> are
scheduled for deletion upon the next commit. Files (and
directories that have not been committed) are immediately
removed from the working copy unless the
<code class="option">--keep-local</code> option is given. The
command will not remove any unversioned or modified items;
use the <code class="option">--force</code> option to override this
behavior.</p>
<p>Items specified by URL are deleted from
the repository via an immediate commit. Multiple URLs are
committed atomically.</p>
</div>
<div class="refsect1">
<a id="idm11404"></a>
<h2>Options</h2>
<div class="informalexample">
<pre class="screen">
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.editor_cmd"><code class="option">--editor-cmd</code> <em class="replaceable"><code>CMD</code></em></a>
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.encoding"><code class="option">--encoding</code> <em class="replaceable"><code>ENC</code></em></a>
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.file"><code class="option">--file</code> (<code class="option">-F</code>) <em class="replaceable"><code>FILENAME</code></em></a>
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.force"><code class="option">--force</code></a>
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.force_log"><code class="option">--force-log</code></a>
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.keep_local"><code class="option">--keep-local</code></a>
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.message"><code class="option">--message</code> (<code class="option">-m</code>) <em class="replaceable"><code>MESSAGE</code></em></a>
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.quiet"><code class="option">--quiet</code> (<code class="option">-q</code>)</a>
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.targets"><code class="option">--targets</code> <em class="replaceable"><code>FILENAME</code></em></a>
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.with_revprop"><code class="option">--with-revprop</code> <em class="replaceable"><code>ARG</code></em></a>
</pre>
</div>
</div>
<div class="refsect1">
<a id="idm11418"></a>
<h2>Examples</h2>
<p>Using <span class="command"><strong>svn</strong></span> to delete a file from
your working copy deletes your local copy of the file, but
it merely schedules the file to be deleted from the
repository. When you commit, the file is deleted in the
repository.</p>
<div class="informalexample">
<pre class="screen">
$ svn delete myfile
D myfile
$ svn commit -m "Deleted file 'myfile'."
Deleting myfile
Transmitting file data .
Committed revision 14.
</pre>
</div>
<p>Deleting a URL, however, is immediate, so you have
to supply a log message:</p>
<div class="informalexample">
<pre class="screen">
$ svn delete -m "Deleting file 'yourfile'" \
file:///var/svn/repos/test/yourfile
Committed revision 15.
</pre>
</div>
<p>Here's an example of how to force deletion of a file
that has local mods:</p>
<div class="informalexample">
<pre class="screen">
$ svn delete over-there
svn: E195006: Use --force to override this restriction (local modifications m\
ay be lost)
svn: E195006: '/home/sally/project/over-there' has local modifications -- com\
mit or revert them first
$ svn delete --force over-there
D over-there
$
</pre>
</div>
<p>Use the <code class="option">--keep-local</code> option to
override the default <span class="command"><strong>svn delete</strong></span>
behavior of also removing the target file that was
scheduled for versioned deletion. This is helpful when
you realize that you've accidentally committed the
addition of a file that you need to keep around in your
working copy, but which shouldn't have been added to
version control.</p>
<div class="informalexample">
<pre class="screen">
$ svn delete --keep-local conf/program.conf
D conf/program.conf
$ svn commit -m "Remove accidentally-added configuration file."
Deleting conf/program.conf
Transmitting file data .
Committed revision 21.
$ svn status
? conf/program.conf
$
</pre>
</div>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25">
<img alt="[Note]" src="images/note.png" />
</td>
<th align="left">Note</th>
</tr>
<tr>
<td align="left" valign="top">
<p>The behavior of the <code class="option">--keep-local</code>
option does not propagate to other working copies which
contain the items you've scheduled for deletion. If you
commit the deletion of those items they will remain in
your working copy, but they will be deleted from other
working copies which contain them when those working
copies are then updated.</p>
</td>
</tr>
</table>
</div>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="svn.ref.svn.c.copy.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.ref.svn.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.ref.svn.c.diff.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">svn copy (cp) </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> svn diff (di)</td>
</tr>
</table>
</div>
<div xmlns="" id="vcws-footer">
<hr />
<img src="images/cc-by.png" style="float: right;" />
<p>You are reading <em>Version Control with Subversion</em> (for
Subversion 1.8), by Ben Collins-Sussman, Brian W. Fitzpatrick,
and C. Michael Pilato.</p>
<p>This work is licensed under
the <a href="http://creativecommons.org/licenses/by/2.0/">Creative Commons Attribution License v2.0</a>.</p>
<p>To submit comments, corrections, or other contributions to the
text, please visit <a href="http://www.svnbook.com/">http://www.svnbook.com/</a>.</p>
</div>
</body>
</html>
distrib
>
Mageia
>
6
>
x86_64
>
media
>
core-updates
>
by-pkgid
>
31498a559ceee64333612647bef4b546
>
files
>
116
