/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to doc/ru/user-guide/stacked.txt

  • Committer: John Arbash Meinel
  • Date: 2009-09-24 18:51:41 UTC
  • mto: (4634.52.3 2.0)
  • mto: This revision was merged to the branch mainline in revision 4716.
  • Revision ID: john@arbash-meinel.com-20090924185141-3gofyxyrmw276rjm
Finish adding CHKInventory as a permutation in per_inventory.

Get the Read tests working. Change the apply_delta tests to be create_by_apply_delta
and implement that functionality on the regular Inventory class.
(just does a .copy() and then apply delta on the result.)

This also required fixing a lot of the tests that never asserted the objects
were valid.
Namely: InventoryFile('file-id', 'name', 'parent-id')
does not generate a fully valid file object, as it has no text_size or text_sha1.


The filter() tests are finally failing, which means I have a chance to
actually fix things via tests.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/ru/user-guide/stacked.txt
 
1
.. _using-stacked-branches:
 
2
 
 
3
Использование стека веток
 
4
=========================
 
5
 
 
6
Что такое ветка в стеке?
 
7
------------------------
 
8
 
 
9
Ветка в стеке - это ветка которая знает как найти ревизии в другой ветке. Ветка
 
10
в стеке хранит только уникальные ревизии, которые при этом быстрее создавать и
 
11
они более эффективны по занимаемому месту. По этим показателям стек веток похож
 
12
на разделяемые репозитории. Конечно стек веток имеет дополнительные
 
13
преимущества:
 
14
 
 
15
* Новая ветка может быть в абсолютно другом месте по сравнению с веткой на
 
16
  которой она основана как стек.
 
17
 
 
18
* Удаление ветки в стеке на самом деле удаляет ревизии (а не оставляет их в
 
19
  разделяемом репозитории).
 
20
 
 
21
* Стек веток более безопасен чем разделяемые репозитории, т.к. репозиторий на
 
22
  котором основан стек может иметь доступ только для чтения для разработчиков
 
23
  которые фиксируют изменения на ветке в стеке.
 
24
 
 
25
Эти преимущества делают стек веток идеальным выбором для различных сценариев,
 
26
включая экспериментальные ветки и сайты с хостингом кода.
 
27
 
 
28
 
 
29
Создание ветки в стеке
 
30
----------------------
 
31
 
 
32
Что бы создать ветку в стеке нужно использовать опцию ``stacked`` для команды
 
33
``branch``. Например::
 
34
 
 
35
  bzr branch --stacked source-url my-dir
 
36
 
 
37
Здесь мы создадим ``my-dir`` как ветку в стеке без локальных ревизий. Если
 
38
определено открытая ветка связанная с ``source-url`` будет использована как
 
39
*основа стека*. Иначе ``source-url`` будет *основой стека*.
 
40
 
 
41
 
 
42
Создание рабочего каталога в стеке
 
43
-----------------------------------
 
44
 
 
45
Поддержка прямого создания рабочего каталога в стеке скоро ожидается. Пока
 
46
для этого требуется два шага:
 
47
 
 
48
1. Создать ветку в стеке, как описано выше.
 
49
 
 
50
2. Конвертировать ветку в рабочий каталог используя либо команду
 
51
   ``reconfigure``, либо команду ``bind``.
 
52
 
 
53
 
 
54
Публикация ветки в стеке
 
55
------------------------
 
56
 
 
57
Многие изменения в большинстве проектов создаются на основе готовых веток,
 
58
таких как *основная линия разработки*, или *текущая стабильная*. Создание новой
 
59
ветки в стеке основанной на таких ветках легко сделать с использованием команды
 
60
``push``::
 
61
 
 
62
  bzr push --stacked-on reference-url my-url
 
63
 
 
64
Эта команда создаст новую ветку ``my-url``, которая будет основана на
 
65
``reference-url`` и содержать только ревизии из текущей ветки, которых еще нет
 
66
на ветке ``reference-url``.
 
67
 
 
68
Если локальная ветка была создана как ветка в стеке то мы можем использовать
 
69
опцию ``--stacked`` для команды ``push`` и тогда ветка на которой будет основан
 
70
стек будет задана неявно. Например::
 
71
 
 
72
  bzr branch --stacked source-url my-dir
 
73
  cd my-dir
 
74
  (меняем, меняем, меняем)
 
75
  bzr commit -m "исправление ошибки"
 
76
  bzr push --stacked
 
77
 
 
78
 
 
79
Ограничения веток в стеке
 
80
-------------------------
 
81
 
 
82
Важная вещь которую надо запомнить в отношении веток в стеке - ветка на которой
 
83
основан стек должна быть доступна практически для всех операций. Конечно это не
 
84
проблема если обе ветки локальные, или находятся на одном сервере.