Basics-Overview(7.3ce) BitKeeper User's Manual Basics-Overview(7.3ce) NAME bk Basics-Overview - BitKeeper basics to help get a new user started DESCRIPTION This section explains how to make changes to files under revision con- trol. If you have not created a package, then see the bk help setup section. Note that BitKeeper supports both the traditional SCCS commands for checking in/out files ("admin -i", delta, get) as well as the RCS com- mands (ci, co). The delta/get are the preferred interfaces. As an example, go to the directory where you would like to make changes: $ cd ~/mypackage/src If you are starting a new package, then create new files with any edi- tor and check them in. The initial check in for a file that already exists will look like this: $ bk new coolStuff.c If you want to modify an existing file, you can do this: $ bk edit coolStuff.c Or, if you have multiple files in the directory, you can do the follow- ing to place all files into a state where they can be modified: $ bk edit If you want to lock the entire tree, including subdirectories, try this: $ bk -U edit Locking the entire directory is useful when applying patches that will access many files in a tree. Once you are finished making changes to files, you can check in the files as follows: $ bk delta file1 file2 file3 However, we recommend using the graphical checkin tool which is invoked with the following command: $ bk citool bk citool will help you check in both new, modified, and pending files. DOCUMENTATION Each command in BitKeeper has command-specific help. You can access individual help topics by typing: There are also a number of other topics that describe various areas in SEE ALSO bk citool bk delta bk edit bk get bk help bk new CATEGORY Overview BitKeeper Inc 1E1 Basics-Overview(7.3ce)