~abentley/bzrtools/bzrtools.dev

« back to all changes in this revision

Viewing changes to README

  • Committer: Aaron Bentley
  • Date: 2006-06-27 14:36:32 UTC
  • Revision ID: abentley@panoramicfeedback.com-20060627143632-0f4114d7b0a8d7d9
Fix zap for checkouts of branches with no parents

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
 
- log summaries
11
 
 
12
 
Data not converted:
13
 
- revision IDs
14
 
- data on revisions merged
15
 
 
16
 
BZR-PUSH
 
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
 
15
to import just those changes.
 
16
 
 
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
CDIFF
 
22
cdiff mimics bzr diff, but displays the diff in colour. cdiff knows how
 
23
to read a ~/.colordiffrc file, in the same format as for colordiff(1).
 
24
 
 
25
# example ~/.colordiffrc
 
26
plain=darkwhite
 
27
newtext=darkblue
 
28
oldtext=darkred
 
29
diffstuff=darkgreen
 
30
 
 
31
RSPUSH
17
32
Uses rsync to copy a branch to a remote location.  Remembers the last location
18
33
used.  Will not push if
19
34
- there are unknown files
20
35
- there are uncommitted changes in the working tree.
21
36
These safeguards are intended to prevent dirty trees from being uploaded.
22
37
 
23
 
BZR-PULL
24
 
Uses rsync to get the latest changes from an upstream location.  Remembers the
25
 
last location used.  Will not pull if
26
 
- there are unknown files
27
 
- there are uncommitted changes
28
 
- there have been local commits
29
 
These safeguards are intended to prevent accidental data loss.
 
38
SHELVE/UNSHELVE/SHELF
 
39
Shelve allows you to temporarily put changes you've made "on the shelf",
 
40
ie. out of the way, until a later time when you can bring them back from
 
41
the shelf with the 'unshelve' command.
 
42
 
 
43
You can put multiple items on the shelf, each time you run unshelve the
 
44
most recently shelved changes will be reinstated.
 
45
 
 
46
If filenames are specified, only the changes to those files will be
 
47
shelved, other files will be left untouched.
 
48
 
 
49
If a revision is specified, changes since that revision will be shelved.
 
50
 
 
51
If you specifiy "--pick" you'll be prompted for each hunk of the diff as
 
52
to whether you want to shelve it or not. Press "?" at the prompt for help.
 
53
 
 
54
More Info
 
55
=========
 
56
 
 
57
http://bazaar.canonical.com/BzrShelveExample
 
58
 
 
59
CLEAN-TREE
 
60
Delete unknown (or, optionally, ignored) files, leaving versioned files
 
61
untouched.
 
62
 
 
63
BRANCH-HISTORY
 
64
Show a history of the branch, separated by committer and branch nick.
 
65
 
 
66
GRAPH-ANCESTRY
 
67
Use dot (from Graphviz) to produce graphics of a tree's ancestry.
 
68
 
 
69
FETCH-GHOSTS
 
70
Scan this branch for missing ancestors (aka "ghosts), and attempt to retrieve
 
71
them from a specified branch.
 
72
 
 
73
PATCH
 
74
Use patch to apply a patch to this tree.
 
75
 
 
76
ZAP
 
77
Safely remove undesired checkouts