/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/en/user-guide/using_checkouts.txt

  • Committer: Marius Kruger
  • Date: 2010-07-10 21:28:56 UTC
  • mto: (5384.1.1 integration)
  • mto: This revision was merged to the branch mainline in revision 5385.
  • Revision ID: marius.kruger@enerweb.co.za-20100710212856-uq4ji3go0u5se7hx
* Update documentation
* add NEWS

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/using_checkouts.txt
7
7
If you have a local branch and wish to make it a checkout, use the
8
8
``bind`` command like this::
9
9
 
10
 
  brz bind bzr+ssh://centralhost/srv/brz/PROJECT/trunk
 
10
  bzr bind sftp://centralhost/srv/bzr/PROJECT/trunk
11
11
 
12
12
This is necessary, for example, after creating a central branch using
13
13
``push`` as illustrated in the previous section.
21
21
If you have a checkout and wish to make it a normal branch, use the
22
22
``unbind`` command like this::
23
23
 
24
 
  brz unbind
 
24
  bzr unbind
25
25
 
26
26
After this, commits will only be applied locally.
27
27
 
34
34
create their local checkout, i.e. the sandbox in which they
35
35
will make their changes.
36
36
 
37
 
Unlike Subversion and CVS, in Breezy the ``checkout`` command creates a
 
37
Unlike Subversion and CVS, in Bazaar the ``checkout`` command creates a
38
38
local full copy of history in addition to creating a working tree holding
39
39
the latest content. This means that operations such as ``diff`` and ``log``
40
40
are fast and can still be used when disconnected from the central location.
42
42
Getting a lightweight checkout
43
43
------------------------------
44
44
 
45
 
While Breezy does its best to efficiently store version history, there
 
45
While Bazaar does its best to efficiently store version history, there
46
46
are occasions when the history is simply not wanted. For example, if your
47
 
team is managing the content of a web site using Breezy with a
 
47
team is managing the content of a web site using Bazaar with a
48
48
central repository, then your release process might be as simple as
49
49
updating a checkout of the content on the public web server. In this
50
50
case, you probably don't want the history downloaded to that location
51
51
as doing so:
52
52
 
53
53
 * wastes disk space holding history that isn't needed there
54
 
 * exposes a Breezy branch that you may want kept private.
 
54
 * exposes a Bazaar branch that you may want kept private.
55
55
 
56
 
To get a history-less checkout in Breezy, use the ``--lightweight``
 
56
To get a history-less checkout in Bazaar, use the ``--lightweight``
57
57
option like this::
58
58
 
59
 
  brz checkout --lightweight bzr+ssh://centralhost/srv/brz/PROJECT/trunk
 
59
  bzr checkout --lightweight sftp://centralhost/srv/bzr/PROJECT/trunk
60
60
 
61
61
Of course, many of the benefits of a normal checkout are lost by doing
62
62
this but that's a tradeoff you can make if and when it makes sense.
76
76
One of the important aspects of working in lockstep with others is
77
77
keeping your checkout up to date with the latest changes made to
78
78
the central branch. Just as you would in Subversion or CVS, you do
79
 
this in Breezy by using the ``update`` command like this::
 
79
this in Bazaar by using the ``update`` command like this::
80
80
 
81
 
  brz update
 
81
  bzr update
82
82
 
83
83
This gets any new revisions available in the bound branch and
84
84
merges your local changes, if any.
87
87
------------------------
88
88
 
89
89
Note that your checkout *must* be up to date with the bound branch
90
 
before running ``commit``. Breezy is actually stricter about this
 
90
before running ``commit``. Bazaar is actually stricter about this
91
91
than Subversion or CVS - you need to be up to date with the full
92
 
tree, not just for the files you've changed. Breezy will ask you
 
92
tree, not just for the files you've changed. Bazaar will ask you
93
93
to run ``update`` if it detects that a revision has been added to
94
94
the central location since you last updated.
95
95