← Back to branch summary

~abentley/bzrtools/bzrtools.dev

« back to all changes in this revision

Viewing changes to README

  • Committer: Aaron Bentley
  • Date: 2005-09-22 17:50:29 UTC
  • Revision ID: abentley@panoramicfeedback.com-20050922175029-10670eb4d37ded38
Switched from clusters to forced ranking

Show diffs side-by-side

added added

removed removed

Lines of Context:
README
1
1
BZR TOOLS
2
2
 
3
 
This is is a set of plugins for Bazaar.
4
 
 
5
 
Please report bugs at: https://bugs.launchpad.net/bzrtools/
6
 
 
 
3
This is is a set of plugins for bzr.
7
4
 
8
5
BAZ-IMPORT
9
 
baz-import will import an Arch or Baz Archive into a bzr repository.
 
6
baz-bzr will import an Arch or Baz branch into bzr.
10
7
Data converted:
11
8
- source tree
12
9
- file ids
13
10
- revision ids
14
 
- logs
15
 
- merge data
 
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).
16
17
 
17
18
After more commits are made to the baz/arch branch, you can re-run baz-import
18
19
to import just those changes.
19
20
 
20
 
BAZ-IMPORT-BRANCH
21
 
baz-import-branch will import an Arch or Baz Branch into a bzr standalone tree.
22
 
See baz-import for conversion details.
23
 
 
24
 
BRANCHES
25
 
List all the branches present at, or underneath, a location.
26
 
 
27
 
BRANCH-HISTORY
28
 
Show a history of the branch, separated by committer and branch nick.
29
 
 
30
 
CBRANCH
31
 
Create a branch in a repository and a checkout elsewhere, in one command.
32
 
 
33
 
CDIFF
34
 
cdiff mimics bzr diff, but displays the diff in colour. cdiff knows how
35
 
to read a ~/.colordiffrc file, in the same format as for colordiff(1).
36
 
 
37
 
# example ~/.colordiffrc
38
 
plain=darkwhite
39
 
newtext=darkblue
40
 
oldtext=darkred
41
 
diffstuff=darkgreen
 
21
The conversion algorithm is still in flux, and old data may become invalid as
 
22
newer conversion functionality is introduced.
 
23
 
 
24
 
 
25
PUSH
 
26
Uses rsync to copy a branch to a remote location.  Remembers the last location
 
27
used.  Will not push if
 
28
- there are unknown files
 
29
- there are uncommitted changes in the working tree.
 
30
These safeguards are intended to prevent dirty trees from being uploaded.
 
31
 
 
32
ANNOTATE
 
33
Output a version of the requested file that indicates which revision introduced
 
34
each line.
 
35
 
 
36
SHELVE/UNSHELVE
 
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.
42
39
 
43
40
CLEAN-TREE
44
 
Delete unknown, ignored, or detritus files, leaving versioned files untouched.
45
 
 
46
 
FETCH-GHOSTS
47
 
Scan this branch for missing ancestors (aka "ghosts), and attempt to retrieve
48
 
them from a specified branch.
 
41
Delete unknown (or, optionally, ignored) files, leaving versioned files
 
42
untouched.
 
43
 
 
44
CONFLICTS
 
45
List files in the tree that have conflicts.
 
46
 
 
47
RESOLVE
 
48
Mark conflicts as resolved, by deleting TREE, BASE and OTHER files.
49
49
 
50
50
GRAPH-ANCESTRY
51
51
Use dot (from Graphviz) to produce graphics of a tree's ancestry.
52
52
 
53
 
IMPORT
54
 
Import a tarball into a bzr branch, or update to a fresh tarball.
 
53
FETCH-MISSING
 
54
Scan this branch for missing ancestors, and attempt to retrieve them from
 
55
another branch
55
56
 
56
57
PATCH
57
58
Use patch to apply a patch to this tree.
58
 
 
59
 
MULTI-PULL
60
 
Pull all branches and checkouts at or underneath the current location.
61
 
 
62
 
RSPUSH
63
 
Uses rsync to copy a branch to a remote location.  Remembers the last location
64
 
used.  Will not push if
65
 
- there are unknown files
66
 
- there are uncommitted changes in the working tree.
67
 
These safeguards are intended to prevent dirty trees from being uploaded.
68
 
 
69
 
SHELL
70
 
An interactive shell with bzr commands available as single commands, and
71
 
nice shell completion.
72
 
 
73
 
SHELVE/UNSHELVE/SHELF
74
 
Shelve allows you to temporarily put changes you've made "on the shelf",
75
 
ie. out of the way, until a later time when you can bring them back from
76
 
the shelf with the 'unshelve' command.
77
 
 
78
 
You can put multiple items on the shelf, each time you run unshelve the
79
 
most recently shelved changes will be reinstated.
80
 
 
81
 
If filenames are specified, only the changes to those files will be
82
 
shelved, other files will be left untouched.
83
 
 
84
 
If a revision is specified, changes since that revision will be shelved.
85
 
 
86
 
If you specifiy "--pick" you'll be prompted for each hunk of the diff as
87
 
to whether you want to shelve it or not. Press "?" at the prompt for help.
88
 
 
89
 
SHOW-PATHS
90
 
List the locations used by a branch or checkout.
91
 
 
92
 
More Info
93
 
=========
94
 
 
95
 
http://bazaar.canonical.com/BzrShelveExample
96
 
 
97
 
SWITCH
98
 
Change the branch associated with a lightweight checkout, and update the tree
99
 
while retaining local changes.
100
 
 
101
 
ZAP
102
 
Safely remove undesired checkouts.