bk csettool(7.3ce) BitKeeper User's Manual bk csettool(7.3ce) NAME bk csettool - BitKeeper graphical changeset browser SYNOPSIS bk csettool [-] bk csettool [-S] [-r<revs>] [dir] bk csettool [-r<revs>] [-f<file>|<rev>] bk csettool [-S] -L[<url>] DESCRIPTION bk csettool is used to view detailed information about the specified changeset[s]. bk csettool displays the list of changes in each change- set, the file and ChangeSet checkin comments, and the differences found in each file contained in each changeset. Csettool is a useful aide when tracking down bugs. For example, when using revtool to view comments for a specific file in order to track when a change was made to the file. Once the desired file is found, the user can then click on the "View ChangeSet" button in revtool to bring up to see what other files were modified at the same time that the file of interest was modified. To see the changes for a particular file, click on the file name in the top left window and you will see: => the number of diffs in the middle status window => the old version of the file in the lower-left window => the new version of the file in the lower-right window => the ChangeSet's comments followed by the delta's comments in the upper-right window Use the space bar to move between diffs and files. Each time you hit the space bar, the next diff is brought into view. If you are on the last diff, the tool moves to the next file. The "Next" (>>) buttons and "Previous" (<<) buttons in the top menu bar will also allow you to browse the files and diffs. The "History" button in the menu bar can be used to start the graphical history browser, revtool, on either the entire project (ChangeSet file) or on the file highlighted in the upper-left window. The "View Product" button in the menu bar, if present, will view the current changeset from the point of view of the product rather than the component. If the changeset being viewed was part of a commit in a nested collection and spanned multiple components, this wider view can be useful. OPTIONS All options, with the exception of -S, are mutually exclusive, i.e., pick one (or none) of the following. -r<revs> ChangeSet revision to examine. Can be a single revision or a range of revisions. If no "-r" option is given, csettool defaults to "-r+", i.e. the most recent changeset. -L[<url>] Show all changesets unique to this repository relative to the (outgoing) parent or <url> if one was specified. Very similar to: bk csettool -r@`bk repogca [<url>]`.. -S --standalone By default, bk csettool runs in the product of a nested collection. To view the changeset in the context of this component you run $ bk csettool -S -f<file>|<rev> Given a filename and revision, csettool starts up with the specified file and revision selected. - expects a list of revisions on stdin. BINDINGS Home Scroll both files to the top End Scroll both files to the bottom PageUp Scroll both files one screen up (also Control-b) PageDown Scroll both files one screen down (also Control-f) UpArrow Scroll both files one line up (also Control-y) DownArrow Scroll both files one line down (also Control-e) LeftArrow Scroll both files to the left RightArrow Scroll both files to the right Alt-UpArrow Make the diffs windows one line bigger and the lists windows one line smaller. Alt-DownArrow Make the diffs windows one line smaller and the lists windows one line bigger. Control-q Quit space Next diff, if last diff in this file, then goto next file n Next diff, if last diff in this file, then goto next file p Previous diff, if first diff in this file, then goto previous file . Center the current diff on the screen Control-n Next file Control-p Previous file s Export the current ChangeSet as a patch. Double-Clicking Double clicking the left mouse button on a file in the file list brings up revtool for the specified file. FUTURE DIRECTIONS We plan on having a single screen diff window option where the changes are all shown color coded in one window. SEE ALSO bk changes bk config-gui bk cset bk difftool bk range bk revtool CATEGORY GUI-tools Repository BitKeeper Inc 1E1 bk csettool(7.3ce)