<!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 2.7.0 documentation</title> <link rel="stylesheet" href="../_static/classic.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.7.0', 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="search" title="Search" href="../search.html" /> <link rel="top" title="Bazaar 2.7.0 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 role="document"> <div class="related" role="navigation" aria-label="related navigation"> <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 class="nav-item nav-item-0"><a href="../index.html">Table of Contents (2.7.0)</a> »</li> <li class="nav-item nav-item-1"><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" role="main"> <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-odd 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-even field"><th class="field-name">Usage:</th><td class="field-body"><p class="first">bzr push [LOCATION]</p> </td> </tr> <tr class="field-odd 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">--overwrite-tags</span></kbd></td> </tr> <tr><td> </td><td><p class="first last">Overwrite tags only.</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-even 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 setting 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> <p>The –verbose option will display the revisions pushed using the log_format configuration option. You can use a different format by overriding it with -Olog_format=<other_format>.</p> </td> </tr> <tr class="field-odd field"><th class="field-name">See also:</th><td class="field-body"><p class="first last"><a class="reference internal" href="pull-help.html"><span class="doc">pull</span></a>, <a class="reference internal" href="update-help.html"><span class="doc">update</span></a>, <a class="reference internal" href="working-trees-help.html"><span class="doc">working-trees</span></a></p> </td> </tr> </tbody> </table> </div> </div> </div> </div> <div class="sphinxsidebar" role="navigation" aria-label="main navigation"> <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> <div role="note" aria-label="source link"> <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> <div id="searchbox" style="display: none" role="search"> <h3>Quick search</h3> <form class="search" action="../search.html" method="get"> <div><input type="text" name="q" /></div> <div><input type="submit" value="Go" /></div> <input type="hidden" name="check_keywords" value="yes" /> <input type="hidden" name="area" value="default" /> </form> </div> <script type="text/javascript">$('#searchbox').show(0);</script> </div> </div> <div class="clearer"></div> </div> <div class="related" role="navigation" aria-label="related navigation"> <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 class="nav-item nav-item-0"><a href="../index.html">Table of Contents (2.7.0)</a> »</li> <li class="nav-item nav-item-1"><a href="index.html" >Bazaar User Reference</a> »</li> </ul> </div> <div class="footer" role="contentinfo"> © Copyright 2009-2011 Canonical Ltd. Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.4.9. </div> </body> </html>