When you left click on a History Graph window's Change History Graph button you will be presented with a dialog window like the one shown below.
This dialog window allows you to change what is shown in the current history graph and how that information is displayed. The history graph settings are grouped into three panels as follows:
Restrict To Branches Panel
Field/Button |
Description |
---|---|
Unselected branch filter |
This entry field allows one to enter a branch name pattern that is used to filter out all unselected branches that do not match from the branch list directly below. If this entry field is blank then no such filtering takes place. Selected branches will always be shown, regardless of any filter used. Typically one would use this to restrict the branch list to those that belong to a certain project or release branch. Once you have selected the branches you want one can always use a completely different branch name filter to display another set of branches without loosing what you have already selected. |
Applies the current unselected branch name filter to all unselected branches in the the branch list below this button. |
|
Ticks all of the selected rows in the branch list below this button. |
|
Unticks all of the selected rows in the branch list below this button. |
|
Case sensitive |
When ticked, make any branch name filtering case sensitive, otherwise case is unimportant. |
Regular expression |
When ticked, treat any branch name filter text as an extended regular expression (RE), otherwise the text is treated as an ordinary sequence of characters. Please see regex(7) for further details on regular expressions. |
Branch List |
This list shows all selected branches and any unselected branches that have not been filtered out. Any subsequent history graph will restrict itself to those selected branches. However if no branches have been selected then no such restriction applies and consequently the history graph will show all of the branches in the database. |
Date Range Panel
Field |
Description |
---|---|
Graph revisions created |
When ticked, enable the ability to search based on a revision's creation time, otherwise creation time is unimportant. |
between |
When selected, one can enter a time range in which a revision's creation time has to fall in order to be selected (i.e. “select revisions created between x and y”). |
during the previous |
When selected, one can enter how recent a revision's creation time has to be in order to be selected (i.e. “select revisions created within the last x minutes/hours/days/months/years”). |
Options Panel
Field |
Description |
---|---|
Draw graph left to right |
When ticked, the history graph is drawn from left to right instead of from top to bottom. |
Show all propagate revisions |
When ticked, child propagate revision nodes are also included in the history graph along with parent propagate nodes. Propagate revisions are ones that are not on the same branch as their relation but are linked due to a merging or propagation operation. Propagate nodes are never shown if their creation time falls outside of any selection criteria used when drawing the history graph. By default child propagate nodes are not shown as one is normally only interested in what makes up a revision rather than what it in turn contributes to. |
Colour by |
Controls how revision nodes are coloured in history graphs. If Branch is selected then a node's colour is derived from what branch it is on. Whereas if Author is selected then a node's colour is derived from who created it. These different colours provide a visual aide help to differentiate between distinct groups of nodes. |
![]() |
|
|