<!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>push — 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="reconcile" href="reconcile-help.html" /> <link rel="prev" title="pull" href="pull-help.html" /> </head> <body> <div class="related"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="reconcile-help.html" title="reconcile" accesskey="N">next</a></li> <li class="right" > <a href="pull-help.html" title="pull" 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="push"> <h1>push<a class="headerlink" href="#push" 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">Update a mirror of this branch.</p> </td> </tr> <tr class="field"><th class="field-name">Usage:</th><td class="field-body"><p class="first">bzr push [LOCATION]</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">--stacked</span></kbd></td> <td><p class="first last">Create a stacked branch that references the public location of the parent branch.</p> </td></tr> <tr><td class="option-group"> <kbd><span class="option">--remember</span></kbd></td> <td><p class="first last">Remember the specified location as a default.</p> </td></tr> <tr><td class="option-group"> <kbd><span class="option">--strict</span></kbd></td> <td><p class="first last">Refuse to push if there are uncommitted changes in the working tree, –no-strict disables the check.</p> </td></tr> <tr><td class="option-group" colspan="2"> <kbd><span class="option">--create-prefix</span></kbd></td> </tr> <tr><td> </td><td><p class="first last">Create the path leading up to the branch if it does not already exist.</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> <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" colspan="2"> <kbd><span class="option">--stacked-on=<var>ARG</var></span></kbd></td> </tr> <tr><td> </td><td><p class="first last">Create a stacked branch that refers to another branch for the commit history. Only the work not present in the referenced branch is included in the branch created.</p> </td></tr> <tr><td class="option-group" colspan="2"> <kbd><span class="option">-d <var>ARG</var></span>, <span class="option">--directory=<var>ARG</var></span></kbd></td> </tr> <tr><td> </td><td><p class="first last">Branch to push from, rather than the one containing the working directory.</p> </td></tr> <tr><td class="option-group" colspan="2"> <kbd><span class="option">--use-existing-dir</span></kbd></td> </tr> <tr><td> </td><td><p class="first last">By default push will fail if the target directory exists, but does not already have a control directory. This flag will allow push to proceed.</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">--no-tree</span></kbd></td> <td><p class="first last">Don’t populate the working tree, even for protocols that support it.</p> </td></tr> <tr><td class="option-group" colspan="2"> <kbd><span class="option">-r <var>ARG</var></span>, <span class="option">--revision=<var>ARG</var></span></kbd></td> </tr> <tr><td> </td><td><p class="first last">See “help revisionspec” for details.</p> </td></tr> <tr><td class="option-group"> <kbd><span class="option">--overwrite</span></kbd></td> <td><p class="first last">Ignore differences between branches and overwrite unconditionally.</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> </tbody> </table> </td> </tr> <tr class="field"><th class="field-name">Description:</th><td class="field-body"><p class="first">The target branch will not have its working tree populated because this is both expensive, and is not supported on remote file systems.</p> <p>Some smart servers or protocols <em>may</em> put the working tree in place in the future.</p> <p>This command only works on branches that have not diverged. Branches are considered diverged if the destination branch’s most recent commit is one that has not been merged (directly or indirectly) by the source branch.</p> <p>If branches have diverged, you can use ‘bzr push –overwrite’ to replace the other branch completely, discarding its unmerged changes.</p> <p>If you want to ensure you have the different changes in the other branch, do a merge (see bzr help merge) from the other branch, and commit that. After that you will be able to do a push without ‘–overwrite’.</p> <p>If there is no default push location set, the first push will set it (use –no-remember to avoid settting it). After that, you can omit the location to use the default. To change the default, use –remember. The value will only be saved if the remote location can be accessed.</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="pull-help.html"><em>pull</em></a>, <a class="reference internal" href="update-help.html"><em>update</em></a>, <a class="reference internal" href="working-trees-help.html"><em>working-trees</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="pull-help.html" title="previous chapter">pull</a></p> <h4>Next topic</h4> <p class="topless"><a href="reconcile-help.html" title="next chapter">reconcile</a></p> <h3>This Page</h3> <ul class="this-page-menu"> <li><a href="../_sources/user-reference/push-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="reconcile-help.html" title="reconcile" >next</a></li> <li class="right" > <a href="pull-help.html" title="pull" >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>