<!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" lang="ja">
<head>
<meta http-equiv="X-UA-Compatible" content="IE=Edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Filtered views — Bazaar 2.7.0 ドキュメント</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>
<script type="text/javascript" src="../_static/translations.js"></script>
<link rel="shortcut icon" href="../_static/bzr.ico"/>
<link rel="search" title="検索" href="../search.html" />
<link rel="next" title="スタックブランチを利用する" href="stacked.html" />
<link rel="prev" title="Shelving Changes" href="shelving_changes.html" />
</head><body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>ナビゲーション</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="stacked.html" title="スタックブランチを利用する"
accesskey="N">次へ</a></li>
<li class="right" >
<a href="shelving_changes.html" title="Shelving Changes"
accesskey="P">前へ</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">目次 (2.7.0)</a> »</li>
<li class="nav-item nav-item-1"><a href="index.html" accesskey="U">Bazaarユーザーガイド</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="filtered-views">
<h1>Filtered views<a class="headerlink" href="#filtered-views" title="このヘッドラインへのパーマリンク">¶</a></h1>
<div class="section" id="filtered-view">
<h2>Filtered view の紹介<a class="headerlink" href="#filtered-view" title="このヘッドラインへのパーマリンク">¶</a></h2>
<p>Viewはtreeに対するマスクを提供し、ユーザーはtreeの一部分に集中できるようになります。
このマスキングが役に立ついくつかの場面があります。たとえば、大きなプロジェクトの技術ライターやテスターはプロジェクトのうち一部のディレクトリやファイルだけを扱います。</p>
<p>開発者は大規模な変更をviewを使っていくつかのコミットに分解したいと思うかもしれません。 <code class="docutils literal notranslate"><span class="pre">shelve</span></code> <code class="docutils literal notranslate"><span class="pre">unshelve</span></code> がいくつかの変更を後のコミットまでとっておくのに対して、viewは次のコミットに(何を含めないかではなく)何を含めるかを指定します。</p>
<p>viewを作った後は、ファイルリストをサポートするコマンド - status,
diff, commit, etc - に暗黙的に毎回そのファイルリストが渡されます。
それらのコマンドに明示的にファイルリストを渡すことも可能ですが、指名するファイルは現在のviewの中にないといけません。
対照的に、ツリーを対象とするコマンド - pull, merge, update, etc -
はviewが作られた後もツリー全体に対して操作しますが、現在のviewに関係するもののみを報告します。
どちらのケースでも、Bazaarはユーザーに毎回viewが使われていることを報告するので、操作や出力がマスクされていることが判ります。</p>
<p>ノート: filtered view は 2a フォーマット(Bazaar 2.0 以降でデフォルトの
フォーマット)でのみ有効です。</p>
</div>
<div class="section" id="view">
<h2>view を作る<a class="headerlink" href="#view" title="このヘッドラインへのパーマリンク">¶</a></h2>
<p>次のように, <code class="docutils literal notranslate"><span class="pre">view</span></code> コマンドにファイルやディレクトリを指定することでviewを作ります:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">bzr</span> <span class="n">view</span> <span class="n">file1</span> <span class="n">file2</span> <span class="n">dir1</span> <span class="o">...</span>
</pre></div>
</div>
<p>出力は:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">Using</span> <span class="s1">'my'</span> <span class="n">view</span><span class="p">:</span> <span class="n">file1</span><span class="p">,</span> <span class="n">file2</span><span class="p">,</span> <span class="n">dir1</span>
</pre></div>
</div>
</div>
<div class="section" id="id1">
<h2>現在のviewをリストする<a class="headerlink" href="#id1" title="このヘッドラインへのパーマリンク">¶</a></h2>
<p>現在のviewを見るには、 <code class="docutils literal notranslate"><span class="pre">view</span></code> コマンドに引数をつけないで実行します:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">bzr</span> <span class="n">view</span>
</pre></div>
</div>
<p>もしviewが無ければ、 <code class="docutils literal notranslate"><span class="pre">No</span> <span class="pre">current</span> <span class="pre">view.</span></code> というメッセージが出力されるでしょう。
そうでなければ、現在のviewの名前と内容が次のように表示されます:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="s1">'my'</span> <span class="n">view</span> <span class="ow">is</span><span class="p">:</span> <span class="n">a</span><span class="p">,</span> <span class="n">b</span><span class="p">,</span> <span class="n">c</span>
</pre></div>
</div>
</div>
<div class="section" id="id2">
<h2>viewを切り替える<a class="headerlink" href="#id2" title="このヘッドラインへのパーマリンク">¶</a></h2>
<p>ほとんどの場合、viewは「変更を選択するために作られて、変更がコミットされると削除される」という具合に短い期間で使われます。
それ以外の場合では、viewに名前をつけてそれを切り替えたい場合があるかもしれません。</p>
<p>名前つきviewを宣言してそれに切り替えるには:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">bzr</span> <span class="n">view</span> <span class="o">--</span><span class="n">name</span> <span class="n">view</span><span class="o">-</span><span class="n">name</span> <span class="n">file1</span> <span class="n">dir1</span> <span class="o">...</span>
</pre></div>
</div>
<p>たとえば:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">bzr</span> <span class="n">view</span> <span class="o">--</span><span class="n">name</span> <span class="n">doc</span> <span class="n">NEWS</span> <span class="n">doc</span><span class="o">/</span>
<span class="n">Using</span> <span class="n">doc</span> <span class="n">view</span><span class="p">:</span> <span class="n">NEWS</span><span class="p">,</span> <span class="n">doc</span><span class="o">/</span>
</pre></div>
</div>
<p>名前つきviewを見るには:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">bzr</span> <span class="n">view</span> <span class="o">--</span><span class="n">name</span> <span class="n">view</span><span class="o">-</span><span class="n">name</span>
</pre></div>
</div>
<p>名前つきviewに切り替えるには:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">bzr</span> <span class="n">view</span> <span class="o">--</span><span class="n">switch</span> <span class="n">view</span><span class="o">-</span><span class="n">name</span>
</pre></div>
</div>
<p>全ての名前つきviewの一覧を得るには:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">bzr</span> <span class="n">view</span> <span class="o">--</span><span class="nb">all</span>
</pre></div>
</div>
</div>
<div class="section" id="id3">
<h2>一時的にviewを無効にする<a class="headerlink" href="#id3" title="このヘッドラインへのパーマリンク">¶</a></h2>
<p>現在のviewを削除せずに無効にしたい場合、 <code class="docutils literal notranslate"><span class="pre">off</span></code> という名前の仮想viewに切り替えることができます。これは、ツリー全体を一つか二つのコマンドで操作する必要があり(例: merge)、しかしその後に元のviewに戻りたい場合に便利です。</p>
<p>現在のviewを削除せずに無効にするには:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">bzr</span> <span class="n">view</span> <span class="o">--</span><span class="n">switch</span> <span class="n">off</span>
</pre></div>
</div>
<p>ツリー全体に対する操作が終わったら、元のviewの名前を指定して戻ることができます。たとえば、デフォルトの名前が使われて他のであれば:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">bzr</span> <span class="n">view</span> <span class="o">--</span><span class="n">switch</span> <span class="n">my</span>
</pre></div>
</div>
</div>
<div class="section" id="id4">
<h2>viewを削除する<a class="headerlink" href="#id4" title="このヘッドラインへのパーマリンク">¶</a></h2>
<p>現在のviewを削除するには:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">bzr</span> <span class="n">view</span> <span class="o">--</span><span class="n">delete</span>
</pre></div>
</div>
<p>名前つきviewを削除するには:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">bzr</span> <span class="n">view</span> <span class="o">--</span><span class="n">name</span> <span class="n">view</span><span class="o">-</span><span class="n">name</span> <span class="o">--</span><span class="n">delete</span>
</pre></div>
</div>
<p>全てのviewを削除するには:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">bzr</span> <span class="n">view</span> <span class="o">--</span><span class="n">delete</span> <span class="o">--</span><span class="nb">all</span>
</pre></div>
</div>
</div>
<div class="section" id="id5">
<h2>注意点<a class="headerlink" href="#id5" title="このヘッドラインへのパーマリンク">¶</a></h2>
<p>view を定義しても作業ツリー内のほかのファイルを削除するわけではありません。単に作業ツリーに対する "レンズ" を提供するだけです。</p>
<p>view は作業ツリーのメタデータとして保存されます。pull, push, update
といったブランチコマンドを使っても他の作業ツリーに伝播しません。</p>
<p>view はファイルパスの形で定義されます。もしview内のファイルをview外に
移動したのであれば、view はそのファイルを追跡しません。
たとえば、viewが <code class="docutils literal notranslate"><span class="pre">doc/</span></code> と定義されていて <code class="docutils literal notranslate"><span class="pre">doc/NEWS</span></code> を <code class="docutils literal notranslate"><span class="pre">NEWS</span></code>
に移動しても view は <code class="docutils literal notranslate"><span class="pre">doc/</span></code> に定義されたままで、 <code class="docutils literal notranslate"><span class="pre">doc/</span></code> と <code class="docutils literal notranslate"><span class="pre">NEWS</span></code>
のように変更されたりはしません。同じように、view内のファイルを削除してもviewからはそのファイルパスは削除されません。</p>
<p>現在のviewを利用するコマンドは:</p>
<ul class="simple">
<li>status</li>
<li>diff</li>
<li>commit</li>
<li>add</li>
<li>remove</li>
<li>revert</li>
<li>mv</li>
<li>ls</li>
</ul>
<p>ツリー全体に対する操作だけれども現在のviewの中だけを報告するコマンドは:</p>
<ul class="simple">
<li>pull</li>
<li>update</li>
<li>merge.</li>
</ul>
<p>現在のところ、多くのコマンドがviewを無視します。ニーズがあるコマンドから徐々に上の対応リストに追加されていくでしょう。
いくつかのコマンドは全体図を見るのがより適しているために、viewを無視したままになるでしょう。このタイプのコマンドには次のものがあります:</p>
<ul class="simple">
<li>log</li>
<li>info</li>
</ul>
</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="#">Filtered views</a><ul>
<li><a class="reference internal" href="#filtered-view">Filtered view の紹介</a></li>
<li><a class="reference internal" href="#view">view を作る</a></li>
<li><a class="reference internal" href="#id1">現在のviewをリストする</a></li>
<li><a class="reference internal" href="#id2">viewを切り替える</a></li>
<li><a class="reference internal" href="#id3">一時的にviewを無効にする</a></li>
<li><a class="reference internal" href="#id4">viewを削除する</a></li>
<li><a class="reference internal" href="#id5">注意点</a></li>
</ul>
</li>
</ul>
<h4>前のトピックへ</h4>
<p class="topless"><a href="shelving_changes.html"
title="前の章へ">Shelving Changes</a></p>
<h4>次のトピックへ</h4>
<p class="topless"><a href="stacked.html"
title="次の章へ">スタックブランチを利用する</a></p>
<div role="note" aria-label="source link">
<h3>このページ</h3>
<ul class="this-page-menu">
<li><a href="../_sources/user-guide/filtered_views.txt"
rel="nofollow">ソースコードを表示</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>クイック検索</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="検索" />
<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>ナビゲーション</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="stacked.html" title="スタックブランチを利用する"
>次へ</a></li>
<li class="right" >
<a href="shelving_changes.html" title="Shelving Changes"
>前へ</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">目次 (2.7.0)</a> »</li>
<li class="nav-item nav-item-1"><a href="index.html" >Bazaarユーザーガイド</a> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright 2009-2011 Canonical Ltd.
このドキュメントは <a href="http://sphinx-doc.org/">Sphinx</a> 1.8.4 で生成しました。
</div>
</body>
</html>
