The Commit View

The commit view allows you to review the changes being committed and provide a message describing the changes which will be visible in the repository’s log to other members of the team.

No files are committed to the repository until the Commit Changes button is pressed.

With the commit view displayed:

  1. Review the changes made by comparing the modified files against their BASE revisions by clicking the arrow to the right of the filename.

  2. Include and exclude files from the change list by clicking on the checkboxes in the left-most column (all files are included by default).

    Use the items on the contextual menu to include or exclude sets of files.

    By default, including/excluding a folder does not recursively include/exclude its contents. This behavior can be changed by holding the Option (⌥) key while clicking the folder’s check button.

  3. Type a message into the log message field which describes the changes being committed.

    You cannot easily change the message text after the commit has completed, so take the time to review the text before continuing.

    For this reason it’s probably best not to use log messages as a platform for sounding off on your feelings about your boss or other team members!

    Use the Return (⏎) key to enter a newline into the message field (Return (⏎) does not close the view).

  4. Alternatively, use the log picker to select a message from the repository’s log by clicking the Show Recent button.

  5. Optionally select the pre- and post-commit scripts to run during the commit. See the Running Commit Actions article in the Integration section for more information.
  6. Click the Commit Changes button to commit the changes to the repository.

    Alternatively, press the ⌘T key combination.

  7. Press Cancel (key equivalent Escape ⎋) to cancel the commit. If you have already entered a log message then the message is retained and used as the default for the next commit operation.