~abentley/bzrtools/bzrtools.dev

« back to all changes in this revision

Viewing changes to README

  • Committer: Aaron Bentley
  • Date: 2005-06-08 22:51:36 UTC
  • Revision ID: abentley@bruiser-20050608225136-c900df20f33fb550
Updated copyright

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 plugins for bzr.
 
3
This is is a set of helper tools for bzr.
4
4
 
5
 
BAZ-IMPORT
6
 
baz-import will import an Arch or Baz Archive into a bzr repository.
 
5
BAZ2BZR
 
6
baz2bzr will import an Arch or Baz branch into bzr.
7
7
Data converted:
8
8
- source tree
9
9
- file ids
10
10
- revision ids
11
 
- logs
12
 
- merge data
13
 
 
14
 
After more commits are made to the baz/arch branch, you can re-run baz-import
 
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
15
19
to import just those changes.
16
20
 
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
 
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
22
26
Uses rsync to copy a branch to a remote location.  Remembers the last location
23
27
used.  Will not push if
24
28
- there are unknown files
25
29
- there are uncommitted changes in the working tree.
26
30
These safeguards are intended to prevent dirty trees from being uploaded.
27
31
 
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
 
32
BZR-PULL (obsolete as of Bzr 0.5)
 
33
Uses rsync to get the latest changes from an upstream location.  Remembers the
 
34
last location used.  Will not pull if
 
35
- there are unknown files
 
36
- there are uncommitted changes
 
37
- there have been local commits
 
38
These safeguards are intended to prevent accidental data loss.