<?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 add</title>
<link rel="stylesheet" type="text/css" href="styles.css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.76.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.html" title="svn Reference—Subversion Command-Line Client" />
<link rel="next" href="svn.ref.svn.c.blame.html" title="svn blame (praise, annotate, ann)" />
</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 add</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.svn.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.blame.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="svn add">
<a id="svn.ref.svn.c.add"></a>
<div class="titlepage"></div>
<a id="idp20011088" class="indexterm"></a>
<div class="refnamediv">
<h2>Name</h2>
<p>svn add — Add files, directories, or symbolic links.</p>
</div>
<div class="refsynopsisdiv" title="Synopsis">
<h2>Synopsis</h2>
<p>
<code class="literal">svn add PATH...</code>
</p>
</div>
<div class="refsect1" title="Description">
<a id="idp20015712"></a>
<h2>Description</h2>
<p>Schedule files, directories, or symbolic links in your
working copy for addition to the repository. They will be
uploaded and added to the repository on your next commit.
If you add something and change your mind before
committing, you can unschedule the addition using
<span class="command"><strong>svn revert</strong></span>.</p>
</div>
<div class="refsect1" title="Options">
<a id="idp20018272"></a>
<h2>Options</h2>
<div class="informalexample">
<pre class="screen">
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.auto_props"><code class="option">--auto-props</code></a>
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.depth"><code class="option">--depth</code> <em class="replaceable"><code>ARG</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.no_auto_props"><code class="option">--no-auto-props</code></a>
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.no_ignore"><code class="option">--no-ignore</code></a>
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.parents"><code class="option">--parents</code></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>
</pre>
</div>
</div>
<div class="refsect1" title="Examples">
<a id="idp20026336"></a>
<h2>Examples</h2>
<p>To add a file to your working copy:</p>
<div class="informalexample">
<pre class="screen">
$ svn add foo.c
A foo.c
</pre>
</div>
<p>When adding a directory, the default behavior of
<span class="command"><strong>svn add</strong></span> is to recurse:</p>
<div class="informalexample">
<pre class="screen">
$ svn add testdir
A testdir
A testdir/a
A testdir/b
A testdir/c
A testdir/d
</pre>
</div>
<p>You can add a directory without adding its
contents:</p>
<div class="informalexample">
<pre class="screen">
$ svn add --depth=empty otherdir
A otherdir
</pre>
</div>
<p>Attempts to schedule the addition of an item which is
already versioned will fail by default. This behavior
foils the most common scenario under which users attempt
this: when trying to get to Subversion to recursively
examine a versioned directory and add any unversioned
items inside of it. To override the default behavior and
force Subversion to recurse into already-versioned
directories, pass the <code class="option">--force</code>
option:</p>
<div class="informalexample">
<pre class="screen">
$ svn add versioned-dir
svn: warning: W150002: '/home/cmpilato/projects/subversion/site' is already un\
der version control
$ svn add versioned-dir --force
A versioned-dir/foo.c
A versioned-dir/somedir/bar.c
A (bin) versioned-dir/otherdir/docs/baz.doc
…
</pre>
</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.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.blame.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">svn Reference—Subversion Command-Line Client </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> svn blame (praise, annotate, ann)</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
>
e8fe8188cee5592550f08a19b470186d
>
files
>
104
