/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/user-guide/branching_a_project.txt

  • Committer: Martin von Gagern
  • Date: 2010-04-20 08:47:38 UTC
  • mfrom: (5167 +trunk)
  • mto: This revision was merged to the branch mainline in revision 5195.
  • Revision ID: martin.vgagern@gmx.net-20100420084738-ygymnqmdllzrhpfn
merge trunk

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/branching_a_project.txt
16
16
  ===========         ======================================================
17
17
  Prefix              Description
18
18
  ===========         ======================================================
19
 
  file://             Access using the standard filesystem (default)
20
 
  sftp://             Access using SFTP (most SSH servers provide SFTP).
21
 
  bzr://              Fast access using the Bazaar smart server.
22
 
  ftp://              Access using passive FTP.
23
 
  http://             Read-only access to branches exported by a web server.
 
19
  \file://            Access using the standard filesystem (default)
 
20
  \sftp://            Access using SFTP (most SSH servers provide SFTP).
 
21
  \bzr://             Fast access using the Bazaar smart server.
 
22
  \ftp://             Access using passive FTP.
 
23
  \http://            Read-only access to branches exported by a web server.
24
24
  ===========         ======================================================
25
25
 
26
26
As indicated above, branches are identified using URLs with the
30
30
`URL Identifiers <../user-reference/bzr_man.html#url-identifiers>`_
31
31
section of the Bazaar User Reference.
32
32
 
 
33
URLs are normally resolved relative to the root directory of the server,
 
34
so ``ftp://example.com/repo/foo`` means the ``/repo/foo`` directory of
 
35
that host.  (We say 'normally' because some server software like Apache
 
36
can be configured to remap URLs arbitrarily, in which case you'll need to
 
37
look at the server configuration to find out which URL corresponds to
 
38
which directory.)
 
39
 
 
40
To address a path relative to your home directory on the server, use a
 
41
tilde like so: ``sftp://example.com/~/public_html`` should map to
 
42
``public_html`` within your home directory.
 
43
 
33
44
A reminder about shared repositories
34
45
------------------------------------
35
46
 
37
48
where to put it on your filesystem. For maximum storage
38
49
efficiency down the track, it is recommended that branches
39
50
be created somewhere under a directory that has been set up
40
 
as a shared repository. For example::
 
51
as a shared repository. (See `Feature branches
 
52
<organizing_your_workspace.html#feature-branches>`_ in
 
53
`Organizing your workspace <organizing_your_workspace.html>`_
 
54
for a commonly used layout.) For example::
41
55
 
42
56
  bzr init-repo my-repo
43
57
  cd my-repo
89
103
the latest version.
90
104
 
91
105
As explained in later chapters, Bazaar also has support for
92
 
lightweight checkouts of a branch, i.e. working trees with
 
106
`lightweight checkouts <using_checkouts.html#getting-a-lightweight-checkout>`_
 
107
of a branch, i.e. working trees with
93
108
no local storage of history. Of course, disconnected usage
94
109
is not available then but that's a tradeoff you can decide
95
110
to make if local disk space is really tight for you. Support for