← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/tutorial.txt

  • Committer: Robert Collins
  • Date: 2007-07-04 02:43:26 UTC
  • mto: This revision was merged to the branch mainline in revision 2581.
  • Revision ID: robertc@robertcollins.net-20070704024326-czaqy9flaooda2jj
Fix missed tests.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/tutorial.txt
11
11
Bazaar Tutorial
12
12
===============
13
13
 
14
 
Current for bzr-0.91, 2007-08
 
14
Current for bzr-0.16, 2007-05
15
15
 
16
16
 
17
17
Introduction
109
109
Bazaar installs a single new command, **bzr**.  Everything else is a
110
110
subcommand of this.  You can get some help with ``bzr help``. Some arguments 
111
111
are grouped in topics: ``bzr help topics`` to see which topics are available.
 
112
There will be more in the future.
112
113
 
113
114
One function of a version control system is to keep track of who changed
114
115
what.  In a decentralized system, that requires an identifier for each
115
116
author that is globally unique.  Most people already have one of these: an
116
 
email address. Bazaar is smart enough to automatically generate an email
 
117
email address. Bzr is smart enough to automatically generate an email
117
118
address by looking up your username and hostname. If you don't like the
118
119
guess that Bazaar makes, then three options exist:
119
120
 
159
160
 
160
161
History is by default stored in the .bzr directory of the branch. In a
161
162
future version of Bazaar, there will be a facility to store it in a
162
 
separate repository, which may be remote.
163
 
 
164
 
We create a new branch by running ``bzr init`` in an existing directory::
 
163
separate repository, which may be remote.  We create a new branch by
 
164
running ``bzr init`` in an existing directory::
165
165
 
166
166
    % mkdir tutorial
167
167
    % cd tutorial
317
317
override either of the above mentioned editor options.  If you quit the
318
318
editor without making any changes, the commit will be cancelled.
319
319
 
320
 
The file that is opened in the editor contains a horizontal line. The part
321
 
of the file below this line is included for information only, and will not
322
 
form part of the commit message. Below the separator is shown the list of
323
 
files that are changed in the commit. You should write your message above
324
 
the line, and then save the file and exit.
325
 
 
326
 
If you would like to see the diff that will be committed as you edit the
327
 
message you can use the ``--show-diff`` option to ``commit``. This will include
328
 
the diff in the editor when it is opened, below the separator and the
329
 
information about the files that will be committed. This means that you can
330
 
read it as you write the message, but the diff itself wont be seen in the
331
 
commit message when you have finished. If you would like parts to be
332
 
included in the message you can copy and paste them above the separator.
333
 
 
334
320
Selective commit
335
321
----------------
336
322