← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/tutorial.txt

  • Committer: Brad Crittenden
  • Date: 2007-03-02 12:40:45 UTC
  • mto: This revision was merged to the branch mainline in revision 2311.
  • Revision ID: bac@canonical.com-20070302124045-3a9o45va231z0w0a
post review changes

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/tutorial.txt
91
91
 
92
92
Revision control software such as Bazaar can do much more than just
93
93
storage and performing undo.  For example, with Bazaar a developer can
94
 
take the modifications in one branch of software and apply them to
95
 
another related branch -- even if those changes exist in a branch owned
96
 
by somebody else. This allows developers to cooperate without giving write
97
 
access to the repository.
 
94
take the modifications in one branch of software and apply them to a
 
95
related branch -- even if those changes exist in a branch owned by
 
96
somebody else. This allows developers to cooperate without giving
 
97
write access to the repository.
98
98
 
99
99
Bazaar remembers the ''ancestry'' of a revision: the previous revisions
100
100
that it is based upon.  A single revision may have more than one direct
158
158
History is by default stored in the .bzr directory of the branch. In a
159
159
future version of Bazaar, there will be a facility to store it in a
160
160
separate repository, which may be remote.  We create a new branch by
161
 
running **bzr init** in an existing directory::
 
161
running ``bzr init`` in an existing directory::
162
162
 
163
163
    % mkdir tutorial
164
164
    % cd tutorial
202
202
 
203
203
You'll usually refer to branches on your computer's filesystem just by
204
204
giving the name of the directory containing the branch.  bzr also supports
205
 
accessing branches over http, for example::
 
205
accessing branches over http and sftp, for example::
206
206
 
207
207
    % bzr log http://bazaar-vcs.org/bzr/bzr.dev/
 
208
    % bzr log sftp://bazaar-vcs.org/bzr/bzr.dev/
208
209
 
209
 
By installing bzr plugins you can also access branches using the sftp or
210
 
rsync protocols.
 
210
By installing bzr plugins you can also access branches using the rsync
 
211
protocol.
211
212
 
212
213
Reviewing changes
213
214
=================
504
505
".THIS" and the filename with the changes from the other tree is
505
506
appended with ".OTHER".  Using a program such as kdiff3, you can now
506
507
comfortably merge them into one file.  In order to commit you have to
507
 
rename the merged file (".THIS") to the original file name and delete
508
 
the other two temporary files (".BASE" and ".OTHER"). As long as there
 
508
rename the merged file (".THIS") to the original file name.  To
 
509
complete the conflict resolution you must use the resolve command,
 
510
which will remove the ".OTHER" and ".BASE" files.  As long as there
509
511
exist files with .BASE, .THIS or .OTHER the commit command will
510
 
complain.  To complete the conflict resolution you must use the
511
 
resolve command.
 
512
report an error.
512
513
 
513
514
::
514
515
 
515
516
  % kdiff3 file.BASE file.OTHER file.THIS
516
517
  % mv file.THIS file
517
 
  % rm file.BASE file.OTHER
518
518
  % bzr resolve file
519
519
 
520
520
[**TODO**: explain conflict markers within files]
528
528
directory.  One can push a branch (or the changes for a branch) by one of
529
529
the following three methods:
530
530
 
531
 
* Rsync:   rsync -avrz LOCALBRANCH  servername.com/this/directory/here
 
531
* Rsync:   rsync -avrz LOCALBRANCH  servername.com/path/to/directory
532
532
 
533
533
  (or any other tool for publishing a directory to a web site.)
534
534
 
535
 
* bzr push sftp://servername.com/this/directory/here 
 
535
* bzr push sftp://servername.com/path/to/directory 
536
536
 
537
 
  (The destination directory must already exist)
 
537
  (The destination directory must already exist unless the
 
538
  ``--create-prefix`` option is used.)
538
539
 
539
540
* The rspush plugin that comes with BzrTools
540
541