Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Subversive New and Noteworthy"
| Line 1: | Line 1: | ||
| − | '''Also see the New & Noteworthy for:''' [[Subversive New and Noteworthy for Luna|Luna]], [[Subversive New and Noteworthy for Kepler|Kepler]], [[Subversive New and Noteworthy for Juno|Juno]], [[Subversive New and Noteworthy for Indigo|Indigo]], [[Subversive New and Noteworthy for Helios|Helios]], [[Subversive New and Noteworthy for Galileo|Galileo]] | + | '''Also see the New & Noteworthy for:''' [[Subversive New and Noteworthy for Mars|Mars]], [[Subversive New and Noteworthy for Luna|Luna]], [[Subversive New and Noteworthy for Kepler|Kepler]], [[Subversive New and Noteworthy for Juno|Juno]], [[Subversive New and Noteworthy for Indigo|Indigo]], [[Subversive New and Noteworthy for Helios|Helios]], [[Subversive New and Noteworthy for Galileo|Galileo]] |
== Introduction == | == Introduction == | ||
| − | Main target of this release is | + | Main target of this release is performance optimization and introduction of SVN 1.9 support. |
| − | == SVN 1. | + | == SVN 1.9 support == |
| − | + | ||
| − | + | All the changes in SVN API that aren't regarded as experimental ones were reflected in SVN integration API. These changes are covered by the following tasks: [https://bugs.eclipse.org/bugs/show_bug.cgi?id=488472 488472], [https://bugs.eclipse.org/bugs/show_bug.cgi?id=485022 485022], [https://bugs.eclipse.org/bugs/show_bug.cgi?id=488453 488453], [https://bugs.eclipse.org/bugs/show_bug.cgi?id=487220 487220] and [https://bugs.eclipse.org/bugs/show_bug.cgi?id=487147 487147]. For the exact details please check the following section. | |
== Rework of SVN integration API == | == Rework of SVN integration API == | ||
| − | + | The following API calls were added: | |
| − | + | * setConfigurationEventHandler() - set an event handler that will be called every time the configuration is loaded by this client object | |
| − | * | + | * getConfigurationEventHandler() - returns a reference to the installed configuration event handler |
| − | * | + | * vacuum() - recursively vacuum a working copy, removing unnecessary data, including unversioned, externals, unused pristines, ignored and fixing time stamps |
| − | * | + | The following API calls now accept additional behaviour switches: |
| − | + | * status() | |
| − | + | * merge() | |
| − | * | + | * mergeTwo() |
| − | * | + | * exportTo() |
| − | + | * copyLocal() | |
| − | + | The following API calls signatures were changed: | |
| − | + | * revert() | |
| − | + | * cleanup() | |
| − | + | * getInfo() | |
| + | * streamFileContent() | ||
| + | * copyLocal() | ||
| + | * copyRemote() | ||
| + | * annotate() | ||
| + | The following previously deprecated API calls were removed: | ||
| + | * mergeStatus() | ||
| + | * merge() - the ones that were a counterpart to mergeStatus() | ||
| + | Those modifications had no actual impact on the high-level command framework API. | ||
| − | + | == Latest SVN client libraries included == | |
| − | + | ||
| − | + | Bugs [https://bugs.eclipse.org/bugs/show_bug.cgi?id=485024 485024], [https://bugs.eclipse.org/bugs/show_bug.cgi?id=485025 485025], [https://bugs.eclipse.org/bugs/show_bug.cgi?id=480040 480040], [https://bugs.eclipse.org/bugs/show_bug.cgi?id=480039 480039] and [https://bugs.eclipse.org/bugs/show_bug.cgi?id=487147 487147]. SVN Kit 1.8.12 supports SVN 1.9 working copy. While the native clients provide full-featured support for SVN 1.9. | |
| − | + | ||
| − | == | + | == Changes in extension points == |
| − | + | * The IOptionProvider interface was changed so that it allows to add configuration options in the future in a way which won't lead to new API changes. All the options now are provided in a uniform way, using the following methods: | |
| + | ** get() - returns the option's value by its name | ||
| + | ** getString() - returns the option's value which is of the String type (basically it is a wrapper to the "get" call) | ||
| + | ** has() - returns true if the option is set at all | ||
| + | ** is() - returns true if the option is set to true (basically it is a wrapper to the "get" call) | ||
| + | * The ICommitActionFactory interface now allows integrations to completely manage the comment editor control and so, now it contains few more methods: | ||
| + | ** initCommentManager() - called upon the CommentComposite initialization | ||
| + | ** confirmMessage() - called each time "Ok" button is pressed | ||
| + | ** cancelMessage() - called each time "Cancel" button is pressed | ||
| + | * The IModifiableCommentDialogPanel interface is now marked as deprecated, since its functions were completely overtook by the more functional ICommentManager interface. | ||
== Usability improvements == | == Usability improvements == | ||
Revision as of 13:50, 5 April 2016
Also see the New & Noteworthy for: Mars, Luna, Kepler, Juno, Indigo, Helios, Galileo
Contents
Introduction
Main target of this release is performance optimization and introduction of SVN 1.9 support.
SVN 1.9 support
All the changes in SVN API that aren't regarded as experimental ones were reflected in SVN integration API. These changes are covered by the following tasks: 488472, 485022, 488453, 487220 and 487147. For the exact details please check the following section.
Rework of SVN integration API
The following API calls were added:
- setConfigurationEventHandler() - set an event handler that will be called every time the configuration is loaded by this client object
- getConfigurationEventHandler() - returns a reference to the installed configuration event handler
- vacuum() - recursively vacuum a working copy, removing unnecessary data, including unversioned, externals, unused pristines, ignored and fixing time stamps
The following API calls now accept additional behaviour switches:
- status()
- merge()
- mergeTwo()
- exportTo()
- copyLocal()
The following API calls signatures were changed:
- revert()
- cleanup()
- getInfo()
- streamFileContent()
- copyLocal()
- copyRemote()
- annotate()
The following previously deprecated API calls were removed:
- mergeStatus()
- merge() - the ones that were a counterpart to mergeStatus()
Those modifications had no actual impact on the high-level command framework API.
Latest SVN client libraries included
Bugs 485024, 485025, 480040, 480039 and 487147. SVN Kit 1.8.12 supports SVN 1.9 working copy. While the native clients provide full-featured support for SVN 1.9.
Changes in extension points
- The IOptionProvider interface was changed so that it allows to add configuration options in the future in a way which won't lead to new API changes. All the options now are provided in a uniform way, using the following methods:
- get() - returns the option's value by its name
- getString() - returns the option's value which is of the String type (basically it is a wrapper to the "get" call)
- has() - returns true if the option is set at all
- is() - returns true if the option is set to true (basically it is a wrapper to the "get" call)
- The ICommitActionFactory interface now allows integrations to completely manage the comment editor control and so, now it contains few more methods:
- initCommentManager() - called upon the CommentComposite initialization
- confirmMessage() - called each time "Ok" button is pressed
- cancelMessage() - called each time "Cancel" button is pressed
- The IModifiableCommentDialogPanel interface is now marked as deprecated, since its functions were completely overtook by the more functional ICommentManager interface.
Usability improvements
Since m2e is now a project under Eclipse.org umbrella, we too moved Subversive-m2e integration to Eclipse (bug 455407). This way it'll be much easier to install to the ones who need this integration.
Since there're conflicts in key binding schemes (due to global key bindings in the operating environment or with other plug-ins in Eclipse IDE) we have created our own predefined schemes "Default + Subversive" and "Default + Subversive (Ubuntu)". Each of them introduces a slight changes in key combinations in order to provide access to all the important features through keyboard accelerators (bugs 456139 and 309074).
There are some cases when user do not want to go along with the connectors installation procedure the moment it is proposed automatically by the connectors discovery feature. The decision is saved and there is no way to call discovery feature second time. If such a case happens, there is a lot of work to install connectors later, since the user must find the URL to the correct version of the connectors updates site, then add it in Eclipse Installation Manager before installing connectors themselves. In order to resolve the situation we have added the fast access button in the connectors selection page of plug-in preferences (bug 442249).
SVN supports multiline properties, while the automatic properties configuration page doesn't, since the new line separates properties from each other. This prevents using automatic properties in case a multiline one is needed. In order to solve the issue we have introduced a new syntax of defining a property in Automatic Properties dialog. In order to define a multiline one you just need to separate supposed lines with the \n character sequence. In case you actually need to define a \n character sequence in your property, then just use the masked one: \\n (bug 445999).
Also there are typical SVN errors requiring user to perform some actions over the working copy. It is nothing strange when you know what to expect, but may confuse a beginner. So, we made a special page in the Subversive's help, that describes those typical errors and possible solutions. The help page could be summoned directly from the error notification dialog, which should enhance beginners experience with SVN (bug 457516).