<?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 update (up)</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.c.unlock.html" title="svn unlock" />
<link rel="next" href="svn.ref.svn.c.upgrade.html" title="svn upgrade" />
</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 update (up)</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.svn.c.unlock.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.upgrade.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="svn update (up)">
<a id="svn.ref.svn.c.update"></a>
<div class="titlepage"></div>
<a id="idp21255712" class="indexterm"></a>
<div class="refnamediv">
<h2>Name</h2>
<p>svn update (up) — Update your working copy.</p>
</div>
<div class="refsynopsisdiv" title="Synopsis">
<h2>Synopsis</h2>
<p>
<code class="literal">svn update [PATH...]</code>
</p>
</div>
<div class="refsect1" title="Description">
<a id="idp21260352"></a>
<h2>Description</h2>
<p><span class="command"><strong>svn update</strong></span> brings changes from the
repository into your working copy. If no revision is
given, it brings your working copy up to date with the
<code class="literal">HEAD</code> revision. Otherwise, it
synchronizes the working copy to the revision given by the
<code class="option">--revision</code> (<code class="option">-r</code>) option.
As part of the synchronization, <span class="command"><strong>svn
update</strong></span> also removes any stale locks (see
<a class="xref" href="svn.tour.cleanup.html" title="Sometimes You Just Need to Clean Up">the section called “Sometimes You Just Need to Clean Up”</a>) found in the working
copy.</p>
<p>For each updated item, it prints a line that starts
with a character reporting the action taken. These
characters have the following meaning:</p>
<div class="variablelist">
<dl>
<dt>
<span class="term">
<code class="literal">A</code>
</span>
</dt>
<dd>
<p>Added</p>
</dd>
<dt>
<span class="term">
<code class="literal">B</code>
</span>
</dt>
<dd>
<p>Broken lock (third column only)</p>
</dd>
<dt>
<span class="term">
<code class="literal">D</code>
</span>
</dt>
<dd>
<p>Deleted</p>
</dd>
<dt>
<span class="term">
<code class="literal">U</code>
</span>
</dt>
<dd>
<p>Updated</p>
</dd>
<dt>
<span class="term">
<code class="literal">C</code>
</span>
</dt>
<dd>
<p>Conflicted</p>
</dd>
<dt>
<span class="term">
<code class="literal">G</code>
</span>
</dt>
<dd>
<p>Merged</p>
</dd>
<dt>
<span class="term">
<code class="literal">E</code>
</span>
</dt>
<dd>
<p>Existed</p>
</dd>
</dl>
</div>
<p>A character in the first column signifies an update to
the actual file, whereas updates to the file's properties
are shown in the second column. Lock information is
printed in the third column.</p>
<p>As with most subcommands, you can limit the scope of
the update operation to a particular tree depth using the
<code class="option">--depth</code> option. Alternatively, you can
use the <code class="option">--set-depth</code> option to set a new
<span class="quote">“<span class="quote">sticky</span>”</span> working copy depth on the update
target.</p>
</div>
<div class="refsect1" title="Options">
<a id="idp21283056"></a>
<h2>Options</h2>
<div class="informalexample">
<pre class="screen">
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.accept"><code class="option">--accept</code> <em class="replaceable"><code>ACTION</code></em></a>
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.changelist"><code class="option">--changelist</code> (<code class="option">--cl</code>) <em class="replaceable"><code>ARG</code></em></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.diff3_cmd"><code class="option">--diff3-cmd</code> <em class="replaceable"><code>CMD</code></em></a>
<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.force"><code class="option">--force</code></a>
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.ignore_externals"><code class="option">--ignore-externals</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.revision"><code class="option">--revision</code> (<code class="option">-r</code>) <em class="replaceable"><code>REV</code></em></a>
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.set_depth"><code class="option">--set-depth</code> <em class="replaceable"><code>ARG</code></em></a>
</pre>
</div>
</div>
<div class="refsect1" title="Examples">
<a id="idp21292512"></a>
<h2>Examples</h2>
<p>Pick up repository changes that have happened since
your last update:</p>
<div class="informalexample">
<pre class="screen">
$ svn update
Updating '.':
A newdir/toggle.c
A newdir/disclose.c
A newdir/launch.c
D newdir/README
Updated to revision 32.
</pre>
</div>
<p>You can also <span class="quote">“<span class="quote">update</span>”</span> your working copy
to an older revision (Subversion doesn't have the concept
of <span class="quote">“<span class="quote">sticky</span>”</span> files like CVS does; see <a class="xref" href="svn.forcvs.html" title="Appendix B. Subversion for CVS Users">Appendix B, <em>Subversion for CVS Users</em></a>):</p>
<div class="informalexample">
<pre class="screen">
$ svn update -r30
Updating '.':
A newdir/README
D newdir/toggle.c
D newdir/disclose.c
D newdir/launch.c
U foo.c
Updated to revision 30.
</pre>
</div>
<div class="tip" title="Tip" style="margin-left: 0.5in; margin-right: 0.5in;">
<table border="0" summary="Tip">
<tr>
<td rowspan="2" align="center" valign="top" width="25">
<img alt="[Tip]" src="images/tip.png" />
</td>
<th align="left">Tip</th>
</tr>
<tr>
<td align="left" valign="top">
<p>If you want to examine an older revision of a
single file, you may want to use <span class="command"><strong>svn
cat</strong></span> instead—it won't change your working
copy.</p>
</td>
</tr>
</table>
</div>
<p><span class="command"><strong>svn update</strong></span> is also the primary
mechanism used to configure sparse working copies. When
used with the <code class="option">--set-depth</code>, the update
operation will omit or reenlist individual working copy
members by modifying their recorded ambient depth to the
depth you specify (fetching information from the
repository as necessary). See
<a class="xref" href="svn.advanced.sparsedirs.html" title="Sparse Directories">the section called “Sparse Directories”</a> for more about
sparse directories.</p>
<p>You can update multiple targets with a single
invocation, and Subversion will not only gracefully skip
any unversioned targets you provide it, but as of
Subversion 1.7 will also include a post-update summary of
all the updates it performed:</p>
<div class="informalexample">
<pre class="screen">
$ cd my-projects
$ svn update *
Updating 'calc':
U button.c
U integer.c
Updated to revision 394.
Skipped 'tempfile.tmp'
Updating 'paint':
A palettes.c
U brushes.c
Updated to revision 60.
Updating 'ziptastic':
At revision 43.
Summary of updates:
Updated 'calc' to r394.
Updated 'paint' to r60.
Updated 'ziptastic' to r43.
Summary of conflicts:
Skipped paths: 1
$
</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.c.unlock.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.upgrade.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">svn unlock </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> svn upgrade</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
>
138
