<?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 upgrade</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.update.html" title="svn update (up)" />
<link rel="next" href="svn.ref.svnadmin.html" title="svnadmin Reference—Subversion Repository Administration" />
</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 upgrade</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.svn.c.update.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.svnadmin.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry">
<a id="svn.ref.svn.c.upgrade"></a>
<div class="titlepage"></div>
<a id="idm13337" class="indexterm"></a>
<div class="refnamediv">
<h2>Name</h2>
<p>svn upgrade — Upgrade the metadata storage format for a
working copy.</p>
</div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<p>
<code class="literal">svn upgrade [PATH...]</code>
</p>
</div>
<div class="refsect1">
<a id="idm13347"></a>
<h2>Description</h2>
<p>As new versions of Subversion are released, the format
used for the working copy metadata changes to accomodate
new features or fix bugs. Older versions of Subversion
would automatically upgrade working copies to the new
format the first time the working copy was used by the new
version of the software. Beginning with Subversion 1.7,
working copy upgrades must be explicitly performed at the
user's request. <span class="command"><strong>svn upgrade</strong></span> is the
subcommand used to trigger that upgrade process.</p>
</div>
<div class="refsect1">
<a id="idm13351"></a>
<h2>Options</h2>
<div class="informalexample">
<pre class="screen">
<a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.quiet"><code class="option">--quiet</code> (<code class="option">-q</code>)</a>
</pre>
</div>
</div>
<div class="refsect1">
<a id="idm13356"></a>
<h2>Examples</h2>
<p>If you attempt to use Subversion 1.7 on a working copy
created with an older version of Subversion, you will see
an error:</p>
<div class="informalexample">
<pre class="screen">
$ svn status
svn: E155036: Please see the 'svn upgrade' command
svn: E155036: Working copy '/home/sally/project' is too old (format 10, create
d by Subversion 1.6)
$
</pre>
</div>
<p>Use the <span class="command"><strong>svn upgrade</strong></span> command to
upgrade the working copy to the most recent metadata
format supported by your version of Subversion.</p>
<div class="informalexample">
<pre class="screen">
$ svn upgrade
Upgraded '.'
Upgraded 'A'
Upgraded 'A/B'
Upgraded 'A/B/E'
Upgraded 'A/B/F'
Upgraded 'A/C'
Upgraded 'A/D'
Upgraded 'A/D/G'
Upgraded 'A/D/H'
$ svn status
D A/B/E/alpha
M A/D/gamma
A A/newfile
$
</pre>
</div>
<p>Notice that <span class="command"><strong>svn upgrade</strong></span> preserved
the local modifications present in the working copy at the
time of the upgrade, which were introduced by the version
of Subversion previously used to manipulate this working
copy.</p>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<table border="0" summary="Warning">
<tr>
<td rowspan="2" align="center" valign="top" width="25">
<img alt="[Warning]" src="images/warning.png" />
</td>
<th align="left">Warning</th>
</tr>
<tr>
<td align="left" valign="top">
<p>As was the case with automatically upgraded working
copies in the past, explicitly upgraded working copies
will be unusable by older versions of Subversion,
too.</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.update.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.svnadmin.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">svn update (up) </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> svnadmin Reference—Subversion Repository Administration</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
>
143
