← Back to branch summary

~bzr/ubuntu/lucid/bzr/beta-ppa

« back to all changes in this revision

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

  • Committer: Martin Pool
  • Date: 2010-07-02 07:29:40 UTC
  • mfrom: (129.1.7 packaging-karmic)
  • Revision ID: mbp@sourcefrog.net-20100702072940-hpzq5elg8wjve8rh
http://bugs.debian.org/452024
http://bugs.debian.org/464688
http://bugs.debian.org/523595
http://bugs.debian.org/526233
http://bugs.debian.org/537708
http://bugs.debian.org/555336
http://bugs.debian.org/555343
https://launchpad.net/bugs/249452
https://launchpad.net/bugs/385074
* PPA rebuild.
* PPA rebuild for Karmic.
* PPA rebuild for Jaunty.
* PPA rebuild for Hardy.
* From postinst, actually remove the example bash completion scripts.
  (LP: #249452)
* New upstream release.
* New upstream release.
* New upstream release.
* Revert change to Build-depends: Dapper does not have python-central.
  Should be python-support..
* Target ppa..
* Target ppa..
* Target ppa..
* Target ppa..
* New upstream release.
* Switch to dpkg-source 3.0 (quilt) format.
* Bump standards version to 3.8.4.
* Remove embedded copy of python-configobj. Closes: #555336
* Remove embedded copy of python-elementtree. Closes: #555343
* Change section from 'Devel' to 'Vcs'..
* Change section from 'Devel' to 'Vcs'..
* Change section from 'Devel' to 'Vcs'..
* Change section from 'Devel' to 'Vcs'..
* Change section from 'Devel' to 'Vcs'..
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* debian/control: Fix obsolete-relation-form-in-source
  lintian warning. 
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Split out docs into bzr-doc package.
* New upstream release.
* Added John Francesco Ferlito to Uploaders.
* Fix install path to quick-reference guide
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Fix FTBFS due to path changes, again.
* Fix FTBFS due to doc paths changing
* New upstream release.
* Fix FTBFS due to path changes, again.
* Fix FTBFS due to doc paths changing
* New upstream release.
* Fix FTBFS due to path changes, again.
* Fix FTBFS due to doc paths changing
* New upstream release.
* Fix FTBFS due to path changes, again, again.
* Fix FTBFS due to path changes, again.
* Fix FTBFS due to path changes.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Bump standards version to 3.8.3.
* Remove unused patch system.
* New upstream release.
* New upstream release.
* New upstream release.
* Fix copy and paste tab error in .install file
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
 + Fixes compatibility with Python 2.4. Closes: #537708
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream version.
* Bump standards version to 3.8.2.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Add python-pyrex to build-deps to ensure C extensions are always build.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Split documentation into bzr-doc package. ((LP: #385074)
* Multiple packaging changes to make us more linitan clean.
* New upstream release.
* Split documentation into bzr-doc package. ((LP: #385074)
* Multiple packaging changes to make us more linitan clean.
* New upstream release.
* Split documentation into bzr-doc package. ((LP: #385074)
* Multiple packaging changes to make us more linitan clean.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Fix API compatibility version. (Closes: #526233)
* New upstream release.
  + Fixes default format for upgrade command. (Closes: #464688)
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Add missing dependency on zlib development library. (Closes:
  #523595)
* Add zlib build-depends.
* Add zlib build-depends.
* Add zlib build-depends.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Move to section vcs.
* Bump standards version to 3.8.1.
* New upstream release.
* Remove temporary patch for missing .c files from distribution
* New upstream release.
* Remove temporary patch for missing .c files from distribution
* New upstream release.
* Remove temporary patch for missing .c files from distribution
* Add temporary patch for missing .c files from distribution
* Add temporary patch for missing .c files from distribution
* Add temporary patch for missing .c files from distribution
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Recommend ca-certificates. (Closes: #452024)
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Update watch file. bazaar now uses launchpad to host its sources.
* Remove patch for inventory root revision copy, applied upstream.
* New upstream release.
* New upstream release.
* New upstream release
* Force removal of files installed in error to /etc/bash_completion.d/
  (LP: #249452)
* New upstream release.
* New upstream release
* New upstream release.
* Bump standards version.
* Include patch for inventory root revision copy, required for bzr-svn.
* New upstream release.
* Remove unused lintian overrides.
* Correct the package version not to be native.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Final 1.5 release.
* New upstream release.
* New upstream release.
* New upstream release.
* Add myself as a co-maintainer.
* Add a Dm-Upload-Allowed: yes header.
* New upstream bugfix release.
* New upstream release.
* Final 1.3 release.
* New upstream release.
* First release candidate of the upcoming 1.3 release.
* Rebuild to fix the problem caused by a build with a broken python-central.
* New upstream release.
* Rebuild for dapper PPA.
* Apply Lamont's patches to fix build-dependencies on dapper.
  (See: https://bugs.launchpad.net/bzr/+bug/189915)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/ru/user-guide/using_checkouts.txt
 
1
Using checkouts
 
2
===============
 
3
 
 
4
Turning a branch into a checkout
 
5
--------------------------------
 
6
 
 
7
If you have a local branch and wish to make it a checkout, use the
 
8
``bind`` command like this::
 
9
 
 
10
  bzr bind sftp://centralhost/srv/bzr/PROJECT/trunk
 
11
 
 
12
This is necessary, for example, after creating a central branch using
 
13
``push`` as illustrated in the previous section.
 
14
 
 
15
After this, commits will be applied to the bound branch before
 
16
being applied locally.
 
17
 
 
18
Turning a checkout into a branch
 
19
--------------------------------
 
20
 
 
21
If you have a checkout and wish to make it a normal branch, use the
 
22
``unbind`` command like this::
 
23
 
 
24
  bzr unbind
 
25
 
 
26
After this, commits will only be applied locally.
 
27
 
 
28
Getting a checkout
 
29
------------------
 
30
 
 
31
When working in a team using a central branch, one person needs
 
32
to provide some initial content as shown in the previous section.
 
33
After that, each person should use the ``checkout`` command to
 
34
create their local checkout, i.e. the sandbox in which they
 
35
will make their changes.
 
36
 
 
37
Unlike Subversion and CVS, in Bazaar the ``checkout`` command creates a
 
38
local full copy of history in addition to creating a working tree holding
 
39
the latest content. This means that operations such as ``diff`` and ``log``
 
40
are fast and can still be used when disconnected from the central location.
 
41
 
 
42
.. _getting-a-lightweight-checkout:
 
43
 
 
44
Создание легковесной рабочей копии
 
45
----------------------------------
 
46
 
 
47
While Bazaar does its best to efficiently store version history, there
 
48
are occasions when the history is simply not wanted. For example, if your
 
49
team is managing the content of a web site using Bazaar with a
 
50
central repository, then your release process might be as simple as
 
51
updating a checkout of the content on the public web server. In this
 
52
case, you probably don't want the history downloaded to that location
 
53
as doing so:
 
54
 
 
55
 * wastes disk space holding history that isn't needed there
 
56
 * exposes a Bazaar branch that you may want kept private.
 
57
 
 
58
To get a history-less checkout in Bazaar, use the ``--lightweight``
 
59
option like this::
 
60
 
 
61
  bzr checkout --lightweight sftp://centralhost/srv/bzr/PROJECT/trunk
 
62
 
 
63
Of course, many of the benefits of a normal checkout are lost by doing
 
64
this but that's a tradeoff you can make if and when it makes sense.
 
65
 
 
66
The ``--lightweight`` option only applies to checkouts, not to all branches.
 
67
 
 
68
Note: If your code base is really large and disk space on your computer
 
69
is limited, lightweight checkouts may be the right choice for you.
 
70
Be sure to consider all your options though including
 
71
`shared repositories <#a-reminder-about-shared-repositories>`_,
 
72
`stacked branches <#using-stacked-branches>`_, and `reusing a checkout`_.
 
73
 
 
74
Updating to the latest content
 
75
------------------------------
 
76
 
 
77
One of the important aspects of working in lockstep with others is
 
78
keeping your checkout up to date with the latest changes made to
 
79
the central branch. Just as you would in Subversion or CVS, you do
 
80
this in Bazaar by using the ``update`` command like this::
 
81
 
 
82
  bzr update
 
83
 
 
84
This gets any new revisions available in the bound branch and
 
85
merges your local changes, if any.
 
86
 
 
87
Handling commit failures
 
88
------------------------
 
89
 
 
90
Note that your checkout *must* be up to date with the bound branch
 
91
before running ``commit``. Bazaar is actually stricter about this
 
92
than Subversion or CVS - you need to be up to date with the full
 
93
tree, not just for the files you've changed. Bazaar will ask you
 
94
to run ``update`` if it detects that a revision has been added to
 
95
the central location since you last updated.
 
96
 
 
97
If the network connection to the bound branch is lost, the commit will
 
98
fail. Some alternative ways of working around that are outlined next.