<!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>upgrade — Bazaar v2.4.2 documentation</title> <link rel="stylesheet" href="../_static/default.css" type="text/css" /> <link rel="stylesheet" href="../_static/pygments.css" type="text/css" /> <script type="text/javascript"> var DOCUMENTATION_OPTIONS = { URL_ROOT: '../', VERSION: '2.4.2', COLLAPSE_INDEX: false, FILE_SUFFIX: '.html', HAS_SOURCE: true }; </script> <script type="text/javascript" src="../_static/jquery.js"></script> <script type="text/javascript" src="../_static/underscore.js"></script> <script type="text/javascript" src="../_static/doctools.js"></script> <link rel="shortcut icon" href="../_static/bzr.ico"/> <link rel="top" title="Bazaar v2.4.2 documentation" href="../index.html" /> <link rel="up" title="Bazaar User Reference" href="index.html" /> <link rel="next" title="verify-signatures" href="verify-signatures-help.html" /> <link rel="prev" title="update" href="update-help.html" /> </head> <body> <div class="related"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="verify-signatures-help.html" title="verify-signatures" accesskey="N">next</a></li> <li class="right" > <a href="update-help.html" title="update" accesskey="P">previous</a> |</li> <li><a href="http://bazaar.canonical.com/"> <img src="../_static/bzr icon 16.png" /> Home</a> | </li> <a href="http://doc.bazaar.canonical.com/en/">Documentation</a> | </li> <li><a href="../index.html">Table of Contents (2.4.2)</a> »</li> <li><a href="index.html" accesskey="U">Bazaar User Reference</a> »</li> </ul> </div> <div class="document"> <div class="documentwrapper"> <div class="bodywrapper"> <div class="body"> <div class="section" id="upgrade"> <h1>upgrade<a class="headerlink" href="#upgrade" title="Permalink to this headline">ΒΆ</a></h1> <table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field"><th class="field-name">Purpose:</th><td class="field-body"><p class="first">Upgrade a repository, branch or working tree to a newer format.</p> </td> </tr> <tr class="field"><th class="field-name">Usage:</th><td class="field-body"><p class="first">bzr upgrade [URL]</p> </td> </tr> <tr class="field"><th class="field-name">Options:</th><td class="field-body"><table class="first docutils option-list" frame="void" rules="none"> <col class="option" /> <col class="description" /> <tbody valign="top"> <tr><td class="option-group"> <kbd><span class="option">--dry-run</span></kbd></td> <td><p class="first last">Show what would be done, but don’t actually do anything.</p> </td></tr> <tr><td class="option-group"> <kbd><span class="option">-v</span>, <span class="option">--verbose</span></kbd></td> <td><p class="first last">Display more information.</p> </td></tr> <tr><td class="option-group"> <kbd><span class="option">-q</span>, <span class="option">--quiet</span></kbd></td> <td><p class="first last">Only display errors and warnings.</p> </td></tr> <tr><td class="option-group"> <kbd><span class="option">--clean</span></kbd></td> <td><p class="first last">Remove the backup.bzr directory if successful.</p> </td></tr> <tr><td class="option-group"> <kbd><span class="option">--usage</span></kbd></td> <td><p class="first last">Show usage message and options.</p> </td></tr> <tr><td class="option-group"> <kbd><span class="option">-h</span>, <span class="option">--help</span></kbd></td> <td><p class="first last">Show help message.</p> </td></tr> </tbody> </table> <p>Branch format:</p> <div class="highlight-python"><pre>--format=ARG Upgrade to a specific format. See "bzr help formats" for details. --1.14 A working-tree format that supports content filtering. --1.14-rich-root A variant of 1.14 that supports rich-root data (needed for bzr-svn and bzr-git). --2a First format for bzr 2.0 series. Uses group-compress storage. Provides rich roots which are a one-way transition. --default First format for bzr 2.0 series. Uses group-compress storage. Provides rich roots which are a one-way transition. --pack-0.92 New in 0.92: Pack-based format with data compatible with dirstate-tags format repositories. Interoperates with bzr repositories before 0.92 but cannot be read by bzr < 0.92.</pre> </div> </td> </tr> <tr class="field"><th class="field-name">Description:</th><td class="field-body"><p class="first">When the default format has changed after a major new release of Bazaar, you may be informed during certain operations that you should upgrade. Upgrading to a newer format may improve performance or make new features available. It may however limit interoperability with older repositories or with older versions of Bazaar.</p> <p>If you wish to upgrade to a particular format rather than the current default, that can be specified using the –format option. As a consequence, you can use the upgrade command this way to “downgrade” to an earlier format, though some conversions are a one way process (e.g. changing from the 1.x default to the 2.x default) so downgrading is not always possible.</p> <p>A backup.bzr.~#~ directory is created at the start of the conversion process (where # is a number). By default, this is left there on completion. If the conversion fails, delete the new .bzr directory and rename this one back in its place. Use the –clean option to ask for the backup.bzr directory to be removed on successful conversion. Alternatively, you can delete it by hand if everything looks good afterwards.</p> <p>If the location given is a shared repository, dependent branches are also converted provided the repository converts successfully. If the conversion of a branch fails, remaining branches are still tried.</p> <p>For more information on upgrades, see the Bazaar Upgrade Guide, <a class="reference external" href="http://doc.bazaar.canonical.com/latest/en/upgrade-guide/">http://doc.bazaar.canonical.com/latest/en/upgrade-guide/</a>.</p> </td> </tr> <tr class="field"><th class="field-name">See also:</th><td class="field-body"><p class="first last"><a class="reference internal" href="check-help.html"><em>check</em></a>, <a class="reference internal" href="formats-help.html"><em>formats</em></a>, <a class="reference internal" href="reconcile-help.html"><em>reconcile</em></a></p> </td> </tr> </tbody> </table> </div> </div> </div> </div> <div class="sphinxsidebar"> <div class="sphinxsidebarwrapper"> <h4>Previous topic</h4> <p class="topless"><a href="update-help.html" title="previous chapter">update</a></p> <h4>Next topic</h4> <p class="topless"><a href="verify-signatures-help.html" title="next chapter">verify-signatures</a></p> <h3>This Page</h3> <ul class="this-page-menu"> <li><a href="../_sources/user-reference/upgrade-help.txt" rel="nofollow">Show Source</a></li> </ul> <div id="searchbox" style="display: none"> <h3>Quick search</h3> <form class="search" action="../search.html" method="get"> <input type="text" name="q" size="18" /> <input type="submit" value="Go" /> <input type="hidden" name="check_keywords" value="yes" /> <input type="hidden" name="area" value="default" /> </form> <p class="searchtip" style="font-size: 90%"> Enter search terms or a module, class or function name. </p> </div> <script type="text/javascript">$('#searchbox').show(0);</script> </div> </div> <div class="clearer"></div> </div> <div class="related"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="verify-signatures-help.html" title="verify-signatures" >next</a></li> <li class="right" > <a href="update-help.html" title="update" >previous</a> |</li> <li><a href="http://bazaar.canonical.com/"> <img src="../_static/bzr icon 16.png" /> Home</a> | </li> <a href="http://doc.bazaar.canonical.com/en/">Documentation</a> | </li> <li><a href="../index.html">Table of Contents (2.4.2)</a> »</li> <li><a href="index.html" >Bazaar User Reference</a> »</li> </ul> </div> <div class="footer"> © Copyright 2009-2011 Canonical Ltd. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7. </div> </body> </html>