~abentley/bzrtools/bzrtools.dev

« back to all changes in this revision

Viewing changes to README

  • Committer: Aaron Bentley
  • Date: 2006-03-24 17:24:21 UTC
  • Revision ID: abentley@panoramicfeedback.com-20060324172421-c1acc18c1a4075a6
Added multi-pull, working on branches and checkouts

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
BZR TOOLS
2
2
 
3
 
This is is a set of helper tools for bzr.
 
3
This is is a set of plugins for bzr.
4
4
 
5
 
BAZ2BZR
6
 
baz2bzr will import an Arch or Baz branch into bzr.
 
5
BAZ-IMPORT
 
6
baz-import will import an Arch or Baz Archive into a bzr repository.
7
7
Data converted:
8
8
- source tree
9
9
- file ids
10
10
- revision ids
11
 
- log summaries
12
 
 
13
 
Data not converted:
14
 
- data on revisions merged
15
 
- log bodies
16
 
- symlinks in Arch trees are not handled (but can be skipped).
17
 
 
18
 
After more commits are made to the baz/arch branch, you can re-run baz2bzr
 
11
- logs
 
12
- merge data
 
13
 
 
14
After more commits are made to the baz/arch branch, you can re-run baz-import
19
15
to import just those changes.
20
16
 
21
 
The conversion algorithm is still in flux, and old data may become invalid as
22
 
newer conversion functionality is introduced.
23
 
 
24
 
 
25
 
BZR-PUSH
 
17
BAZ-IMPORT-BRANCH
 
18
baz-import-branch will import an Arch or Baz Branch into a bzr standalone tree.
 
19
See baz-import for conversion details.
 
20
 
 
21
PUSH
26
22
Uses rsync to copy a branch to a remote location.  Remembers the last location
27
23
used.  Will not push if
28
24
- there are unknown files
29
25
- there are uncommitted changes in the working tree.
30
26
These safeguards are intended to prevent dirty trees from being uploaded.
31
27
 
32
 
ANNOTATE
33
 
Output a version of the requested file that indicates which revision introduced
34
 
each line.
35
 
 
36
 
SHELF/UNSHELF
37
 
Temporarily put aside some changes, to restore them later.  This can be useful
38
 
to separate two sets of changes, so that they can be committed separately.
39
 
 
40
 
BZR-PULL (obsolete as of Bzr 0.5)
41
 
Uses rsync to get the latest changes from an upstream location.  Remembers the
42
 
last location used.  Will not pull if
43
 
- there are unknown files
44
 
- there are uncommitted changes
45
 
- there have been local commits
46
 
These safeguards are intended to prevent accidental data loss.
 
28
SHELVE/UNSHELVE/SHELF
 
29
Shelve allows you to temporarily put changes you've made "on the shelf",
 
30
ie. out of the way, until a later time when you can bring them back from
 
31
the shelf with the 'unshelve' command.
 
32
 
 
33
You can put multiple items on the shelf, each time you run unshelve the
 
34
most recently shelved changes will be reinstated.
 
35
 
 
36
If filenames are specified, only the changes to those files will be
 
37
shelved, other files will be left untouched.
 
38
 
 
39
If a revision is specified, changes since that revision will be shelved.
 
40
 
 
41
If you specifiy "--pick" you'll be prompted for each hunk of the diff as
 
42
to whether you want to shelve it or not. Press "?" at the prompt for help.
 
43
 
 
44
More Info
 
45
=========
 
46
 
 
47
http://bazaar.canonical.com/BzrShelveExample
 
48
 
 
49
CLEAN-TREE
 
50
Delete unknown (or, optionally, ignored) files, leaving versioned files
 
51
untouched.
 
52
 
 
53
BRANCH-HISTORY
 
54
Show a history of the branch, separated by committer and branch nick.
 
55
 
 
56
GRAPH-ANCESTRY
 
57
Use dot (from Graphviz) to produce graphics of a tree's ancestry.
 
58
 
 
59
FETCH-GHOSTS
 
60
Scan this branch for missing ancestors (aka "ghosts), and attempt to retrieve
 
61
them from a specified branch.
 
62
 
 
63
PATCH
 
64
Use patch to apply a patch to this tree.
 
65
 
 
66
ZAP
 
67
Safely remove undesired checkouts