Tag Archive for 'revision graph'

Understanding SmartSVN’s Revision Graph

SmartSVN, the popular cross-platform client for Apache Subversion, provides all the tools you need to manage your SVN projects out of the box, including a comprehensive Revision Graph.

SmartSVN’s Revision Graph offers an insight into the hierarchical history of your files and directories, by displaying information on:

  • Merged revisions

  • Revisions yet to be merged

  • Whether a merge occurred in a specific revision

  • Which changes happened in which branch

  • When a file was moved, renamed or copied, along with its history

The Revision Graph is useful in several tasks, including identifying changes made in each revision before rolling back to a previous revision, and gathering more information on the state of a project before a merge.

Accessing the Revision Graph

To access the Revision Graph, open the ‘Query’ menu and select ‘Revision Graph.’

revision graph

Understanding the Revision Graph

In the Revision Graph, projects are mainly represented by:

node Nodes – represent a specific entry (file/directory) at a specific revision.

branch 

    Branches – a collection of linked nodes at the same URL.

 

 

The main section of the Revision Graph is the ‘Revisions’ pane, which displays the parent-child relationships between revisions. Revisions are arranged by date, with the newest at the top. In addition to the main ‘Revisions’ pane, the SmartSVN Revision Graph includes several additional views:

  • Revision Info – displays information on the selected revision (such as revision number, date, author who created the revision etc.)

revision info

  • Directories and files – displays modified files in the selected revision. This is useful for pinpointing the revision at what point a particular file changed or disappeared from the project.

From this screen, you can access several additional options:

  • Export – export the Revision Graph as an HTML file by selecting ‘Export as HTML…’ from the ‘Graph’ menu. This file can then be easily shared with other team members.

  • Merge Arrows – select the ‘Show Merge Arrows’ option from the ‘Query’ menu to view the merge arrows. These point from the merge source to the merge target revisions. If the merge source is a range of revisions, the corresponding revisions will be surrounded by a bracket. This allows you to get an overview of merges that have occurred within your project, at a glance.

  • Merge Sources – select the ‘Show Merge Sources’ option from the ‘Query’ menu to see which revisions have been merged into the currently selected target revision.

  • Merge Targets – select ‘Show Merge Targets’ from the ‘Query’ menu to see the revisions where the currently selected target revisions have been merged.

  • Search – if you’re looking for a particular revision, you can save time by using ‘Edit’ and ‘Search.’ Enter the ‘Search For’ term and specify a ‘Search In’ location.

  • Branch Filter – clicking the ‘Branch Filter’ option in the ‘View’ menu allows you to filter the display for certain branches. This is particularly useful if you’re examining a large project consisting of many different branches.

Intro to SmartSVN’s Revision Graph

SmartSVN’s built-in Revision Graph tool provides a quick and easy way to get an overview of the hierarchical history of your files and directories. This history is primarily represented as ‘nodes’ and ‘branches.’ (Note, because the Revision Graph displays branches and tags, the Tag-Branch-Layout must be configured correctly.)

The Revision Graph is useful for seeing at a glance:

  • Merged revisions
  • Revisions that have yet to be merged
  • Whether a merge occurred in the selected revision
  • Which changes happened in which branch
  • Which revision represents which tag
  • When a file was moved, renamed or copied, along with its history

To access the Revision Graph, open SmartSVN’s ‘Query’ menu and select ‘Revision Graph.’

revision graph 2

This will open the main Revision Graph screen.

revision-graph

The main section of the Revision Graph is the ‘Revisions’ pane. This displays the parent-child relationships between your revisions. Revisions are arranged by date, with the newest at the top.

In the Revision Graph, there are four main types of relationships that are represented by different line styles:

  • Normal parent-child relationship – represented by thick, coloured lines.
  • Complete merge relationship – created by performing a merge commit where all the source revisions are merged into the target. When ‘Merge Arrows’ is enabled, it is represented by thin, coloured lines.
  • Partial merge relationship – created by performing a partial merge (cherry-pick) where not all source revisions are merged into the target. When ‘Merge Arrows’ is enabled it’s represented by thin, coloured, dashed lines.
  • URL relationship – this is where branches have the same URL, but are not related (e.g when you have removed and re-added a branch.) When ‘Join Same Locations’ is enabled, this is represented by thin, gray lines.

In addition to the main ‘Revisions’ pane, the SmartSVN Revision Graph includes several additional views:

1) Revision Info – displays attributes of the selected revision (revision number, date, state, author who created the revision etc.)

revision info

2) Directories and files – displays the files that were modified as part of the selected revision.

revision graph 3

From this screen, you can access several additional options:

  • Export – export the Revision Graph as an HTML file by selecting ‘Export as HTML…’ from the ‘Graph’ menu. In the recently-released SmartSVN 7.5, this export function was improved to support exporting smaller HTML graphic files.
  • Merge Arrows – select the ‘Show Merge Arrows’ option from the ‘Query’ menu to display the merge arrows. These point from the merge source to the merge target revisions. If the merge source is a range of revisions, the corresponding revisions will be surrounded by a bracket.
  • Merge Sources – select the ‘Show Merge Sources’ option from the ‘Query’ menu to see which revisions have been merged into the currently selected target revision.

Haven’t yet started with SmartSVN? You can claim your free SmartSVN Professional trial by visiting www.smartsvn.com/download

Top Five Features of SmartSVN 7.5

Earlier this week, WANdisco announced the release of SmartSVN 7.5, the popular, cross-platform graphical client for Apache Subversion. This release introduces plenty of new features and brings major updates to existing SmartSVN functionality.

In this post, we cover five of the top new features in SmartSVN 7.5.

1) New GUI

In this release, SmartSVN moves from Swing to a SWT GUI platform, bringing the user improved responsiveness and a native look and feel.

2) Increased Security

SmartSVN 7.5 introduces plugin security improvements, including support for safe password storage with the Plugin-API. Other Plugin-API improvements include higher grade encryption, and the option to validate that the plugin is the same for everyone, by applying a password (note, this is an admin only feature.) These security updates ensure that SmartSVN 7.5 is safer and easier to extend than ever before.

3) Improved User Experience

The relaxation of master password means that SmartSVN 7.5 remembers your password for more activities, cutting down on unnecessary interruptions and allowing you to focus on the tasks that matter to you. Other changes that are designed to improve the overall user experience, include:

  • The option to edit properties directly in the Repository Browser
  • Remove, Move and Copy now operate on multiple selected directories

4) Full Support for Working Offline

Need to continue working on your repositories, even when you don’t have access to the internet? SmartSVN 7.5 supports working offline, with the following functionality automatically available as soon as you disconnect from the internet:

  • Communication streams disconnect when offline mode is detected
  • Remote states and Transactions are no longer refreshed
  • Logs and Revision Graph are performed on the Log Cache only

5) Completely Overhauled Revision Graph

SmartSVN’s Revision Graph displays the hierarchical history of a file or directory, and has similar functionality to that of the Log command (for example, comparing two revisions of a certain file) but with a greater level of detail.

The Revision Graph allows you to instantly see:

  • which changes happened in which branch
  • which revision represents which tag
  • when a file was moved, renamed or copied along with its history

The Revision Graph UI has been completely reworked in SmartSVN 7.5:

Other major updates include highlighting ‘mergable’ revisions even if no mergeinfo is loaded. The ‘Export’ option also exports HTML files with a lot of small graphic files, instead of one large file, leading to performance and loading improvements.

Users will also notice:

  • New menu item for selecting shown branches
  • Tag symbols are now displayed for all copies that are tags (according to the tag-and-branch layout)
  • Preferences option to skip initial configuration dialog after install
  • Bug fixes for the switch View options and Revision Info tool window

Want to find out more about SmartSVN 7.5? The full list of what’s new and noteworthy, can be found at the Changelog. If you haven’t already tried SmartSVN, you can claim your free 30 day trial of SmartSVN Professional now.