~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to tutorial.txt

  • Committer: Robert Collins
  • Date: 2006-04-12 04:57:34 UTC
  • mto: This revision was merged to the branch mainline in revision 1654.
  • Revision ID: robertc@robertcollins.net-20060412045734-3e03b7af0860a5a9
 * 'pull' and 'push' now normalise the revision history, so that any two
   branches with the same tip revision will have the same output from 'log'.
   (Robert Collins)

Show diffs side-by-side

added added

removed removed

Lines of Context:
106
106
Branch locations
107
107
================
108
108
 
109
 
All history is stored in a branch, which is just an on-disk directory containing control files.  There is no repository or database as used in svn or svk.
110
 
 
111
 
  (There are proposals to add shared storage between related branches.)
 
109
All history is stored in a branch, which is just an on-disk directory containing control files.  By default there is no separate repository or database as used in svn or svk. You can choose to create a repository if you want to (see the **bzr init-repo** command). You may wish to do this if you have very large branches, or many branches of a moderate sized project.
112
110
 
113
111
You'll usually refer to branches on your computer's filesystem just by
114
112
giving the name of the directory containing the branch.  bzr also supports
311
309
 
312
310
    % bzr pull
313
311
 
314
 
After this change, the local directory will be a mirror of the source.
 
312
After this change, the local directory will be a mirror of the source. This
 
313
includes the ''revision-history'' - which is a list of the commits done in 
 
314
this branch, rather than merged from other branches.
315
315
 
316
 
This command only works if your local (destination) branch includes only
317
 
changes from the parent branch and no commits of its own.  Otherwise, the
318
 
branches are said to have ''diverged'', and they must be merged instead.
 
316
This command only works if your local (destination) branch is either an
 
317
older copy of the parent branch with no new commits of its own, or if the
 
318
most recent commit in your local branch has been merged into the parent
 
319
branch.
319
320
 
320
321
Merging from related branches
321
322
=============================