We continuously solicit input on the features and product improvements that are most impactful to our customers’ development efforts.
What’s New In AccuRev 6.0
Change packages are now easier to use, allowing you to work in a natural manner without the necessity of manual rules and procedures.
Change Package Improvements
AccuRev has always been good at showing you where your files are and how your project is progressing, but with Release 6.0, improvements in the following areas now make it easier to manipulate the elements involved in those projects.
- Issue Dependencies -- AccuRev now automatically keeps track of changes even when the same element has versions from two different issues. It is no longer necessary to ensure that all changes for one issue are complete before promoting changes for a different issue.
- Tracking Issues -- Tracking issues are still available if you wish to use them, but they are no longer required when you patch an issue from one stream to another (see “Enhanced Change Palette Behavior” below).
- Incomplete Change Packages and Unaffiliated Changes – AccuRev has always been able to alert you to files that are missing from a change package, but now it is also able to alert you to missing versions of a file. This means that you will see far fewer instances of “Unaffiliated Changes” (versions of files that cannot be associated with an issue in the current stream). Also, you can now send all Unaffiliated Changes to an issue with a single mouse click, making it easier to clean up your streams.
- Multiple segments (“multi-segments”) -- AccuRev 6.0 treats contiguous versions of a file as a segment. Each segment can be tracked and handled independently. That way, multiple promotes for Issue #1, for example, can be tracked, and having a “gap” caused by an intervening promote of Issue #2 does not cause a problem. You can think of each segment almost as a separate patch (not the AccuRev patch command, but a generic, development patch). AccuRev handles all the record-keeping automatically, and you no longer need to deal with the changes introduced by Issue #2.
- Variants – AccuRev 6.0 replaces the need for a separate tracking issue with a new, automatically generated variant of the existing issue. Although you do not need to know that variants exist during your day-to-day work (AccuRev automatically takes care of these details for you), variants are visible in a limited number of places in the UI. Variants are described in detail in the new “Change Packages” chapter of the On-Line Help, for administrators and power users who want to understand when and why variants get created.
Enhanced Change Palette BehaviorAs part of the improvements to change packages, the Change Palette has changed in the following ways:
- You no longer need to use the Change Palette for simple cross-promotes. You can simply drag & drop items from a dynamic stream to the destination stream. If there are no conflicts, the operation completes immediately. AccuRev only brings up the Change Palette if there is a conflict that requires your intervention.
- There is now an enhanced Change Palette mode for issues. This mode provides functionality for efficiently identifying and dealing with conflicts and issue dependencies, and then promoting the issues into the destination stream.
New File Browser ModesThe File Browser for workspaces and streams benefits from a major revision with new modes that make it easier than ever to quickly focus on those files that are of interest to you with a single click.
- Explorer mode – The Explorer Mode displays all the files and directories in the current workspace or stream. You can use the Explorer mode to get a complete picture of your AccuRev workspace or stream, and to set rules about which files and directories you want to make available.
- Outgoing Changes mode – The Outgoing Changes mode displays only those files and directories that have changed in, been added to, or removed from the current workspace or stream. In workspaces, you can use Outgoing Changes Mode to save new work; in workspaces and streams, you can promote changes to the parent stream. Filters let you show files with any combination of (member), (modified), (external), (missing), (overlap), or (stranded) status. The explorer tree displays an asterisk on any workspace directory containing a change, making your changes even easier to find.
- Incoming Changes mode – The Incoming Changes mode provides a preview of any files and directories that will be changed in, added to, or removed from your workspace when you update. The Update operation keeps your workspace current with any changes that have been made to files and directories in the parent stream. In Incoming Changes mode, the explorer tree displays only those directories that will be refreshed when you update your workspace.
- Conflicts mode -- The Conflicts mode displays the files in the current workspace or stream that conflict with another version of the same file in the parent stream or a stream elsewhere in the stream hierarchy. Examples of conflicting files include those with a status of (overlap) and (twin). You can use the Conflicts mode to resolve these conflicts -- by diffing versions and merging changes when it makes sense to do so, for example. The explorer tree in Conflicts mode displays only those directories that contain files whose versions are in conflict.
Other improvements to the File Browser include:
- An embedded read-only Diff pane lets you quickly compare versions. The Diff pane, which supports image files, is populated each time you select a file in Outgoing Changes, Incoming Changes, and Conflicts modes. You can hide it with a single click.
- The ability to save the File Browser layout and mode settings as a personal preference. AccuRev maintains stream and workspace File Browser layout settings separately.
- The Search Workspace field has been enhanced to include the name of the directory that currently has focus in the Explorer pane so you always know where you are searching.
- Toolbars in each mode have been streamlined to include the most commonly performed actions. Similarly, context menus now display only relevant choices.
- To speed performance, AccuRev searches for (stranded) files or deep overlap files only if you ask it to. The Deep Overlap Optimization feature remains available to help make searches for deep overlaps as efficient as possible.
- Tooltips, labels, and instructional text have been improved throughout the AccuRev GUI.
In AccuRev 6.0, status filters are built into Outgoing Changes, Incoming Changes, and Conflicts modes (the Explorer mode shows all files in your workspace, including any that have not yet been added to AccuRev). Now, if you want to see all your new work or unsaved changes, simply open the Outgoing Changes mode. Want to see all the files that might prevent you from updating your workspace or promoting your changes, click Conflicts. The AccuRev status associated with each file is displayed, but with File Browser modes you no longer have to hunt and peck through over a dozen filters in order to accomplish everyday software development tasks.
Adding new files to a workspace is a common occurrence in daily software development. Prior to AccuRev 6.0, sharing new work with others on your team required separate Add to Depot, Keep, and Promote actions. Now, AccuRev takes care of all the interim actions for you. For example, you can now directly Promote an external file – when you click the Promote button, under the covers AccuRev performs the necessary add and keep actions. Similarly, you can Keep an external file, and AccuRev performs the add action. And in the Incoming Changes mode, the Actions column spells out the actions AccuRev will perform when you update your workspace. As part of these enhancements, the Add to Depot action is no longer discretely available in the AccuRev GUI (through menus or toolbars, for example); the add command, however, remains available in the AccuRev CLI.
Enhanced Keep and Promote Actions in the AccuRev GUI
The layout of streams in the StreamBrowser used to be horizontal – child streams fanned out to the right of their parents, and the stream boxes were aligned in columns, with the size of the stream boxes determined by the maximum name size within that column. For example, a stream named ac_5.5_build was as wide as a stream named ac_5.5_dev_workflow_itr4_doc_dfoster. This setting provided a uniform presentation that made viewing the stream hierarchy easy, but it also required a lot of horizontal space that made it easy to “get lost” in larger depots.
New StreamBrowser Layout Options
AccuRev 6.0 retains the horizontal layout choice, but it now uses a vertical layout by default - child streams appear underneath their parents, and indented. It’s a layout that’s graphically economical and familiar to anyone who has ever used a common tree control. In vertical layout, the stream boxes are always sized to be the width of individual stream names.
A new style property lets you specify the background color for streams using the accurev setproperty command. The style property is specified in XML; colors are set using hex values. Any web-safe color is supported.
New Stream Property Lets You Set Stream Color
In addition to using the style property to manually highlight streams of interest, you might choose to incorporate the accurev setproperty in a script that sets a stream color based on events – you might want to set a build stream to red (#FF0000) if the build fails, and green (#00FF00) when the build passes, for example. Stream background colors are supported in both the AccuRev GUI and the AccuRev Web UI.
The Active Transactions display now provides a show current change package checkbox to control whether the lower pane displays the current state of the related change package (the default prior to Release 6.0), or the state of the change package as it was at the time of the selected transaction (the new default).
Active Transactions Enhancement
The Version Browser has been enhanced in several ways, both to support the latest change package improvements, as well as to make it generally easier to use. The simplification of the Version Browser has allowed us to eliminate the “Basic” and “Advanced” modes, leaving a single, easier-to-navigate display. Whenever possible, workgroups with common versions are now collapsed into “workspace groups”. This not only makes the display much easier to navigate and understand, it reflects the way traditional version graphs summarize the relationship of different versions.
Version Browser Enhancements
The Version Browser display now includes both graphical and tabular panes. The table has two tabs (Streams & Workspaces, and Issues) and displays only information that is relevant in the upper, graphical pane. Selecting a row in the table highlights related items in the graphical view.
In the graphical pane, the version boxes for real versions now also display issue boxes, listing any relevant AccuWork issues for that version. Mousing over most GUI elements displays additional information: mousing over a version box now displays both real version and alias version numbers; mousing over a workspace group displays a list of member workspaces.
Finally, a new Purge line type has been added to the existing Ancestor, Alias, Merge, Patch, and Revert lines.
The AccuRev command line interface (CLI) has a number of new options developed in concert with the enhancements to the File Browser, Version Browser, and change packages.
New CLI Commands and Options
- cpkadd -j
- The new -j option can be used to specify the basis version.
cpkremove -k -j
The new -k option processes all elements with a (kept) status. Use -j to specify the basis version of the segment to be removed.
- hist --show_historic_cpk
the time of the specified transaction. When this option is not specified, hist shows the current state of the change package.
- stat --outgoing
- A new option that includes all files and elements in the workspace, except those with a status of (stranded). Use -i to include elements with a status of (stranded).
The user documentation was updated for AccuRev 6.0. In addition to new content to describe new features and functionality, existing users might be interested in changes to the following books. All of these changes are part of an ongoing effort to streamline the user documentation and provide fewer, more meaningful titles to make product information more accessible.
Changes to the Documentation
On-Line Help GuideThe On-Line Help Guide includes several new chapters:
- Chapter 6, “The Version Browser”
- Chapter 10, “Change Packages”
- Appendix A, “The Schema Editor (Administrators Only)”
Getting Started with AccuRevThe Getting Acquainted with AccuRev guide has been revised to incorporate material from the Day-to-Day Usage of AccuRev guide. Part of this revision included focusing the material on the end-user and changing the title to Getting Started with AccuRev.
The Day-to-Day Usage of AccuRev guide is no longer part of the AccuRev documentation set. The material in this book is now part of the new Getting Started with AccuRev.
Day-to-Day Usage of AccuRev
The Administrator’s Guide includes a preface and a new chapter, Chapter 1, “Setting Up AccuRev”. The material in this chapter was in Getting Acquainted with AccuRev in previous releases.
Chapter 6, “Change Packages” in the Concepts Manual has been modified and moved to the On-Line Help Guide.
Chapter 10, “Promote by Issue” and Chapter 11, “Incomplete Change Packages” in the Technical Notes have been modified and moved to the On-Line Help Guide.
What’s New In AccuRev 5.7
AccuRev Version 5.7 provides important new functionality and numerous improvements designed to unleash the power of software development teams to deliver superior results. Read about the exciting developments in AccuRev 5.7 here. Refer to the release notes for more details about these features and other enhancements.
New AccuRev GUI look and feelThe AccuRev GUI has benefitted from numerous incremental changes in recent releases (workspace coloration and rounded corners for streams in the StreamBrowser are just two examples). In AccuRev 5.7, the entire look and feel of the GUI has changed to enhance both usability and the overall user experience. Some of the highlights include:
- Larger toolbar buttons
- Enhanced tooltips
- Alternate-row coloration in tables (so called zebra or candy striping)
- Crisper, cleaner fonts throughout
- Preference to control tab layout One of the features of the new AccuRev GUI look and feel is scrolling tabs -- when you open more tabs than can be displayed in the AccuRev window, a scroll button appears to provide access to tabs that are not currently visible. If you prefer to have all tabs visible at the same time, you can set a preference that displays tabs in as many rows as needed. The default is to display tabs on a single row and add scrolling as needed.
- Preference for setting the width of streams In previous releases of AccuRev, the width of all stream icons in a column in the StreamBrowser was as wide as the longest stream name in that column. For example, the icon for stream ac_5.5_build would be as wide as stream ac_5.5_dev_workflow_itr4_doc_dfoster. Now you can set a preference on the StreamBrowser tab of the AccuRev Preferences dialog box that makes each stream only as wide as its name.
- Enhanced copy/paste of pathnames You can now copy field values in the Properties dialog box, and in the History Browser, Version Browser, Diff, and other views. For example, to copy the value of the Pathname field in the Properties dialog box, press and hold mouse button 1 and drag the pointer over the value you want to copy.
Features for resolving elements with (twin) statusAccuRev 5.7 introduces several new features and enhancements to help you resolve elements (directories and files) with a (twin) status.
The Twin Resolution Wizard guides you through the process of resolving an element’s twin status, providing options that allow you to:
- Keep one of the elements in conflict (the other is automatically defuncted), and optionally merge the content
Keep both of the elements in conflict (by renaming one of them)
The Twin Resolution Wizard is available from the File Browser, Change Palette, and the default group by choosing Use Wizard from the new Resolve Twin Status shortcut menu of any file with a (twin) status.
- Options that allow you to quickly defunct one of the versions in conflict are directly accessible from the new Resolve Twin Status menu.
- The Overlap and Deep Overlap search filters include elements with a (twin) status.
- The (twin) status is listed first in the Status column.
- Elements with (twin) status are highlighted in yellow in the File Browser, Change Palette, and default group.
Diff Against File in Other StreamAccuRev 5.7 introduces a new Diff operation, Diff Against File in Other Stream, which allows you to diff one file against the same file (or any other file you choose) in another stream.
Filters added to ACL, Depots, Reference Trees, Slices, and Workspaces viewsTable filtering, which was enhanced in AccuRev 5.5, has been added to several other views in the AccuRev GUI, as summarized in the following table:
|View||Filters By This Column|
|ACL tab (Security)||Resource|
Enhanced search capabilities in History Browser and Annotate viewSearch capabilities have been enhanced in the History Browser and Annotate view:
History Browser improvements:
- A Comments only check box allows you to restrict your search to the contents of the Comment column.
If you enter only integers in the Search field and the Comments only check box is cleared, AccuRev searches the Trans. Num column for the value you entered.
The Comments only check box is cleared by default. Searches are performed on all transactions associated with the currently selected element, regardless of whether or not they are currently displayed.
Annotate view improvements:
- Ctrl+F places the focus in the search field, allowing you to enter a search term using only the keyboard.
- The F3 and Enter keys move the focus to the next occurrence of the search term you enter.
- The search field has Previous and Next buttons that let you move from one occurrence of the search term to the next.
CLI options for add, files, and stat commandsAccuRev 5.7 introduces options for the add, files and stat commands to help you work with files that are explicitly ignored by AccuRev:
- -fi includes all files in the command, regardless of whether or not a file or directory matches a pattern in the .acignore file.
- -fI includes only those files and directories that match the patterns specified in the .acignore file.
- --ignore specifies a pattern of elements; external elements matching this pattern are ignored by the command.
License Type for usersYou can now specify a user’s license type in the AccuRev GUI. Valid values are Full (AccuRev, AccuWork, and Kando), AccuWork, and Kando Only. Note that options for the related mkuser and chuser CLI commands have changed accordingly.
Local, client-based Timestamp Optimization is the defaultIn previous releases, AccuRev used traditional, server-based Timestamp Optimization (TSO) as the default TSO algorithm. As of AccuRev 5.7, local, client-based TSO is the AccuRev system default.
Installer supports Windows 8AccuRev can now be installed on machines running the Windows 8 operating system.
What’s New In AccuRev 5.6
Support for streamlined client upgrades
AccuRev 5.5 laid the foundation for speeding AccuRev client upgrades in the enterprise. Starting with AccuRev 5.6, the AccuRev Installation Wizard provides the opportunity to download client-only installation packages to the AccuRev Server. Once the AccuRev Server has been upgraded to AccuRev 5.6, supported AccuRev 5.5 clients can upgrade to AccuRev 5.6 directly from the AccuRev GUI * or CLI (*accurev upgrade_client).
GUI support for stream properties
AccuRev added support for stream properties in the CLI in AccuRev 5.5. You can now create and manage stream properties through the AccuRev GUI. In addition, the getproperty command now returns the filename for properties whose value was specified as a file.
GUI support for EACLs
Element Access Control Lists (EACLs) are a set of permissions granting privileges to users for elements under AccuRev control. In previous releases, permissions could be set and managed only through the AccuRev CLI. You can now set and manage permissions using the GUI.
New Diff Against options for overlapped elements
AccuRev 5.6 introduces new Diff Against options to help you identify and resolve conflicts that result in an (overlap) status.
- Overlapping Changes > Mine diffs the workspace or stream version against the common ancestor in the backing stream. This option identifies the changes in the workspace or stream that did not come from the backing stream.
- Overlapping Changes > Theirs allows you to see only the changes added to the backing stream since the last time you merged with the backing stream. This option is useful for identifying the changes to the backing stream that caused the overlap condition.
You can now print tables in the AccuRev GUI.
Support for rich text in text fields
Text fields in the GUI can now be optionally configured to support rich text (bold and italic fonts, bulleted and ordered lists, and so on). In addition to properly rendering content formatted in HTML, when the rich text feature is enabled a toolbar is added to text fields allowing users to easily create and work with:
- Bold, italic, underlined, and colored text
- Ordered and bulleted lists
- Paragraph formatting
Rich text editing can be enabled on a per-field basis. If you add a new text field to your schema, rich text editing support is enabled by default.
64-bit AccuRev versions available for Solaris
AccuRev now offers 64-bit versions of AccuRev Server and AccuRev Client on both Sparc and x86 platforms, providing enterprise-class scalability.
Improved AccuBridge for Atlassian Crucible
Iterative reviews in Crucible are now supported through the AccuBridge for Crucible.
In addition to logging on the AccuRev Server, AccuRev now supports logging on the AccuRev Client.
New -u option for show command
A new option for the show … groups command, -u , shows the groups to which a user belongs. See the CLI help or AccuRev CLI User’s Guide for more information.
Accelerator keys for common operations
Accelerator keys have been added for many common and frequently performed operations like promote *and update *(Ctlr+U).
What’s New In AccuRev 5.5
User Interface and Ease of Use Enhancements:
- Stream Favorites are an easy and intuitive way to create and manage filters on streams. Stream Favorites can be shared with other users and groups in your AccuRev depot.
- Simplified, more intuitive layout for frequently performed operations like Update and Search.
- A displayed “count” of the number of elements returned by a workspace search.
- Support for Ctrl+x, Ctrl+c, Ctrl+v shortcut keys for Cut, Copy, and Paste operations.
- Streamlined promote procedure allows you to first select issues and then enter a comment when change packages are enabled.
- The ability to navigate the StreamBrowser by dragging the background; this feature is also supported in the Version Browser.
- Features to help distinguish workspaces from other streams.
- The display of workflow rules that have been set for a stream.
- The display of Kando™ information for AccuRev streams that are backed by a Git repository.
- The ability to display third-party ITS keys, AccuWork issue keys, both, or neither, in the History Browser.
- Dramatic improvement in performance between master and replica. A new setting on replica servers lets you specify whether or not to use data compression to tune performance on low bandwidth networks.
Administration and Installation:
- A new command, upgrade_client, that will allow users of AccuRev 5.5x and later to download and install the latest AccuRev client software directly from an upgraded AccuRev server.
- New commands to help you create and manage properties on users, groups, and streams —setproperty, getproperty, and rmproperty. The show command has a new option that allows you to display properties for users, groups, and streams.
- A new readonly privilege for the eacl command that prevents the user from modifying the element or its ACL during add, keep, move, defunct, and revert commands.