<!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>Учебник Bazaar — Документация Bazaar 2.6.0</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>
<script type="text/javascript" src="../_static/translations.js"></script>
<link rel="shortcut icon" href="../_static/bzr.ico"/>
<link rel="top" title="Документация Bazaar 2.6.0" href="../index.html" />
<link rel="next" title="1 Использование Bazaar с Launchpad" href="using_bazaar_with_launchpad.html" />
<link rel="prev" title="Bazaar за пять минут" href="../mini-tutorial/index.html" />
</head>
<body>
<div class="related">
<h3>Навигация</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="using_bazaar_with_launchpad.html" title="1 Использование Bazaar с Launchpad"
accesskey="N">вперёд</a></li>
<li class="right" >
<a href="../mini-tutorial/index.html" title="Bazaar за пять минут"
accesskey="P">назад</a> |</li>
<li><a href="http://bazaar.canonical.com/">
<img src="../_static/bzr icon 16.png" /> Главная</a> | </li>
<a href="http://doc.bazaar.canonical.com/ru/">Документация</a> | </li>
<li><a href="../index.html">Содержание (2.6.0)</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="bazaar">
<h1>Учебник Bazaar<a class="headerlink" href="#bazaar" title="Ссылка на этот заголовок">¶</a></h1>
<p>Текущая версия для bzr-0.91, 2007-08</p>
<div class="section" id="id1">
<h2>Введение<a class="headerlink" href="#id1" title="Ссылка на этот заголовок">¶</a></h2>
<p>Если вы уже знакомы с распределенными системами контроля версий, то можете
сразу перейти к “Представляемся Bazaar”. Если, с другой стороны, вы знакомы с
системами контроля версий, но не знакомы с распределенными системами, тогда
стоит начать с “Чем отличаются распределенные системы”. Иначе, возьмите кофе
или чай, расположитесь поудобнее и продолжим чтение.</p>
</div>
<div class="section" id="id2">
<h2>Назначение контроля версий<a class="headerlink" href="#id2" title="Ссылка на этот заголовок">¶</a></h2>
<p>Есть шансы, что вы уже работали с какими-либо текстовыми данными – исходниками
программ, Web-сайтами, или конфигурационными файлами с которыми имеют дело
администраторы систем Unix в /etc. Также есть хорошие шансы, что вы делали
ошибки, которые вызывали потом глубокое сожаление. Возможно вы удалили
конфигурационный файл для вашего почтового сервера, или повредили исходный код
любимого проекта. Не важно что конкретно случилось, но вы просто удалили важную
информацию которую вы безнадежно хотели бы вернуть. Если такое когда либо
случалось с вами, то вы возможно готовы для Bazaar.</p>
<p>Системы контроля версий, такие как Bazaar дают возможность отслеживать
изменения для каталога, который они изменяют в нечто более сложное, что
называется <strong>ветка</strong>. Ветка не только сохраняет то как каталог выглядит в
данный момент, но также как он выглядел в различные моменты в прошлом. Затем,
когда вы сделаете что-то, что бы вы не хотели делать, вы сможете восстановить
каталог в том виде как он выглядел в какой-то момент в прошлом.</p>
<p>Системы контроля версий дают пользователям возможность сохранять изменения на
ветке “фиксируя <strong>ревизию</strong>”. Созданная ревизия фактически является сводкой
изменений, которые были сделаны с последнего момента когда дерево было
сохранено.</p>
<p>Эти ревизии имеют также и другое назначение. Например, можно комментировать
ревизии, записав, что значит данный набор изменений, через необязательную
запись в журнале. Реальные записи в журнале могут быть похожи на “Исправлен
Web-шаблон для закрытия таблицы” и “Добавлена поддержка SFTP. Исправлен #595”</p>
<p>Мы храним этот журнал, что бы позже, в случае каких-либо проблем с SFTP, можно
было определить когда могла произойти проблема.</p>
<div class="section" id="id3">
<h3>Чем отличаются распределенные системы<a class="headerlink" href="#id3" title="Ссылка на этот заголовок">¶</a></h3>
<p>Многие системы контроля версий хранят данные на серверах. Если кто-то хочет
работать с кодом, который хранится в системе тогда ему нужно установить
соединение с сервером и “создать рабочую копию” кода. При этом создается
каталог в котором можно менять файлы и затем фиксировать изменения. Клиент
системы затем соединяется с сервером системы и сохраняет изменения. Этот метод
известен как централизованная модель.</p>
<p>Централизованная модель может иметь некоторые недостатки. Централизованная
система требует наличия соединения с сервером для любых действий по контролю
версий. Это может быть проблематичным если сервер находится на другой машине в
интернете, а клиент - нет. Или, хуже, клиент <strong>в</strong> интернете, а сервер - нет.</p>
<p>Распределенные системы контроля версий обходят эту проблему сохраняя ветки на
той же машине на которой находится клиент. В случае с Bazaar, ветка находится в
том же самом месте, что и код хранящийся под контролем версий. Это позволяет
пользователю сохранять (<strong>фиксировать</strong>) изменения когда он захочет – даже без
сетевого подключения. Пользователю нужен доступ к интернету только когда он
хочет получить доступ к чьей-либо ветке в другом месте.</p>
<p>Общее требование, что многие люди хотят отслеживать изменения для каталога,
такие как изменения файлов и изменения в подкаталогах. Отслеживать это
“руками” ужасный процесс, который со временем становится громоздким. До тех пор
пока вы не попробуете систему контроля версий, такую как Bazaar. Такие
инструменты автоматизируют процесс сохранения данных, создавая <strong>ревизии</strong>
дерева каталога когда пользователь запрашивает сделать это.</p>
<p>Системы контроля версий, такие как Bazaar, могут делать намного больше чем
просто хранить изменения и отменять ошибочные действия. Например, с помощью
Bazaar разработчики могут взять изменения кода на одной ветке и объединить их
со связанной веткой – даже если эти изменения хранятся на ветке которую создал
кто-то другой. Это позволяет разработчикам сотрудничать без необходимости
открывать доступ на запись к репозиторию.</p>
<p>Bazaar помнит ‘’предков’’ ревизии: предыдущие ревизии на которых основана
текущая ревизия. Одна ревизия может иметь больше одного прямого потомка, каждый
из которых со своими изменениями, что представляет дивергенцию в эволюции
дерева. Создание веток в Bazaar позволяет нескольким людям сотрудничать в
эволюции проекта, без необходимости работать жестко по шагам. Создание веток
может быть полезным даже для одного разработчика.</p>
</div>
</div>
<div class="section" id="id4">
<h2>Представляемся Bazaar<a class="headerlink" href="#id4" title="Ссылка на этот заголовок">¶</a></h2>
<p>Bazaar устанавливает единственную новую команду, <strong>bzr</strong>. Все возможности
предоставляются через под-команды этой команды. Вы можете просмотреть краткую
справку командой <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">help</span></tt>. Некоторые идеи группируются по темам,
используйте <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">help</span> <span class="pre">topics</span></tt> для списка доступных тем.</p>
<p>Одна из функций системы контроля версий – отслеживать кто сделал изменения. В
распределенных системах для этого требуется идентифицировать каждого автора
уникально в глобальном плане. Большинство людей уже имеют такой идентификатор:
email адрес. Bazaar достаточно умен, что бы автоматически создавать email адрес
из текущего имени и адреса хоста. Если вам не нравится предположение которое
делает Bazaar вы сможете выбрать из трех опций:</p>
<blockquote>
<div><ol class="arabic">
<li><p class="first">Установить email адрес через <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">whoami</span></tt>. Это наиболее простой путь.</p>
<p>Что бы установить такой глобальный идентификатор, используйте:</p>
<div class="highlight-python"><div class="highlight"><pre>% bzr whoami "Ваше Имя <email@example.com>"
</pre></div>
</div>
<p>Если вы хотите использовать разные адреса для разных веток, то зайдите
в каталог с веткой и используйте:</p>
<div class="highlight-python"><div class="highlight"><pre>% bzr whoami --branch "Ваше Имя <email@example.com>"
</pre></div>
</div>
</li>
<li><p class="first">Установить email адрес в <tt class="docutils literal"><span class="pre">~/.bazaar/bazaar.conf</span></tt> <a class="footnote-reference" href="#id6" id="id5">[1]</a>, добавив следующие
строчки. Заметьте, что <tt class="docutils literal"><span class="pre">[DEFAULT]</span></tt> зависит от регистра символов:</p>
<div class="highlight-python"><div class="highlight"><pre>[DEFAULT]
email=Ваше Имя <email@isp.com>
</pre></div>
</div>
<p>Как и выше вы можете переопределить эти установки для каждой ветки
создав секцию для ветки в <tt class="docutils literal"><span class="pre">~/.bazaar/locations.conf</span></tt> и добавив
следующие строчки:</p>
<div class="highlight-python"><div class="highlight"><pre>[/путь/к/ветке]
email=Ваше Имя <email@isp.com>
</pre></div>
</div>
</li>
<li><p class="first">Переопределить два предыдущих способа, установив ваш полный email адрес в
глобальную переменную среды <tt class="docutils literal"><span class="pre">$BZR_EMAIL</span></tt>, или <tt class="docutils literal"><span class="pre">$EMAIL</span></tt> (<tt class="docutils literal"><span class="pre">$BZR_EMAIL</span></tt>
имеет больший приоритет).</p>
</li>
</ol>
</div></blockquote>
<table class="docutils footnote" frame="void" id="id6" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label">[1]</td><td><em>(<a class="fn-backref" href="#id5">1</a>, <a class="fn-backref" href="#id18">2</a>)</em> Для Windows пользовательские файлы конфигурации могут быть найдены в
каталоге с данными приложений. Таким образом вместо
<tt class="docutils literal"><span class="pre">~/.bazaar/branch.conf</span></tt> конфигурация может быть найдена в:
<tt class="docutils literal"><span class="pre">C:\Documents</span> <span class="pre">and</span> <span class="pre">Settings\<пользователь>\Application</span> <span class="pre">Data\Bazaar\2.0\branch.conf</span></tt>. Там же могут
быть найдены <tt class="docutils literal"><span class="pre">locations.conf</span></tt>, <tt class="docutils literal"><span class="pre">ignore</span></tt> и каталог <tt class="docutils literal"><span class="pre">plugins</span></tt>.</td></tr>
</tbody>
</table>
</div>
<div class="section" id="id7">
<h2>Создаем ветку<a class="headerlink" href="#id7" title="Ссылка на этот заголовок">¶</a></h2>
<p>История по-умолчанию хранится на ветке в каталоге .bzr. В будущих версиях
Bazaar будут средства для хранения истории в отдельном репозитории, который
также сможет быть удаленным.</p>
<p>Мы создаем новую ветку выполнив <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">init</span></tt> в уже созданном каталоге:</p>
<div class="highlight-python"><div class="highlight"><pre>% mkdir tutorial
% cd tutorial
% ls -a
./ ../
% pwd
/home/mbp/work/bzr.test/tutorial
%
% bzr init
% ls -aF
./ ../ .bzr/
%
</pre></div>
</div>
<p>Как и в CVS здесь три класса файлов: неизвестные, игнорируемые и под контролем
версий. Команда <strong>add</strong> ставит файл под контроль версий, т.е. изменения в нем
будут записываться системой:</p>
<div class="highlight-python"><div class="highlight"><pre>% echo 'hello world' > hello.txt
% bzr status
unknown:
hello.txt
% bzr add hello.txt
added hello.txt
% bzr status
added:
hello.txt
</pre></div>
</div>
<p>Если вы добавили не тот файл просто сделайте <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">remove</span></tt>, что бы сделать его
опять неизвестным. Рабочая копия файла не будет удалена в этом случае, хотя она
может быть удалена в других случаях <a class="footnote-reference" href="#id9" id="id8">[2]</a>.</p>
<table class="docutils footnote" frame="void" id="id9" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label">[2]</td><td><em>(<a class="fn-backref" href="#id8">1</a>, <a class="fn-backref" href="#id23">2</a>)</em> <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">remove</span></tt> удалит рабочую копию если она находится под контролем
версий, но не имеет изменений с последней зафиксированной версии. Вы
можете оставить файл указав опцию <tt class="docutils literal"><span class="pre">--keep</span></tt> для <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">remove</span></tt>, или
удалить с опцией <tt class="docutils literal"><span class="pre">--force</span></tt>.</td></tr>
</tbody>
</table>
</div>
<div class="section" id="id10">
<h2>Размещение веток<a class="headerlink" href="#id10" title="Ссылка на этот заголовок">¶</a></h2>
<p>Вся история хранится на ветке, которая является всего лишь каталогом на диске
содержащим файлы управления. По-умолчанию здесь нет отдельного репозитория, или
базы данных как в svn, или svk. По желанию вы можете создать репозиторий (см.
команду <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">init-repo</span></tt>). Это можно сделать в случае очень больших веток, или
большого количества веток для проекта среднего размера.</p>
<p>Мы обычно обращаемся к веткам на нашем компьютере просто передав имя каталога
содержащего ветку. bzr также поддерживает доступ к веткам через HTTP и SFTP,
например:</p>
<div class="highlight-python"><div class="highlight"><pre>% bzr log http://bazaar.launchpad.net/~bzr-pqm/bzr/bzr.dev/
% bzr log sftp://bazaar.launchpad.net/~bzr-pqm/bzr/bzr.dev/
</pre></div>
</div>
<p>Установив для bzr плагины можно также осуществлять доступ к веткам с
использованием rsync.</p>
<p>Смотрите секцию <a class="reference internal" href="#id27">Публикация ветки</a> что бы получить больше информации о том как
поместить свою ветку в нужное место.</p>
</div>
<div class="section" id="id11">
<h2>Просмотр изменений<a class="headerlink" href="#id11" title="Ссылка на этот заголовок">¶</a></h2>
<p>Как только вы закончили свою работу, вы захотите <strong>зафиксировать</strong> ее в истории
ревизий. Хорошая практика фиксировать изменения достаточно часто: когда
заработала новая функциональность, исправлена ошибка, или улучшен код, или
документация. При этом стоит проверить, что код компилируется и проходит все
тесты перед фиксацией, что бы быть уверенным, что каждая ревизия в хорошем
состоянии. Также можно просмотреть свои изменения, для уверенности, что вы
фиксируете именно то, что хотели и получить шанс проверить свою работу перед
тем как записать ее постоянно.</p>
<p>Две команды bzr особенно полезны здесь: <strong>status</strong> и <strong>diff</strong>.</p>
<div class="section" id="bzr-status">
<h3>bzr status<a class="headerlink" href="#bzr-status" title="Ссылка на этот заголовок">¶</a></h3>
<p>Команда <strong>status</strong> показывает какие изменения были сделаны в рабочем каталоге
с момента последней ревизии:</p>
<div class="highlight-python"><div class="highlight"><pre>% bzr status
modified:
foo
</pre></div>
</div>
<p><tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">status</span></tt> скрывает “неинтересные” файлы которые, либо не менялись, либо
игнорируются. Также команде status могут быть переданы необязательные имена
файлов, или каталогов для проверки.</p>
</div>
<div class="section" id="bzr-diff">
<h3>bzr diff<a class="headerlink" href="#bzr-diff" title="Ссылка на этот заголовок">¶</a></h3>
<p>Команда <strong>diff</strong> показывает изменения в тексте файлов в стандартном формате
diff. Вывод этой команды может быть передан другим командам, таким как
‘’patch’‘, ‘’diffstat’‘, ‘’filterdiff’’ и ‘’colordiff’‘:</p>
<div class="highlight-python"><div class="highlight"><pre>% bzr diff
=== added file 'hello.txt'
--- hello.txt 1970-01-01 00:00:00 +0000
+++ hello.txt 2005-10-18 14:23:29 +0000
@@ -0,0 +1,1 @@
+hello world
</pre></div>
</div>
<p>С опцией <tt class="docutils literal"><span class="pre">-r</span></tt> дерево файлов сравнивается с ранней ревизией, или показываются
изменения между двумя ревизиями:</p>
<div class="highlight-python"><div class="highlight"><pre>% bzr diff -r 1000.. # изменения начиная с r1000
% bzr diff -r 1000..1100 # изменения c 1000 до 1100
</pre></div>
</div>
<p>Опция <tt class="docutils literal"><span class="pre">--diff-options</span></tt> говорит bzr запустить внешнюю программу diff, передав
ей опции. Например:</p>
<div class="highlight-python"><div class="highlight"><pre>% bzr diff --diff-options --side-by-side foo
</pre></div>
</div>
<p>Некоторые проекты предпочитают показывать префиксы в начале текста изменений
для старых (old) и новых (new) файлов. Опция <tt class="docutils literal"><span class="pre">--prefix</span></tt> может быть
использована для установки такого префикса. Плюс к этому команда <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">diff</span>
<span class="pre">-p1</span></tt> выводит префиксы в форме которая подходит для команды <tt class="docutils literal"><span class="pre">patch</span> <span class="pre">-p1</span></tt>.</p>
</div>
</div>
<div class="section" id="id12">
<h2>Фиксация изменений<a class="headerlink" href="#id12" title="Ссылка на этот заголовок">¶</a></h2>
<p>Когда состояние рабочего дерева подходит для сохранения оно может быть
<strong>зафиксировано</strong> на ветке, что создаст новую ревизию содержащую снимок
состояния дерева.</p>
<div class="section" id="bzr-commit">
<h3>bzr commit<a class="headerlink" href="#bzr-commit" title="Ссылка на этот заголовок">¶</a></h3>
<p>Команде <strong>commit</strong> можно передать сообщение описывающее изменения в ревизии.
Она также записывает идентификатор пользователя, текущее время и временную
зону, плюс список измененных файлов и их содержимого. Сообщение описывающее
изменения определяется через опцию <tt class="docutils literal"><span class="pre">-m</span></tt>, или <tt class="docutils literal"><span class="pre">--message</span></tt>. Можно также
вводить сообщения состоящие из нескольких строк; в большинстве оболочек вы
можете сделать это оставив открытую кавычку в конце строки.</p>
<div class="highlight-python"><div class="highlight"><pre>% bzr commit -m "добавлен первый файл"
</pre></div>
</div>
<p>Также можно использовать опцию <tt class="docutils literal"><span class="pre">-F</span></tt>, для получения сообщения из файла.
Некоторые люди делают заметки изменений во время работы над ними, а затем
просматривают изменения, что бы быть уверенными, что они сделали то, что хотели
сделать. (Этот файл может быть также полезен когда вы возвращаетесь к своей
работе после перерыва.)</p>
</div>
</div>
<div class="section" id="id13">
<h2>Сообщение из текстового редактора<a class="headerlink" href="#id13" title="Ссылка на этот заголовок">¶</a></h2>
<p>Если вы не используете опции <tt class="docutils literal"><span class="pre">-m</span></tt> и <tt class="docutils literal"><span class="pre">-F</span></tt> тогда bzr откроет текстовый
редактор для ввода сообщения. Какой редактор запускать может быть настроено
через переменные среды <tt class="docutils literal"><span class="pre">$VISUAL</span></tt>, или <tt class="docutils literal"><span class="pre">$EDITOR</span></tt>, которые могут быть
переопределены опцией <tt class="docutils literal"><span class="pre">editor</span></tt> в файле <tt class="docutils literal"><span class="pre">~/.bazaar/bazaar.conf</span></tt>; опция
<tt class="docutils literal"><span class="pre">$BZR_EDITOR</span></tt> переопределяет все описанные выше настройки. Если вы выходите
из редактора без каких-либо изменений, то фиксация будет прервана.</p>
<p>Файл который открывается в редакторе содержит горизонтальную линию. Часть файла
ниже этой линии включена только для информации и не будет частью сообщения об
изменениях. Ниже линии показывается список файлов которые были изменены. Для
создания сообщения вам надо написать свое сообщение выше линии, сохранить его и
выйти из редактора.</p>
<p>Если вы хотите увидеть изменения содержимого файлов которые будут
зафиксированы, при редактировании сообщения вам нужно указать опцию
<tt class="docutils literal"><span class="pre">--show-diff</span></tt> для команды <tt class="docutils literal"><span class="pre">commit</span></tt>. Эта опция добавит изменения в файл
который будет открыт в редакторе ниже линии и списка измененных файлов. Это
значит, что вы можете читать изменения при редактировании сообщения, но они не
будут включены в сообщение когда вы закончите редактировать. Если вы хотите,
что бы части изменений были включены в сообщение вы можете скопировать и
вставить их выше ограничительной линии.</p>
<div class="section" id="id14">
<h3>Выборочная фиксация<a class="headerlink" href="#id14" title="Ссылка на этот заголовок">¶</a></h3>
<p>Если вы передадите список имен файлов, или каталогов после команды commit, то
будут зафиксированы только изменения для переданных объектов. Например:</p>
<div class="highlight-python"><div class="highlight"><pre>% bzr commit -m "исправления документации" commit.py
</pre></div>
</div>
<p>По умолчанию bzr всегда фиксирует все изменения для дерева, даже если запущен
из подкаталога. Что бы зафиксировать только изменения от текущего каталога
и ниже, используйте:</p>
<div class="highlight-python"><div class="highlight"><pre>% bzr commit .
</pre></div>
</div>
</div>
</div>
<div class="section" id="id15">
<h2>Удаление не зафиксированных изменений<a class="headerlink" href="#id15" title="Ссылка на этот заголовок">¶</a></h2>
<p>Если вы сделали какие-либо изменения и не хотите оставлять их, используйте
команду <strong>revert</strong>, что бы вернутся к состоянию предыдущей ревизии. Хорошая
идея, использовать сначала <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">diff</span></tt> для просмотра изменений. По умолчанию
команда revert отменяет изменения на всем дереве, но если ей переданы имена
файлов, или каталогов то будут затронуты только они. <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">revert</span></tt> также
очищает список ревизий ожидающих объединения.</p>
</div>
<div class="section" id="id16">
<h2>Игнорирование файлов<a class="headerlink" href="#id16" title="Ссылка на этот заголовок">¶</a></h2>
<p>Многие деревья с исходным кодом содержат файлы которые не нужно хранить под
контролем версий, например резервные файлы текстового редактора, объектные
файлы и собранные программы. Вы можете просто не добавлять их, но они всегда
будут обнаруживаться как неизвестные. Вы также можете сказать bzr игнорировать
их добавив их в файл <tt class="docutils literal"><span class="pre">.bzrignore</span></tt> в корне рабочего дерева.</p>
<p>Этот файл содержит список шаблонов файлов, по одному в каждой строчке. Обычное
содержимое может быть таким:</p>
<div class="highlight-python"><div class="highlight"><pre>*.o
*~
*.tmp
*.py[co]
</pre></div>
</div>
<p>Если шаблон содержит слеш, то он будет сопоставлен с полным путем начиная от
корня рабочего дерева; иначе он сопоставляется только с именем файла. Таким
образом пример выше игнорирует файлы с расширением <tt class="docutils literal"><span class="pre">.o</span></tt> во всех
подкаталогах, но пример ниже игнорирует только <tt class="docutils literal"><span class="pre">config.h</span></tt> в корне рабочего
дерева и HTML файлы в каталоге <tt class="docutils literal"><span class="pre">doc/</span></tt>:</p>
<div class="highlight-python"><div class="highlight"><pre>./config.h
doc/*.html
</pre></div>
</div>
<p>Для получения списка файлов которые игнорируются и соответствующих им шаблонов
используйте команду <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">ignored</span></tt>:</p>
<div class="highlight-python"><div class="highlight"><pre>% bzr ignored
config.h ./config.h
configure.in~ *~
</pre></div>
</div>
<p>Нет проблем если шаблон для игнорирования подходит для файла под контролем
версий, или вы добавили файл который игнорируется. Шаблоны не имеют никакого
эффекта на файлы под контролем версий, они только определяют показываются
неизвестные файлы, или просто игнорируются.</p>
<p>Файл <tt class="docutils literal"><span class="pre">.bzrignore</span></tt> обычно должен быть под контролем версий, что бы новые копии
ветки видели такие же шаблоны:</p>
<div class="highlight-python"><div class="highlight"><pre>% bzr add .bzrignore
% bzr commit -m "Добавлены шаблоны для игнорирования"
</pre></div>
</div>
<div class="section" id="id17">
<h3>Глобальные шаблоны для игнорирования<a class="headerlink" href="#id17" title="Ссылка на этот заголовок">¶</a></h3>
<p>Обычно есть файлы которые нужно игнорировать и они не специфичны для отдельных
проектов, а скорее специфичны для пользователя. Например, временные файлы
текстового редактора, или персональные временные файлы. Вместо того, что бы
добавлять их для игнорирования в каждом проекте, bzr поддерживает глобальный
файл игнорирования <tt class="docutils literal"><span class="pre">~/.bazaar/ignore</span></tt> <a class="footnote-reference" href="#id6" id="id18">[1]</a>. Он имеет такой же синтаксис, что
и файл игнорирования для каждого проекта.</p>
</div>
</div>
<div class="section" id="id19">
<h2>Просмотр истории<a class="headerlink" href="#id19" title="Ссылка на этот заголовок">¶</a></h2>
<div class="section" id="bzr-log">
<h3>bzr log<a class="headerlink" href="#bzr-log" title="Ссылка на этот заголовок">¶</a></h3>
<p>Команда <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">log</span></tt> показывает список предыдущих ревизий. Команда <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">log</span>
<span class="pre">--forward</span></tt> делает тоже самое, но в хронологическом порядке, показывая более
поздние ревизии в конце.</p>
<p>Как и <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">diff</span></tt>, <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">log</span></tt> поддерживает опцию <tt class="docutils literal"><span class="pre">-r</span></tt>:</p>
<div class="highlight-python"><div class="highlight"><pre>% bzr log -r 1000.. # Ревизия 1000 и все после нее
% bzr log -r ..1000 # Все до и включая r1000
% bzr log -r 1000..1100 # изменения с 1000 до 1100
% bzr log -r 1000 # Изменения только для ревизии 1000
</pre></div>
</div>
</div>
</div>
<div class="section" id="id20">
<h2>Статистика ветки<a class="headerlink" href="#id20" title="Ссылка на этот заголовок">¶</a></h2>
<p>Команда <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">info</span></tt> показывает суммарную информацию о рабочем дереве и истории
на ветке.</p>
</div>
<div class="section" id="id21">
<h2>Каталоги под контролем версий<a class="headerlink" href="#id21" title="Ссылка на этот заголовок">¶</a></h2>
<p>bzr может контролировать файлы и каталоги, отслеживая переименования и
упрощая их последующее объединение:</p>
<div class="highlight-python"><div class="highlight"><pre>% mkdir src
% echo 'int main() {}' > src/simple.c
% bzr add src
added src
added src/simple.c
% bzr status
added:
src/
src/simple.c
</pre></div>
</div>
</div>
<div class="section" id="id22">
<h2>Удаление файлов<a class="headerlink" href="#id22" title="Ссылка на этот заголовок">¶</a></h2>
<p>Вы можете удалить файл, или каталог из под контроля версий просто удалив их
из рабочего каталога. Это немного отличается от CVS, которая требует что бы вы
также сделали <tt class="docutils literal"><span class="pre">cvs</span> <span class="pre">remove</span></tt>.</p>
<p><tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">remove</span></tt> удаляет файл из под контроля версий, но может и не удалять
рабочую копию файла <a class="footnote-reference" href="#id9" id="id23">[2]</a>. Это удобно когда вы добавили не тот файл, или решили,
что файл на самом деле не должен быть под контролем версий.</p>
<div class="highlight-python"><div class="highlight"><pre>% rm -r src
% bzr remove -v hello.txt
? hello.txt
% bzr status
removed:
hello.txt
src/
src/simple.c
unknown:
hello.txt
</pre></div>
</div>
<p>Если вы вдруг удалили не тот файл, то вы можете использовать <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">revert</span></tt> что
бы восстановить его.</p>
</div>
<div class="section" id="id24">
<h2>Ветвление<a class="headerlink" href="#id24" title="Ссылка на этот заголовок">¶</a></h2>
<p>Часто вместо того что бы начинать свой собственный проект, вы хотите предложить
изменения для уже готового проекта. Что бы сделать это вам нужно получить копию
готовой ветки. Так как эта копия может быть потенциальной новой веткой эта
команда называется <strong>branch</strong>:</p>
<div class="highlight-python"><div class="highlight"><pre>% bzr branch lp:bzr bzr.dev
% cd bzr.dev
</pre></div>
</div>
<p>Эта команда копирует полную историю ветки и после этого вы можете делать все
операции с ней локально: просматривать журнал, создавать и объединять другие
ветки. Здесь также есть опция для получения только части истории если это
необходимо.</p>
<p>Копию другой ветки можно также получить просто скопировав ее каталог,
развернув архив, или скопировав удаленно через такую утилиту как rsync.</p>
</div>
<div class="section" id="id25">
<h2>Следование за изменениями основного проекта<a class="headerlink" href="#id25" title="Ссылка на этот заголовок">¶</a></h2>
<p>Вы можете обновлять свою ветку из родительской через получение ее изменений:</p>
<div class="highlight-python"><div class="highlight"><pre>% bzr pull
</pre></div>
</div>
<p>После этого локальный каталог будет копией родительского. Это включает и
‘’историю ревизий’’ - список изменений сделанных на родительской ветке, а не
объединенных с других веток.</p>
<p>Эта команда работает только если локальная ветка, либо более старая копия
родительской ветки без новых фиксаций, либо все последние фиксации уже были
объединены с родительской веткой.</p>
</div>
<div class="section" id="id26">
<h2>Объединение со связанных веток<a class="headerlink" href="#id26" title="Ссылка на этот заголовок">¶</a></h2>
<p>Если две ветки разошлись (обе имеют уникальные изменения) тогда <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">merge</span></tt> -
это подходящая команда для использования. Объединение автоматически вычислит
изменения которые существуют на объединяемой ветке и отсутствуют в локальной
ветке и попытается объединить их с локальной веткой.</p>
<div class="highlight-python"><div class="highlight"><pre>% bzr merge URL
</pre></div>
</div>
<p>В случае конфликта при объединении будут созданы три файла с одними именем, но
разными расширениями. Файл с общими изменениями будет с расширением ”.BASE”,
файл с локальными изменениями будет с расширением ”.THIS” и файл с изменениями
из объединяемой ветки будет с расширением ”.OTHER”. Используя такую программу
как kdiff3 вы теперь сможете достаточно легко объединить их в один файл. Для
фиксации изменений вам нужно переименовать объединенный файл (”.THIS”) в файл с
оригинальным именем. И для завершения исправления конфликта нужно использовать
команду resolve, которая удалит файлы ”.OTHER” и ”.BASE”. Команда commit будет
выдавать ошибку пока существует один из файлов с расширением .BASE, .THIS, или
.OTHER.</p>
<div class="highlight-python"><div class="highlight"><pre>% kdiff3 file.BASE file.OTHER file.THIS
% mv file.THIS file
% bzr resolve file
</pre></div>
</div>
<p>[<strong>TODO</strong>: описать маркеры конфликтов внутри файлов]</p>
</div>
<div class="section" id="id27">
<h2>Публикация ветки<a class="headerlink" href="#id27" title="Ссылка на этот заголовок">¶</a></h2>
<p>Для публикации ветки bzr вам не нужен специализированный сервер, нужен просто
обычный Web-сервер. Просто перенесите файлы на ваш сервер, включая каталог
.bzr. Можно опубликовать ветку (или изменения на ветке) одним из следующих трех
способов:</p>
<ul>
<li><p class="first">Лучший способ - использовать для этого сам bzr.</p>
<div class="highlight-python"><div class="highlight"><pre>% bzr push sftp://servername.com/path/to/directory
</pre></div>
</div>
<p>(Каталог назначения должна быть создан заранее, если только не указана
опция <tt class="docutils literal"><span class="pre">--create-prefix</span></tt>)</p>
</li>
<li><p class="first">Другой способ - плагин <tt class="docutils literal"><span class="pre">rspush</span></tt> который включен в BzrTools и использует
rsync для публикации изменений в истории ревизий и рабочем дереве.</p>
</li>
<li><p class="first">Вы также можете скопировать файлы руками, переслав архив, или используя
rsync, или другой метод пересылки. Обычно это менее безопасно чем
использовать команду <tt class="docutils literal"><span class="pre">push</span></tt>, но может быть быстрее и проще в каких-то
ситуациях.</p>
</li>
</ul>
</div>
<div class="section" id="id28">
<h2>Перемещение изменений между деревьями<a class="headerlink" href="#id28" title="Ссылка на этот заголовок">¶</a></h2>
<p>Это случается и с лучшими из нас: в какой-то момент вы делаете изменения не в
том дереве файлов. Возможно потому, что вы случайно начали работать не в том
каталоге, либо изменений оказались больше чем вы ожидали и вы решили создать
для них новую ветку.</p>
<p>Для перемещения изменений из одного дерева в другое используйте</p>
<div class="highlight-python"><div class="highlight"><pre>% cd NEWDIR
% bzr merge --uncommitted OLDDIR
</pre></div>
</div>
<p>Эта команда перенесет все не зафиксированные изменения с ветки OLDDIR на ветку
NEWDIR. Команда не будет переносить зафиксированные изменения, даже если они
могли бы быть объединены с NEWDIR обычным объединением. Изменения также
остаются и в OLDDIR, но вы можете использовать <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">revert</span> <span class="pre">OLDDIR</span></tt> для их
удаления, как-то только убедитесь, что с NEWDIR все нормально.</p>
<p>NEWDIR не обязательно должен быть копией OLDDIR, но они должны быть связанными
ветками. Чем больше они отличаются, тем больше шанс возникновения конфликтов.</p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3><a href="../index.html">Оглавление</a></h3>
<ul>
<li><a class="reference internal" href="#">Учебник Bazaar</a><ul>
<li><a class="reference internal" href="#id1">Введение</a></li>
<li><a class="reference internal" href="#id2">Назначение контроля версий</a><ul>
<li><a class="reference internal" href="#id3">Чем отличаются распределенные системы</a></li>
</ul>
</li>
<li><a class="reference internal" href="#id4">Представляемся Bazaar</a></li>
<li><a class="reference internal" href="#id7">Создаем ветку</a></li>
<li><a class="reference internal" href="#id10">Размещение веток</a></li>
<li><a class="reference internal" href="#id11">Просмотр изменений</a><ul>
<li><a class="reference internal" href="#bzr-status">bzr status</a></li>
<li><a class="reference internal" href="#bzr-diff">bzr diff</a></li>
</ul>
</li>
<li><a class="reference internal" href="#id12">Фиксация изменений</a><ul>
<li><a class="reference internal" href="#bzr-commit">bzr commit</a></li>
</ul>
</li>
<li><a class="reference internal" href="#id13">Сообщение из текстового редактора</a><ul>
<li><a class="reference internal" href="#id14">Выборочная фиксация</a></li>
</ul>
</li>
<li><a class="reference internal" href="#id15">Удаление не зафиксированных изменений</a></li>
<li><a class="reference internal" href="#id16">Игнорирование файлов</a><ul>
<li><a class="reference internal" href="#id17">Глобальные шаблоны для игнорирования</a></li>
</ul>
</li>
<li><a class="reference internal" href="#id19">Просмотр истории</a><ul>
<li><a class="reference internal" href="#bzr-log">bzr log</a></li>
</ul>
</li>
<li><a class="reference internal" href="#id20">Статистика ветки</a></li>
<li><a class="reference internal" href="#id21">Каталоги под контролем версий</a></li>
<li><a class="reference internal" href="#id22">Удаление файлов</a></li>
<li><a class="reference internal" href="#id24">Ветвление</a></li>
<li><a class="reference internal" href="#id25">Следование за изменениями основного проекта</a></li>
<li><a class="reference internal" href="#id26">Объединение со связанных веток</a></li>
<li><a class="reference internal" href="#id27">Публикация ветки</a></li>
<li><a class="reference internal" href="#id28">Перемещение изменений между деревьями</a></li>
</ul>
</li>
</ul>
<h4>Предыдущий раздел</h4>
<p class="topless"><a href="../mini-tutorial/index.html"
title="предыдущая глава">Bazaar за пять минут</a></p>
<h4>Следующий раздел</h4>
<p class="topless"><a href="using_bazaar_with_launchpad.html"
title="следующая глава">1 Использование Bazaar с Launchpad</a></p>
<h3>Эта страница</h3>
<ul class="this-page-menu">
<li><a href="../_sources/tutorials/tutorial.txt"
rel="nofollow">Исходный текст</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Быстрый поиск</h3>
<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>
<p class="searchtip" style="font-size: 90%">
Введите слова для поиска или имя модуля, класса или функции.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Навигация</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="using_bazaar_with_launchpad.html" title="1 Использование Bazaar с Launchpad"
>вперёд</a></li>
<li class="right" >
<a href="../mini-tutorial/index.html" title="Bazaar за пять минут"
>назад</a> |</li>
<li><a href="http://bazaar.canonical.com/">
<img src="../_static/bzr icon 16.png" /> Главная</a> | </li>
<a href="http://doc.bazaar.canonical.com/ru/">Документация</a> | </li>
<li><a href="../index.html">Содержание (2.6.0)</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2009-2011 Canonical Ltd.
Создано с помощью <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.3.
</div>
</body>
</html>
distrib
>
Mageia
>
5
>
x86_64
>
media
>
core-release
>
by-pkgid
>
4c66e4a74400d106ea54ec458e4c006c
>
files
>
3446
