<!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>pull — Bazaar 2.6.0 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.6.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="top" title="Bazaar 2.6.0 documentation" href="../index.html" /> <link rel="up" title="Bazaar User Reference" href="index.html" /> <link rel="next" title="push" href="push-help.html" /> <link rel="prev" title="plugins" href="plugins-help.html" /> </head> <body> <div class="related"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="push-help.html" title="push" accesskey="N">next</a></li> <li class="right" > <a href="plugins-help.html" title="plugins" 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.6.0)</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="pull"> <h1>pull<a class="headerlink" href="#pull" 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">Turn this branch into a mirror of another branch.</p> </td> </tr> <tr class="field-even field"><th class="field-name">Usage:</th><td class="field-body"><p class="first">bzr pull [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">--remember</span></kbd></td> <td><p class="first last">Remember the specified location as a default.</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"> <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">-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 pull into, rather than the one containing the working directory.</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">--show-base</span></kbd></td> <td><p class="first last">Show base revision text in conflicts.</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">--local</span></kbd></td> <td><p class="first last">Perform a local pull in a bound branch. Local pulls are not applied to the master branch.</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">Show logs of pulled revisions.</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">By default, 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) into the parent.</p> <p>If branches have diverged, you can use ‘bzr merge’ to integrate the changes from one into the other. Once one branch has merged, the other should be able to pull it again.</p> <p>If you want to replace your local changes and just want your branch to match the remote one, use pull –overwrite. This will work even if the two branches have diverged.</p> <p>If there is no default location set, the first pull 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 pulled using the log_format configuration option. You can use a different format by overriding it with -Olog_format=<other_format>.</p> <p>Note: The location can be specified either in the form of a branch, or in the form of a path to a file containing a merge directive generated with bzr send.</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="push-help.html"><em>push</em></a>, <a class="reference internal" href="send-help.html"><em>send</em></a>, <a class="reference internal" href="status-flags-help.html"><em>status-flags</em></a>, <a class="reference internal" href="update-help.html"><em>update</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="plugins-help.html" title="previous chapter">plugins</a></p> <h4>Next topic</h4> <p class="topless"><a href="push-help.html" title="next chapter">push</a></p> <h3>This Page</h3> <ul class="this-page-menu"> <li><a href="../_sources/user-reference/pull-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" /> <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="push-help.html" title="push" >next</a></li> <li class="right" > <a href="plugins-help.html" title="plugins" >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.6.0)</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.1.3. </div> </body> </html>