Mercurial NetBeans Plugin Module Release Notes

Release Notes for Revision 1.0

Platforms Smoke tested on

If you've run a quick smoke test of the plugin please add your own platform details if they aren't already here.

OS Hg Plugin NetBeans Java (java -version) Mercurial (hg --version)
OpenSolaris (nevada b61) rev 1.0 rc5 6.0 Preview (M9, build 070501) Java HotSpot(TM) Server VM (build 1.5.0_11-b03, mixed mode) Mercurial Distributed SCM (version 0.9.3)
Windows XP version 5.1 running on x86 en_GB (nb); Cp1252 rev 1.0 rc5 6.0 Preview (M9, build 070502) Java HotSpot(TM) Client VM 1.6.0_02-ea-b02 Mercurial Distributed SCM (version 0.9.3+20061222)
Fedora Core 3 rev 1.0 rc5 6.0 Preview (M9, build 070502) Java HotSpot(TM) Server VM (build 1.5.0_11-b03, mixed mode) Mercurial Distributed SCM (version 0.9.3)

Supported Mercurial Version

This release will only work with Mercurial 0.9.3. The code runs a "hg version" command looking for the "0.9.3" string. In future revs we will make this less restrictive, allowing users to continue if the version check fails #103144. If you do not have the supported Mercurial version installed you will see an empty Mercurial menu, we need to get additional platform support to stop this empty menu appearing if the appropriate version of Mercurial is not installed.


If you have installed an earlier version of the plugin please uninstall and restart the IDE before installing Mercurial Plugin Rev 1.0 rc5, upgrades will be supported in future releases.


Rollback will rollback the last repository commit, push or pull. It will update the repository and your working directory. Sometimes some project files in the IDE can be out of sync with what's now in the repository and working dir. To correct this, just open the file in the IDE modify it and resave it. This issue will be addressed in rev 1.1 by ensuring a forced refresh in the IDE happens after a rollback if any files have been modified #103103 #103125.

Selective Updates/ Reverts

Currently there is no way for a user to revert a file or update all files in the working directory to anything other than the head (tip) revision. We need to add support to allow users to perform selected Updates or Reverts to specific revisions. This is planned for rev 1.1 #103101
In the meantime users can do selective Updates/ Reverts to a specific revision by using the Hg command line support, within the project directory by just using the -r flag to the hg revert command, or explicitly specifying a revision to the hg update command:

  • hg revert -r REV NAME ...
  • hg update REV

Copy semantics

If you copy a file under a Hg controlled project, changes in the source are not propagated to the copy, which would be the normal Hg behavior. This is a current limitation of the Platforms Version control Interceptor and an RFE has been filed to address it.#102523

  • Note: correct Hg copy propagation does work for rename as this event is caught by the Interceptor.

Rename New File not Supported

In this release renaming a new file, which has not yet been committed, is not supported and doing so will leave you with an internally refactored file that you will need to manually correct #102717


After an uninstall please restart the IDE to ensure the Mercurial menu items are fully removed. Mercurial menu items are still available after uninstall of the plugin and before a restart of the IDE #103214

Mercurial Configuration

Currently there is no support for setting Mercurial global properties or repository-specific properties from the IDE. If you want to set any Mercurial properties just use the normal Hg configuration file support detailed in the man page below:

Hg view (Hgk)

Hgk is a powerful repository viewer, displaying the changesets of a Mercurial repository in a graphical form. It is part of the base Hg distribution and can be invoked by typing "hg view" in a repository directory.


Hgk does not run on Solaris nevada out of the box. It requires a more recent version of Tcl/Tk than is currently shipped on nevada, though it should be there soon. In the meantime to get it running you will need to do the following:

  • Build and install tclsh8.4 and wish8.4 from source (current 8.3 versions will not work), then cd into your Hg repository and type:
  • $ export PATH=$PATH:/usr/demo/mercurial/; wish8.4 /usr/demo/mercurial/hgk
Not logged in. Log in, Register

By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2012, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo