<?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.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.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" title="svn upgrade"> <a id="svn.ref.svn.c.upgrade"></a> <div class="titlepage"></div> <a id="idp21306352" 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" title="Synopsis"> <h2>Synopsis</h2> <p> <code class="literal">svn upgrade [PATH...]</code> </p> </div> <div class="refsect1" title="Description"> <a id="idp21311024"></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" title="Options"> <a id="idp21313824"></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" title="Examples"> <a id="idp21316672"></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" title="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>