bk history(7.3ce)           BitKeeper User's Manual          bk history(7.3ce)

NAME
       bk history - guide to viewing changes to files and/or repositories

TEXTUAL HISTORY
       There  are  multiple  tools to view the history of the repository, of a
       file, or of a collection of files such as a directory.  All  tools  are
       described more completely on their own man pages.

       To view the high-level changes to a repository, type:

           $ bk changes

       bk  changes has many options to control which changesets are shown, how
       they are shown, etc.  It is the primary way for finding out  what  hap-
       pened in the repository and reading the changes man page is highly rec-
       ommended.

       The revision history of a file can be accessed by typing:

           $ bk log foo.c

       bk log has many options. The most commonly used is the -r option  which
       is  used  to select a particular revision of the file.  For example, to
       see the most recent check-in for every file in the current directory:

           $ bk log -r+

       The bk log command documents the metadata associated with  a  BitKeeper
       file  as  well  as  how  to display it.  Reading the bk log man page is
       highly recommended.

       The bk sccslog command is a time ordered view of changes over a set  of
       files.   Unlike  bk  log,  bk sccslog sorts all changes from all of the
       specified (or implied) files and then displays each change  in  chrono-
       logical  order.  The following will display the changes which have hap-
       pened to all the files in the current directory:

           $ bk sccslog

       All three commands support the same range notation as well as a  method
       of controlling the output format known as "dspecs" which are documented
       on the bk log man page.

GRAPHICAL HISTORY
       There are two graphical tools which are primarily used to view  changes
       to files or repositories.  These tools are described more completely on
       their man pages.

       bk csettool is a graphical changeset viewer which displays the list  of
       changes  in each changeset, the ChangeSet history, and the file differ-
       ences (in a side by side display) for each file in each changeset.   It
       is the graphical version of bk changes.

       bk revtool as a tool which shows the revision history graph of either a
       specified file or of the the ChangeSet file.  Nodes in the graph may be
       selected  to  view that version of the file.  If two nodes are selected
       then the differences between the two versions are shown.

SEE ALSO
       bk changes
       bk csettool
       bk difftool
       bk log
       bk range
       bk revtool
       bk sccslog
       bk set

CATEGORY
       Overview
       Repository

BitKeeper Inc                         1E1                    bk history(7.3ce)