~bzr-pqm/bzr/bzr.dev : revision 3638.6.38

36

случалось с вами, то вы возможно готовы для Bazaar.

37

38

Системы контроля версий, такие как Bazaar дают возможность отслеживать

39

изменения для директории, которую они изменяют в нечто более сложное, что

40

называется **ветка**. Ветка не только сохраняет как директория выглядит в

41

данный момент, но также как она выглядела в различные моменты в прошлом. Затем,

39

изменения для каталога, который они изменяют в нечто более сложное, что

40

называется **ветка**. Ветка не только сохраняет то как каталог выглядит в

41

данный момент, но также как он выглядел в различные моменты в прошлом. Затем,

42

когда вы сделаете что-то, что бы вы не хотели делать, вы сможете восстановить

43

директорию в том виде как она выглядела в какой-то момент в прошлом.

43

каталог в том виде как он выглядел в какой-то момент в прошлом.

44

45

Системы контроля версий дают пользователям возможность сохранять изменения на

46

ветке "фиксируя **ревизию**". Созданная ревизия фактически является сводкой

61

Многие системы контроля версий хранят данные на серверах. Если кто-то хочет

62

работать с кодом, который хранится в системе тогда ему нужно установить

63

соединение с сервером и "создать рабочую копию" кода. При этом создается

64

директорий в котором можно менять файлы и затем фиксировать изменения. Клиент

64

каталог в котором можно менять файлы и затем фиксировать изменения. Клиент

65

системы затем соединяется с сервером системы и сохраняет изменения. Этот метод

66

известен как централизованная модель.

67

77

сетевого подключения. Пользователю нужен доступ к интернету только когда он

78

хочет получить доступ к чьей-либо ветке в другом месте.

79

80

Общее требование, что многие люди хотят отслеживать изменения для директории,

81

такие как изменения файлов и изменения в поддиректориях. Отслеживать это

80

Общее требование, что многие люди хотят отслеживать изменения для каталога,

81

такие как изменения файлов и изменения в подкаталогах. Отслеживать это

82

"руками" ужасный процесс, который со временем становится громоздким. До тех пор

83

пока вы не попробуете систему контроля версий, такую как Bazaar. Такие

84

инструменты автоматизируют процесс сохранения данных создавая **ревизии**

85

дерева директории когда пользователь запрашивает сделать это.

84

инструменты автоматизируют процесс сохранения данных, создавая **ревизии**

85

дерева каталога когда пользователь запрашивает сделать это.

86

87

Системы контроля версий, такие как Bazaar, могут делать намного больше чем

88

просто хранить изменения и отменять ошибочные действия. Например, с помощью

120

% bzr whoami "Ваше Имя <email@example.com>"

121

122

Если вы хотите использовать разные адреса для разных веток, то зайдите

123

в директорию с веткой и используйте::

123

в каталог с веткой и используйте::

124

125

% bzr whoami --branch "Ваше Имя <email@example.com>"

126

142

имеет больший приоритет).

143

144

.. [1] Для Windows пользовательские файлы конфигурации могут быть найдены в

145

директории с данными приложений. Таким образом вместо

145

каталоге с данными приложений. Таким образом вместо

146

``~/.bazaar/branch.conf`` конфигурация может быть найдена в:

147

``C:\Documents and Settings\<пользователь>\Application Data\Bazaar\2.0\branch.conf``. Там же могут

148

быть найдены ``locations.conf``, ``ignore`` и директория ``plugins``.

148

быть найдены ``locations.conf``, ``ignore`` и каталог ``plugins``.

149

150

Создаем ветку

151

=============

152

153

История по-умолчанию хранится на ветке в директории .bzr. В будущих версиях

153

История по-умолчанию хранится на ветке в каталоге .bzr. В будущих версиях

154

Bazaar будут средства для хранения истории в отдельном репозитории, который

155

также сможет быть удаленным.

156

157

Мы создаем новую ветку выполнив ``bzr init`` в уже созданной директории::

157

Мы создаем новую ветку выполнив ``bzr init`` в уже созданном каталоге::

158

159

% mkdir tutorial

160

% cd tutorial

194

Размещение веток

195

================

196

197

Вся история хранится на ветке, которая является всего лишь директорией на диске

198

содержащей файлы управления. По-умолчанию здесь нет отдельного репозитория, или

197

Вся история хранится на ветке, которая является всего лишь каталогом на диске

198

содержащим файлы управления. По-умолчанию здесь нет отдельного репозитория, или

199

базы данных как в svn, или svk. По желанию вы можете создать репозиторий (см.

200

команду ``bzr init-repo``). Это можно сделать в случае очень больших веток, или

201

большого количества веток для проекта среднего размера.

202

203

Мы обычно обращаемся к веткам на нашем компьютере просто передав имя директории

204

содержащей ветку. bzr также поддерживает доступ к веткам через http и sftp,

203

Мы обычно обращаемся к веткам на нашем компьютере просто передав имя каталога

204

содержащего ветку. bzr также поддерживает доступ к веткам через http и sftp,

205

например::

206

207

% bzr log http://bazaar-vcs.org/bzr/bzr.dev/

230

bzr status

231

----------

232

233

Команда **status** показывает какие изменения были сделаны в рабочей директории

233

Команда **status** показывает какие изменения были сделаны в рабочем каталоге

234

с момента последней ревизии::

235

236

% bzr status

239

240

``bzr status`` скрывает "неинтересные" файлы которые, либо не менялись, либо

241

игнорируются. Также команде status могут быть переданы необязательные имена

242

файлов, или директорий для проверки.

242

файлов, или каталогов для проверки.

243

244

bzr diff

245

--------

326

Выборочная фиксация

327

-------------------

328

329

Если вы передадите список имен файлов, или директорий после команды commit, то

329

Если вы передадите список имен файлов, или каталогов после команды commit, то

330

будут зафиксированы только изменения для переданных объектов. Например::

331

332

% bzr commit -m "исправления документации" commit.py

333

334

По умолчанию bzr всегда фиксирует все изменения для дерева, даже если запущен

335

из под-директории. Что бы зафиксировать только изменения от текущей директории

335

из подкаталога. Что бы зафиксировать только изменения от текущего каталога

336

и ниже, используйте::

337

338

% bzr commit .

345

команду **revert**, что бы вернутся к состоянию предыдущей ревизии. Хорошая

346

идея, использовать сначала ``bzr diff`` для просмотра изменений. По умолчанию

347

команда revert отменяет изменения на всем дереве, но если ей переданы имена

348

файлов, или директорий то будут затронуты только они. ``bzr revert`` также

348

файлов, или каталогов то будут затронуты только они. ``bzr revert`` также

349

очищает список ревизий ожидающих объединения.

350

351

Игнорирование файлов

368

Если шаблон содержит слеш, то он будет сопоставлен с полным путем начиная от

369

корня рабочего дерева; иначе он сопоставляется только с именем файла. Таким

370

образом пример выше игнорирует файлы с расширением ``.o`` во всех

371

под-директориях, но пример ниже игнорирует только ``config.h`` в корне рабочего

372

дерева и HTML файлы в директории ``doc/``::

371

подкаталогах, но пример ниже игнорирует только ``config.h`` в корне рабочего

372

дерева и HTML файлы в каталоге ``doc/``::

373

374

./config.h

375

doc/*.html

429

на ветке.

430

431

432

Директории под контролем версий

433

===============================

432

Каталоги под контролем версий

433

=============================

434

435

bzr может контролировать файлы и директории, отслеживая переименования и

435

bzr может контролировать файлы и каталоги, отслеживая переименования и

436

упрощая их последующее объединение::

437

438

% mkdir src

449

Удаление файлов

450

===============

451

452

Вы можете удалить файл, или директорию из под контроля версий просто удалив их

453

из рабочей директории. Это немного отличается от CVS, которая требует что бы вы

452

Вы можете удалить файл, или каталог из под контроля версий просто удалив их

453

из рабочего каталога. Это немного отличается от CVS, которая требует что бы вы

454

также сделали ``cvs remove``.

455

456

``bzr remove`` удаляет файл из под контроля версий, но может и не удалять

490

ветки. Здесь также есть опция для получения только части истории если это

491

необходимо.

492

493

Копию другой ветки можно также получить просто скопировав ее директорию,

493

Копию другой ветки можно также получить просто скопировав ее каталог,

494

развернув архив, или скопировав удаленно через такую утилиту как rsync.

495

496

501

502

% bzr pull

503

504

После этого локальная директория будет копией родительской. Это включает и

504

После этого локальный каталог будет копией родительского. Это включает и

505

''историю ревизий'' - список изменений сделанных на родительской ветке, а не

506

объединенных с других веток.

507

545

================

546

547

Для публикации ветки bzr вам не нужен специализированный сервер, нужен просто

548

обычный Web-сервер. Просто перенесите файлы на ваш сервер, включая директорию

548

обычный Web-сервер. Просто перенесите файлы на ваш сервер, включая каталог

549

.bzr. Можно опубликовать ветку (или изменения на ветке) одним из следующих трех

550

способов:

551

555

556

% bzr push sftp://servername.com/path/to/directory

557

558

(Директория назначения должна быть создана заранее, если только не указана

558

(Каталог назначения должна быть создан заранее, если только не указана

559

опция ``--create-prefix``)

560

561

* Другой способ - плагин ``rspush`` который включен в BzrTools и использует

570

=====================================

571

572

Это случается и с лучшими из нас: в какой-то момент вы делаете изменения не в

573

том дереве файлов. Возможно потому, что вы случайно начали работать не в той

574

директории, либо изменения оказались больше чем вы ожидали и вы решили создать

573

том дереве файлов. Возможно потому, что вы случайно начали работать не в том

574

каталоге, либо изменений оказались больше чем вы ожидали и вы решили создать

575

для них новую ветку.

576

577

Для перемещения изменений из одного дерева в другое используйте