<!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>Add — 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="stylesheet" href="_static/bzr-doc.css" type="text/css" />
</head><body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<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">Developer Document Catalog (2.7.0)</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="add">
<h1>Add<a class="headerlink" href="#add" title="Permalink to this headline">¶</a></h1>
<p>Add is used to recursively version some paths supplied by the user. Paths that
match ignore rules are not versioned, and paths that become versioned are
versioned in the nearest containing bzr tree. Currently we only do this within
a single tree, but perhaps with nested trees this should change.</p>
<div class="section" id="least-work-we-can-hope-to-perform">
<h2>Least work we can hope to perform<a class="headerlink" href="#least-work-we-can-hope-to-perform" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Read a subset of the full versioned paths data for the tree matching the scope of the paths the user supplied.</li>
<li>Seek once to each directory within the scope and readdir its contents.</li>
<li>Probe if each directory is a child tree to avoid adding data for paths within a child tree.</li>
<li>Calculate the ignored status for paths not previously known to be ignored</li>
<li>Write data proportional to the newly versioned file count to record their versioning.</li>
<li>Assign a fileid for each path (so that merge –uncommitted can work immediately)</li>
</ul>
<p>Optionally:</p>
<ul class="simple">
<li>Print the ignore rule for each ignored path in the scope.</li>
<li>Print the path of each added file.</li>
<li>Print the total count of ignored files within the scopes.</li>
<li>Record the result of calculating ignored status for ignored files.
(proportional to the number we actually calculate).</li>
</ul>
</div>
<div class="section" id="per-file-algorithm">
<h2>Per file algorithm<a class="headerlink" href="#per-file-algorithm" title="Permalink to this headline">¶</a></h2>
<ol class="arabic simple">
<li>If the path is versioned, and it is a directory, push onto the recurse stack.</li>
<li>If the path is supplied by the user or is not ignored, version it, and if a
directory, push onto the recurse stack. Versioning the path may require
versioning the paths parents.</li>
<li>Output or otherwise record the ignored rule as per the user interface selected.</li>
</ol>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Add</a><ul>
<li><a class="reference internal" href="#least-work-we-can-hope-to-perform">Least work we can hope to perform</a></li>
<li><a class="reference internal" href="#per-file-algorithm">Per file algorithm</a></li>
</ul>
</li>
</ul>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/add.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><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">Developer Document Catalog (2.7.0)</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>
distrib
>
Mageia
>
7
>
i586
>
media
>
core-release
>
by-pkgid
>
4d3e035d9e975b827326563d291f989a
>
files
>
2655
