Allows the developer to re-use existing version names and
select previously used version names from a list. Normally,
VA Java does not allow version names to be re-used (e.g., once you have
named a version "1.0", you can't name any other edition of the
same item "1.0"). There are times, however, when re-using a
version name makes sense. One common scenario is the case where you have
just versioned a project as "1.0" and discover one more bug to
fix. Fixing the bug requires creating a new edition which must be
versioned. Ideally, you would like to just re-use the "1.0" name
and then purge out the old "1.0". This option allows you to do
that.
VA Assist also provides the ability to automatically update the JavaDoc
@version tags and version
methods/fields for all classes and interfaces that are being versioned.
It works regardless of how you version (e.g., automatic, one
name or name each) or at what level you version (e.g., project, package or
type). Any type with an @version tag or version method/field will be updated. Those without
@version tags or version methods/fields are left alone (which means that you have to add the
@version tag or version method/field yourself to any type that does not have one).
Version descriptions/comments may also be
entered that will help identify this version in any edition lists. If an edition description has already been specified for
the item, that text will be provided as the default. The description entered will be
applied to all items that are being currently versioned. If you want each items to retain
its own, existing edition description, leave this field blank. If you want to provide a
unique version description for each item, use the "Name Each" option when
versioning. The Name Each dialog also has a field for supplying a version description.
The settings area of the dialog allows the developer to toggle the ability to use (or
re-use) any name, set Version Templates and
specify that the export dialog should be opened after
versioning.
These options may also be configured via the "VA Assist |
Versions" options
page.
