~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/doc/api/branch.txt

• browse files at revision 1185.8.3
• compare with another revision
• download diff
• download tarball
• view history from revision 1185.8.3

• reverse the comparison (1185.8.3 to 1777)
• stop comparing with revision 1777

Show diffs side-by-side

added

removed

bzrlib/doc/api/branch.txt

1

 

The Branch API in bzrlib provides creation and management of Branches.

2

 

 

3

 

A Branch represents a series of commits and merges carried out by a user.

4

 

 

5

 

Branches are created by BzrDir's:

6

 

 

7

 

   >>> from bzrlib.bzrdir import ScratchDir

8

 

   >>> from bzrlib.branch import Branch

9

 

   >>> dir = ScratchDir()

10

 

   >>> new_branch = dir.create_branch()

11

 

 

12

 

 

13

 

Existing Branches can be opened directly:

14

 

 

15

 

   >>> another_instance = Branch.open(dir.transport.clone('..').base)

16

 

 

17

 

or via the BzrDir:

18

 

 

19

 

   >>> still_the_same_branch = dir.open_branch()

20

 

 

21

 

 

22

 

A branch has a history of revisions on it:

23

 

 

24

 

   >>> new_branch.revision_history()

25

 

   []

26

 

 

27

 

 

28

 

We need to write some more documentation, showing

29

 

push and pull operations. Cloning might also be nice.

• Older »

Loggerhead is a web-based interface for Breezy
Version: 2.0.1