/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/tutorials/tutorial.txt

merge bzr.dev.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/tutorials/tutorial.txt
11
11
Bazaar Tutorial
12
12
===============
13
13
 
14
 
Current for bzr-0.16, 2007-05
 
14
Current for bzr-0.91, 2007-08
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.
113
112
 
114
113
One function of a version control system is to keep track of who changed
115
114
what.  In a decentralized system, that requires an identifier for each
116
115
author that is globally unique.  Most people already have one of these: an
117
 
email address. Bzr is smart enough to automatically generate an email
 
116
email address. Bazaar is smart enough to automatically generate an email
118
117
address by looking up your username and hostname. If you don't like the
119
118
guess that Bazaar makes, then three options exist:
120
119
 
160
159
 
161
160
History is by default stored in the .bzr directory of the branch. In a
162
161
future version of Bazaar, there will be a facility to store it in a
163
 
separate repository, which may be remote.  We create a new branch by
164
 
running ``bzr init`` in an existing directory::
 
162
separate repository, which may be remote.
 
163
 
 
164
We create a new branch by 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
 
320
334
Selective commit
321
335
----------------
322
336