<!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="X-UA-Compatible" content="IE=Edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Working Trees — 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" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></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>
<script type="text/javascript" src="../_static/language_data.js"></script>
<link rel="shortcut icon" href="../_static/bzr.ico"/>
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Authentication Settings" href="authentication-help.html" />
<link rel="prev" title="Branches Out of Sync" href="sync-for-reconfigure-help.html" />
</head><body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="authentication-help.html" title="Authentication Settings"
accesskey="N">next</a></li>
<li class="right" >
<a href="sync-for-reconfigure-help.html" title="Branches Out of Sync"
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="working-trees">
<h1>Working Trees<a class="headerlink" href="#working-trees" title="Permalink to this headline">¶</a></h1>
<p>A working tree is the contents of a branch placed on disk so that you can
see the files and edit them. The working tree is where you make changes to a
branch, and when you commit the current state of the working tree is the
snapshot that is recorded in the commit.</p>
<p>When you push a branch to a remote system, a working tree will not be
created. If one is already present the files will not be updated. The
branch information will be updated and the working tree will be marked
as out-of-date. Updating a working tree remotely is difficult, as there
may be uncommitted changes or the update may cause content conflicts that are
difficult to deal with remotely.</p>
<p>If you have a branch with no working tree you can use the ‘checkout’ command
to create a working tree. If you run ‘bzr checkout .’ from the branch it will
create the working tree. If the branch is updated remotely, you can update the
working tree by running ‘bzr update’ in that directory.</p>
<p>If you have a branch with a working tree that you do not want the ‘remove-tree’
command will remove the tree if it is safe. This can be done to avoid the
warning about the remote working tree not being updated when pushing to the
branch. It can also be useful when working with a ‘–no-trees’ repository
(see ‘bzr help repositories’).</p>
<p>If you want to have a working tree on a remote machine that you push to you
can either run ‘bzr update’ in the remote branch after each push, or use some
other method to update the tree during the push. There is an ‘rspush’ plugin
that will update the working tree using rsync as well as doing a push. There
is also a ‘push-and-update’ plugin that automates running ‘bzr update’ via SSH
after each push.</p>
<p>Useful commands:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">checkout</span> <span class="n">Create</span> <span class="n">a</span> <span class="n">working</span> <span class="n">tree</span> <span class="n">when</span> <span class="n">a</span> <span class="n">branch</span> <span class="n">does</span> <span class="ow">not</span> <span class="n">have</span> <span class="n">one</span><span class="o">.</span>
<span class="n">remove</span><span class="o">-</span><span class="n">tree</span> <span class="n">Removes</span> <span class="n">the</span> <span class="n">working</span> <span class="n">tree</span> <span class="kn">from</span> <span class="nn">a</span> <span class="n">branch</span> <span class="n">when</span> <span class="n">it</span> <span class="ow">is</span> <span class="n">safe</span> <span class="n">to</span> <span class="n">do</span> <span class="n">so</span><span class="o">.</span>
<span class="n">update</span> <span class="n">When</span> <span class="n">a</span> <span class="n">working</span> <span class="n">tree</span> <span class="ow">is</span> <span class="n">out</span> <span class="n">of</span> <span class="n">sync</span> <span class="k">with</span> <span class="n">its</span> <span class="n">associated</span> <span class="n">branch</span>
<span class="n">this</span> <span class="n">will</span> <span class="n">update</span> <span class="n">the</span> <span class="n">tree</span> <span class="n">to</span> <span class="n">match</span> <span class="n">the</span> <span class="n">branch</span><span class="o">.</span>
</pre></div>
</div>
</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="sync-for-reconfigure-help.html"
title="previous chapter">Branches Out of Sync</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="authentication-help.html"
title="next chapter">Authentication Settings</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/user-reference/working-trees-help.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<div class="searchformwrapper">
<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>
</div>
</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="authentication-help.html" title="Authentication Settings"
>next</a></li>
<li class="right" >
<a href="sync-for-reconfigure-help.html" title="Branches Out of Sync"
>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.8.4.
</div>
</body>
</html>
