fossil-scripts
2009-12-27.2

      The scripts are described below in alphabetical order:

       1) fossil-branch [<commit>]

            - If a commit is not specified, show all the branches similar to
              how "git branch" shows them.  If a commit is specified, show
              the branch where the commit resides.  Example output looks like
              the following where "bar" is the current branch:

                  * bar
                    baz (closed)
                    foo

            - The pseudo-commit "current" can be passed in as the first
              argument.  If there isn't a real branch called "current",
              fossil-branch will print the name of the current branch.

            - It would be nice to be able to mark the private branches too,
              but I haven't been able to find an easy way to do this from
              the command line.

       2) fossil-cat <commit> [<fname>]

            - Write the contents of the file associated with a particular
              commit to stdout.  As a convenience, if <fname> is not
              specified, the commit is passed directly to "fossil artifact".

       3) fossil-close-leaf <commit>

            - Close a leaf.

       4) fossil-current

            - Prints the SHA-1 hash value for the current commit.

       5) fossil-flatten

            - Generic script for flattening the log messages.  It works by
              piping the log messages into it:

                  alias ff="fossil-flatten"
                  fossil leaves | ff

            - With all the scripts that flatten the log messages, a pager
              like the following should used inside a window wider than 80
              columns:

                  export PAGER="less -i -S -M -F"

       6) fossil-help-all

            - Print the help for all commands listed in "fossil help".

       7) fossil-log [<commit1> [<commit2>]]

            - Limit the log to display just the commits between <commit1>
              and <commit2> (inclusive).  If <commit1> is not an ancestor of
              <commit2>, nothing is printed.  If <commit2> is not specified,
              it displays the commits starting with <commit1>.  If <commit1>
              is not specified, it displays the commits starting with the
              current commit.  This script also flattens so each is on a
              single line.

       8) fossil-ls-tree [<commit>]

            - List the SHA-1 and file name for each file in <commit>.  If
              <commit> is not specified, the current commit is used.

       9) fossil-pending [<commit>]

            - Show the commits that are pending.  This is typically used
              immediately after running "fossil pull".  It lets you review
              the pending commits that will be applied to your branch by
              "fossil update".  This is a wrapper around "fossil timeline
              descendants".  In addition to flattening the log messages, it
              also filters out descendants that are on a different branch.

      10) fossil-timeline ...

            - Simple wrapper around "fossil timeline".  The main thing it
              does is flatten the log messages so each is on a single line
              making it easier to read if you have a sane pager.