The Commits Window
You use the Commits window to view the history of all Commits saved in a branch. Click the link button to select another branch in The Select Location Dialog Box.
The commits are shown in a table with a maximum of 100 most recent commits initially retrieved from the database. Click Show More () to append the next 100 commits to the table. You can set another value for this default page size in the Result Page Size field on the Model Manager page in the Preferences dialog box.
If the branch was created from another branch, older commits on the parent branch are also appended in the table. The table columns are:
•
The Date column — the time when the commit was saved.
•
The User column — the name of the user that saved the commit.
•
The Branch column — the name of the branch that the commit belongs to.
•
The Comments column — the optionally provided comments when the commit was saved.
The commit history shown in the table follows the current selection in The Databases Window or The Model Manager Window (depending on which window has focus). If you select a particular item, only commits involving that item are shown in the table; otherwise, all commits on the branch are shown. Click Link with Selection () to disable the automatic linking. You can still update the Commits window with a new database object by right-clicking the object and selecting Commits (), when available.
The Commits Window Toolbar
The toolbar in the Commits window contains the following toolbar buttons:
•
Click the Refresh button () to refresh the table to see any new commits that have been saved on the branch. The table will automatically refresh if you save a new commit to the branch from the COMSOL Desktop.
•
Click the Show More button () to append older commits to the table.
•
Click the Link with Selection button () to enable or disable whether to automatically update the Commits window based on the current selection in the Databases window or the Model Manager window (which ever had focus last).
•
Click the Commit Details button () to open The Commit Details Dialog Box.
•
Click the Branch button () to open The Create Branch Dialog Box to branch off from the selected commit.
•
Click the Snapshot button () to record a snapshot for the selected commit.
•
Click the Merge button () to open The Merge Window to merge all changes made up to the selected commit to a target branch.
•
Click the Revert button () to open The Revert Window for the selected commit.
If you right-click a commit in the table, you can also
•
Select Export () to export all versions of items that were the latest versions at the time of the commit to the file system — see Exporting Items.
•
Select Search in Commit () to set the selected commit as the location in The Model Manager Window. You can then search for all versions of items that were the latest versions at the time of the commit. See also Searching in Snapshots and Commits.
The Commit Details Dialog Box
The Commit Details dialog box summarizes the set of related item changes saved in a commit.
•
The Location shows the database, repository, and branch that the commit was saved to.
•
The Date shows the time when the commit was saved.
•
The User shows the name of the user that saved the commit.
•
The Comments shows the optionally provided comments when the commit was saved.
•
The Changes table shows a table with the set of related item changes made in the commit.
When you click Revert () for a commit, the inverse of the set of changes shown in the Changes table can be applied from The Revert Window.
Click the Edit Comments button () to update the comments for the commit. Click Save to save the updated comments to the database. Click Cancel to revert back to the original comments.
For a Model Manager server database, only a root administrator or the user that saved the commit can update the comments.
From the toolbar for the Changes table, you can:
•
Click the Open button () to open the latest version of a model at the time of the commit. Only enabled for a change that involved a model.
•
Click the Preview File button () to open the latest version of a file using the default application for its file type. Only enabled for a change that involved a file.
•
Click the Version Details button () to open The Version Details Dialog Box containing more information on a version.
See Figure 2-3 for an example of commit details taken from the tutorial Example: Modeling Using Version Control in which a draft has been saved back as a new version of its original model.
Figure 2-3: The Commit Details dialog box for a commit in which a new version has been saved of a model, and a draft has been deleted.