Difference between revisions of "Orion/Documentation/User Guide/Reference/Git Log page"

Revision as of 11:13, 21 June 2011

The Git Log page allows you to browse the commit history of a Git repository branch. The page can show all the commits on a given branch, or focus on only the commits that involve changes to a particular file or directory. You can browse both local and remote branches using this page. What you see in this page depends on how you navigated to it.

Opening the Git Log page

There are many ways to open the Git Log page:

• Choose a file or directory in the Navigator page, and select Git Log in the Actions column. This will show all commits in your current local branch that involve changes to the chosen file or directory.
• Choose a file or directory in the Navigator page, and select Git Remote in the Actions column. This will show all commits in the current remote tracking branch that involve changes to the chosen file or directory.
• From the Git Status page, click the Complete log link next to either the local or remote tracking branch. This will open the complete log for either of those branches.
• From the Repositories page, click Show Git Log in the Actions column next to any local or remote branch of a repository. This will show the entire commit history of the corresponding branch.
• From the Git Log page itself, there are Switch to Remote or Switch to Local links in the toolbar to navigate between the logs of local and remote tracking branches.

Operations from the Git Log page

Once on the Git Log page, you will see a list of commits in chronological order. The title area lets you know what branch and file or directory the page is focused on. In the example below, we are viewing the local branch called master in the repository called Orion Client.

If you are viewing a local branch that is not up to date with its remote tracking branch, a Push All command is available in the toolbar to push your unreleased changes. When viewing a remote branch, Fetch and Merge commands are available in the toolbar to bring remote changes into your local repository and working copy.

Click any commit in the list to open a pane showing detailed information about the commit. This pane includes author information, the commit message, and the SHA-1 hash that uniquely identifies that commit in the Git repository. The pane also shows a list of all files that had changes in that commit. Click the command icon next to any file in that pane to open a compare viewer showing the differences in that file. The area where commands appear is highlighted in the image below.

Git Log for single files

When viewing the Git log for a single file, some additional capabilities are available. First, the breadcrumb in the title area allows you to navigate to the Git log list for any parent of the currently viewed file. Additional commands are also available in the Actions column. The Open link will open the revision of the current file as it appeared in that commit. You can also compare the contents of that commit to the current contents of that file in your working tree. Finally, if you select any two files, a Compare With Each Other command appears in the toolbar, to compare the differences in that file between the selected commits.