Sophie

Sophie

distrib > Mageia > 7 > i586 > media > core-release > by-pkgid > 4d3e035d9e975b827326563d291f989a > files > 3579

bzr-2.7.0-6.mga7.i586.rpm


<!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="ru">
  <head>
    <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title>Bazaar за пять минут &#8212; Документация 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="Учебник Bazaar" href="../tutorials/tutorial.html" />
    <link rel="prev" title="Карточка быстрого старта" href="../quick-reference/index.html" /> 
  </head><body>
    <div class="related" role="navigation" aria-label="related navigation">
      <h3>Навигация</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="../tutorials/tutorial.html" title="Учебник Bazaar"
             accesskey="N">вперёд</a></li>
        <li class="right" >
          <a href="../quick-reference/index.html" title="Карточка быстрого старта"
             accesskey="P">назад</a> |</li>
<li><a href="http://bazaar.canonical.com/">
    <img src="../_static/bzr icon 16.png" /> Главная</a>&nbsp;|&nbsp;</li>
<a href="http://doc.bazaar.canonical.com/ru/">Документация</a>&nbsp;|&nbsp;</li>

        <li class="nav-item nav-item-0"><a href="../index.html">Содержание (2.7.0)</a> &#187;</li>
 
      </ul>
    </div>  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body" role="main">
            
  <div class="section" id="bazaar">
<h1><a class="toc-backref" href="#id18">Bazaar за пять минут</a><a class="headerlink" href="#bazaar" title="Ссылка на этот заголовок">¶</a></h1>
<div class="contents topic" id="id1">
<p class="topic-title first">Содержание</p>
<ul class="simple">
<li><a class="reference internal" href="#bazaar" id="id18">Bazaar за пять минут</a><ul>
<li><a class="reference internal" href="#id2" id="id19">Введение</a></li>
<li><a class="reference internal" href="#id3" id="id20">Установка</a></li>
<li><a class="reference internal" href="#id6" id="id21">Представьтесь</a></li>
<li><a class="reference internal" href="#id7" id="id22">Начинаем контролировать версии файлов</a></li>
<li><a class="reference internal" href="#id9" id="id23">Вносим изменения в файлы</a></li>
<li><a class="reference internal" href="#id10" id="id24">Просматриваем журнал изменений</a></li>
<li><a class="reference internal" href="#sftp" id="id25">Публикуем ветку через SFTP</a></li>
<li><a class="reference internal" href="#id11" id="id26">Публикация ветки на Launchpad</a></li>
<li><a class="reference internal" href="#id13" id="id27">Создаем собственную копию другой ветки</a></li>
<li><a class="reference internal" href="#id14" id="id28">Обновляем ветку изменениями из основной ветки</a></li>
<li><a class="reference internal" href="#id15" id="id29">Объединяем свои изменения с родительской веткой</a></li>
<li><a class="reference internal" href="#id16" id="id30">Узнать больше</a></li>
</ul>
</li>
</ul>
</div>
<div class="section" id="id2">
<h2><a class="toc-backref" href="#id19">Введение</a><a class="headerlink" href="#id2" title="Ссылка на этот заголовок">¶</a></h2>
<p>Bazaar — это распределенная система контроля версий, которая упрощает
совместную работу над программными проектами.</p>
<p>В течении следующих пяти минут, вы узнаете как начать контролировать версии
ваших файлов, как вносить изменения, проверять вашу работу, публиковать её и
отправлять для объединения с главной веткой проекта.</p>
<p>Если вы предпочитаете более подробное введение, обратитесь к разделу
<a class="reference internal" href="#id16">Узнать больше</a>.</p>
</div>
<div class="section" id="id3">
<h2><a class="toc-backref" href="#id20">Установка</a><a class="headerlink" href="#id3" title="Ссылка на этот заголовок">¶</a></h2>
<p>Это руководство не описывает как установить Bazaar, потому что обычно
это очень легко. Инструкции по установке вы найдете тут:</p>
<ul class="simple">
<li><strong>GNU/Linux:</strong> скорее всего Bazaar уже присутствует в вашем дистрибутиве GNU/Linux.</li>
<li><strong>Windows:</strong> <a class="reference external" href="http://wiki.bazaar.canonical.com/WindowsDownloads">инструкции по установке для Windows</a>.</li>
<li><strong>Mac OS X:</strong> <a class="reference external" href="http://wiki.bazaar.canonical.com/MacOSXBundle">инструкции по установке для Mac OS X</a>.</li>
</ul>
<p>Для других платформ и для установки из исходных кодов, обратитесь к страницам
<a class="reference external" href="http://wiki.bazaar.canonical.com/Download">Загрузка</a> и <a class="reference external" href="http://wiki.bazaar.canonical.com/InstallationFaq">Установка</a>.</p>
</div>
<div class="section" id="id6">
<h2><a class="toc-backref" href="#id21">Представьтесь</a><a class="headerlink" href="#id6" title="Ссылка на этот заголовок">¶</a></h2>
<p>Прежде чем начать работать, было бы неплохо сообщить Bazaar кто вы такой.
В этом случае ваша работа будет корректно идентифицирована в истории ревизий.</p>
<p>Используя ваше имя и адрес электронной почты, вместо данных Васи Пупкина,
наберите:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr whoami &quot;Vasya Pupkin &lt;vasya.pupkin@mail.ru&gt;&quot;
</pre></div>
</div>
<p>В этот момент Bazaar создаст или исправит файл настроек, включив в него ваше
имя и адрес электронной почты.</p>
<p>Теперь, проверьте правильно ли сохранены ваши имя и адрес:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr whoami
Vasya Pupkin &lt;vasya.pupkin@mail.ru&gt;
</pre></div>
</div>
</div>
<div class="section" id="id7">
<h2><a class="toc-backref" href="#id22">Начинаем контролировать версии файлов</a><a class="headerlink" href="#id7" title="Ссылка на этот заголовок">¶</a></h2>
<p>Давайте создадим каталог и несколько файлов для использования с Bazaar:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ mkdir myproject
$ cd myproject
$ mkdir subdirectory
$ touch test1.txt test2.txt test3.txt subdirectory/test4.txt
</pre></div>
</div>
<p><strong>Замечание для пользователей Windows:</strong> используйте Windows Explorer
для создания ваших каталогов, затем нажимайте правую кнопку мыши
в этих каталогах и выбирайте <code class="docutils literal notranslate"><span class="pre">Новый</span> <span class="pre">файл</span></code>, чтобы создать ваши файлы.</p>
<p>Теперь дадим Bazaar возможность инициализировать свои данные в каталоге вашего
проекта:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr init
</pre></div>
</div>
<p>Если всё выглядит так, как будто ничего не случилось — не волнуйтесь. Bazaar
создал <a class="reference external" href="http://wiki.bazaar.canonical.com/Branch">ветку</a>, в которой он будет хранить рабочие файлы и историю их изменений.</p>
<p>Следующий шаг — сказать Bazaar какие файлы вы хотите контролировать. Команда
<code class="docutils literal notranslate"><span class="pre">bzr</span> <span class="pre">add</span></code> рекурсивно добавит все файлы в проект:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr add
added subdirectory
added test1.txt
added test2.txt
added test3.txt
added subdirectory/test4.txt
</pre></div>
</div>
<p>Далее, нужно сохранить текущее состояние ваших файлов зафиксировав их в вашей
ветке. Добавьте сообщение объясняющее зачем вы сделали фиксацию:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr commit -m &quot;Импортируем файлы&quot;
</pre></div>
</div>
<p>Т.к. Bazaar это распределенная система контроля версий, здесь нет необходимости
соединяться с центральным сервером для выполнения фиксации. Вместо этого,
Bazaar сохраняет вашу ветку и все её фиксации внутри каталога с которым вы
работаете; обратите внимание на подкаталог <code class="docutils literal notranslate"><span class="pre">.bzr</span></code>.</p>
</div>
<div class="section" id="id9">
<h2><a class="toc-backref" href="#id23">Вносим изменения в файлы</a><a class="headerlink" href="#id9" title="Ссылка на этот заголовок">¶</a></h2>
<p>Давайте изменим какой-либо файл и зафиксируем это изменение в вашей ветке.</p>
<p>Отредактируйте <code class="docutils literal notranslate"><span class="pre">test1.txt</span></code> в своем любимом редакторе и затем посмотрите на
сделанные изменения:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr diff
=== modified file &#39;test1.txt&#39;
--- test1.txt 2007-10-08 17:56:14 +0000
+++ test1.txt 2007-10-08 17:46:22 +0000
@@ -0,0 +1,1 @@
+test test test
</pre></div>
</div>
<p>Зафиксируйте вашу работу в ветке Bazaar:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr commit -m &quot;Добавлена первая строка текста&quot;
Committed revision 2.
</pre></div>
</div>
</div>
<div class="section" id="id10">
<h2><a class="toc-backref" href="#id24">Просматриваем журнал изменений</a><a class="headerlink" href="#id10" title="Ссылка на этот заголовок">¶</a></h2>
<p>Вы можете увидеть историю вашей ветки просмотрев её журнал:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr log
------------------------------------------------------------
revno: 2
committer: Vasya Pupkin &lt;vasya.pupkin@mail.ru&gt;
branch nick: myproject
timestamp: Mon 2007-10-08 17:56:14 +0000
message:
  Добавлена первая строка текста
------------------------------------------------------------
revno: 1
committer: Vasya Pupkin &lt;vasya.pupkin@mail.ru&gt;
branch nick: myproject
timestamp: Mon 2006-10-08 17:46:22 +0000
message:
  Импортируем файлы
</pre></div>
</div>
</div>
<div class="section" id="sftp">
<h2><a class="toc-backref" href="#id25">Публикуем ветку через SFTP</a><a class="headerlink" href="#sftp" title="Ссылка на этот заголовок">¶</a></h2>
<p>Есть несколько способов опубликовать вашу ветку. Если у вас уже есть SFTP
сервер или вам несложно его настроить, вы можете опубликовать свою ветку через
него.</p>
<p>В противном случае, переходите к следующему разделу, чтобы опубликовать ветку
на <a class="reference external" href="https://launchpad.net/">Launchpad</a> — бесплатном хостинге для Bazaar.</p>
<p>Предположим, что вы хотите опубликовать свою ветку на
<code class="docutils literal notranslate"><span class="pre">www.example.com/myproject</span></code>:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr push --create-prefix sftp://your.name@example.com/~/public_html/myproject
2 revision(s) pushed.
</pre></div>
</div>
<p>Bazaar создаст каталог <code class="docutils literal notranslate"><span class="pre">myproject</span></code> на удаленном сервере и поместит в него
вашу ветку.</p>
<p>Теперь любой желающий сможет создать свою собственную копию вашей ветки,
выполнив:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr branch http://www.example.com/myproject
</pre></div>
</div>
<p><strong>Замечание:</strong> чтобы использовать SFTP, может понадобиться установить
<code class="docutils literal notranslate"><span class="pre">paramiko</span></code> и <code class="docutils literal notranslate"><span class="pre">pyCrypto</span></code>. За подробностями обращайтесь к
<a class="reference external" href="http://wiki.bazaar.canonical.com/InstallationFaq">http://wiki.bazaar.canonical.com/InstallationFaq</a>.</p>
</div>
<div class="section" id="id11">
<h2><a class="toc-backref" href="#id26">Публикация ветки на Launchpad</a><a class="headerlink" href="#id11" title="Ссылка на этот заголовок">¶</a></h2>
<p>Launchpad это набор инструментов для разработки и размещения проектов
свободного программного обеспечения. Вы можете использовать его для публикации
своей ветки.</p>
<p>Если у вас нет учетной записи Launchpad, следуйте
<a class="reference external" href="https://help.launchpad.net/CreatingYourLaunchpadAccount">руководству по получению учетной записи</a> и <a class="reference external" href="https://launchpad.net/people/+me/+editsshkeys">зарегистрируйте SSH ключ</a>
в своей новой учетной записи.</p>
<p>Заменив <code class="docutils literal notranslate"><span class="pre">vasya.pupkin</span></code> на ваше имя пользователя Launchpad, выполните:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr push bzr+ssh://vasya.pupkin@bazaar.launchpad.net/~vasya.pupkin/+junk/myproject
</pre></div>
</div>
<p><strong>Замечание:</strong> <code class="docutils literal notranslate"><span class="pre">+junk</span></code> означает что ветка не связана с каким-либо проектом на
Launchpad.</p>
<p>Теперь любой желающий сможет создать свою собственную копию вашей ветки,
выполнив:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr branch http://bazaar.launchpad.net/~vasya.pupkin/+junk/myproject
</pre></div>
</div>
<p>Вы также сможете видеть информацию по вашей ветке, включая журнал изменений, по
адресу <a class="reference external" href="https://code.launchpad.net/people/+me/+junk/myproject">https://code.launchpad.net/people/+me/+junk/myproject</a></p>
</div>
<div class="section" id="id13">
<h2><a class="toc-backref" href="#id27">Создаем собственную копию другой ветки</a><a class="headerlink" href="#id13" title="Ссылка на этот заголовок">¶</a></h2>
<p>Чтобы работать с чьим-либо кодом, вы можете создать собственную копию чужой
ветки. Давайте возьмем реальный пример — GTK интерфейс для Bazaar:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr branch http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk bzr-gtk.vasya
Branched 292 revision(s).
</pre></div>
</div>
<p>Bazaar загрузит все файлы и полный журнал изменений из основной ветки проекта
bzr-gtk и создаст копию с именем bzr-gtk.vasya.</p>
<p>Теперь у вас есть собственная копия ветки и вы можете фиксировать изменения и с
сетевым подключением и без него. Вы можете поделиться своей веткой в любое
время, опубликовав ветку. И если команда разработчиков bzr-gtk захочет
использовать вашу работу, Bazaar легко позволит им объединить вашу ветку
обратно в их основную ветку.</p>
</div>
<div class="section" id="id14">
<h2><a class="toc-backref" href="#id28">Обновляем ветку изменениями из основной ветки</a><a class="headerlink" href="#id14" title="Ссылка на этот заголовок">¶</a></h2>
<p>Пока вы фиксируете изменения в вашей ветке, другие люди, скорее всего, так же
продолжают фиксировать код в родительской ветке.</p>
<p>Чтобы быть уверенным что ваша ветка содержит последние изменения, вам следует
объединить родительскую ветку с вашей личной:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr merge
Merging from saved parent location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk
All changes applied successfully.
</pre></div>
</div>
<p>Проверьте что изменилось:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr diff
</pre></div>
</div>
<p>Если изменения вас устраивают, вы можете зафиксировать их в своей ветке:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr commit -m &quot;Изменения из основной ветки&quot;
Committed revision 295.
</pre></div>
</div>
</div>
<div class="section" id="id15">
<h2><a class="toc-backref" href="#id29">Объединяем свои изменения с родительской веткой</a><a class="headerlink" href="#id15" title="Ссылка на этот заголовок">¶</a></h2>
<p>После того как вы поработали в своей ветке bzr-gtk, вы можете захотеть
отправить ваши изменения для включения в проект. Простейший способ заключается
в использовании директивы объединения.</p>
<p>Директива объединения — это машиночитаемый запрос на осуществление
конкретного объединения. Обычно он содержит обзор изменений, которые
планируется объединить. Также директива объединения содержит либо необходимые
ревизии, либо указывает на ветку где они могут быть получены.</p>
<p>Заменив <code class="docutils literal notranslate"><span class="pre">mycode.patch</span></code>, создайте свою директиву объединения:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr send -o mycode.patch
Using saved parent location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk
</pre></div>
</div>
<p>Теперь вы можете отправить директиву объединения по электронной почте
в проект bzr-gtk. Если разработчики bzr-gtk захотят, то смогут использовать
эту директиву для включения вашей работы в основную ветку.</p>
</div>
<div class="section" id="id16">
<h2><a class="toc-backref" href="#id30">Узнать больше</a><a class="headerlink" href="#id16" title="Ссылка на этот заголовок">¶</a></h2>
<p>Больше информации о Bazaar вы найдете в
<a class="reference external" href="../user-guide/index.html">Руководстве пользователя Bazaar</a>.</p>
<p>Чтобы узнать больше о Bazaar из командой строки:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr help
</pre></div>
</div>
<p>Чтобы узнать основные команды Bazaar:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr help commands
</pre></div>
</div>
<p>Чтобы узнать о теме или команде «foo»:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr help foo
</pre></div>
</div>
</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="#">Bazaar за пять минут</a><ul>
<li><a class="reference internal" href="#id2">Введение</a></li>
<li><a class="reference internal" href="#id3">Установка</a></li>
<li><a class="reference internal" href="#id6">Представьтесь</a></li>
<li><a class="reference internal" href="#id7">Начинаем контролировать версии файлов</a></li>
<li><a class="reference internal" href="#id9">Вносим изменения в файлы</a></li>
<li><a class="reference internal" href="#id10">Просматриваем журнал изменений</a></li>
<li><a class="reference internal" href="#sftp">Публикуем ветку через SFTP</a></li>
<li><a class="reference internal" href="#id11">Публикация ветки на Launchpad</a></li>
<li><a class="reference internal" href="#id13">Создаем собственную копию другой ветки</a></li>
<li><a class="reference internal" href="#id14">Обновляем ветку изменениями из основной ветки</a></li>
<li><a class="reference internal" href="#id15">Объединяем свои изменения с родительской веткой</a></li>
<li><a class="reference internal" href="#id16">Узнать больше</a></li>
</ul>
</li>
</ul>

  <h4>Предыдущий раздел</h4>
  <p class="topless"><a href="../quick-reference/index.html"
                        title="предыдущая глава">Карточка быстрого старта</a></p>
  <h4>Следующий раздел</h4>
  <p class="topless"><a href="../tutorials/tutorial.html"
                        title="следующая глава">Учебник Bazaar</a></p>
  <div role="note" aria-label="source link">
    <h3>Эта страница</h3>
    <ul class="this-page-menu">
      <li><a href="../_sources/mini-tutorial/index.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="../tutorials/tutorial.html" title="Учебник Bazaar"
             >вперёд</a></li>
        <li class="right" >
          <a href="../quick-reference/index.html" title="Карточка быстрого старта"
             >назад</a> |</li>
<li><a href="http://bazaar.canonical.com/">
    <img src="../_static/bzr icon 16.png" /> Главная</a>&nbsp;|&nbsp;</li>
<a href="http://doc.bazaar.canonical.com/ru/">Документация</a>&nbsp;|&nbsp;</li>

        <li class="nav-item nav-item-0"><a href="../index.html">Содержание (2.7.0)</a> &#187;</li>
 
      </ul>
    </div>
    <div class="footer" role="contentinfo">
        &#169; Copyright 2009-2011 Canonical Ltd.
      Создано с помощью <a href="http://sphinx-doc.org/">Sphinx</a> 1.8.4.
    </div>
  </body>
</html>