Installation and Configuration
Install from update site
|Update Site URL|
Generally only use the stable update site. Use the development snapshots update site to try out the latest features or to help test the next version.
Install from update site Instructions
In Eclipse add the update site "Help"->"Install New Software...". Exact screens may vary depending on Eclipse version.
To add the site click on the Available software tab. You should see something like the following screenshot:
Now click on the Add site... button and enter one of the Update Site URLs listed above. Select the newly added site and click on Install to start download and installation.
Install from source
And finally, if you want to try out the most recent changesets in our development repository, have a look at Hackers deploy section.
Eclipse's preferences can be accessed by selecting to Windows->Preferences (Windows/Linux) respectively Eclipse->Preferences in the Application's menu.
Note: Some of this section may be obsolete
The MercurialEclipse plugin adds to the already existing Eclipse preferences. On the left side, in the tree, you should see an entry named MercurialEclipse. Please click on it. You should see the main MercurialEclipse preference page similar to the preferences I use, shown in the following screenshot.
|Mercurial Executable||The path to the hg executable.||A valid path, e.g. /usr/local/bin/hg. This entry must be valid and filled.|
|Gpg Executable||The path to the gpg executable.||A valid path, e.g. /usr/local/bin/gpg or nothing if Gpg is not used.|
|Mercurial Username||The default Mercurial username.||Overrides the configuration in your hgrc files. You need not fill it.|
|Use external merge tool for resolving conflicts||Switch between internal Eclipse merge and configured merge tool.||If not selected, use Mercurial simplemerge and then the Eclipse internal merge facilities|
|When a folder contains files with different statuses, flag the folder: as modified||Always mark resource changes, additions, etc. with the modified decorator image.||selected / unselected|
|When a folder contains files with different statuses, flag the folder: with the most important status||Always mark resource changes, additions, etc. with the associated decorator image.||selected / unselected|
|Enable font and color decoration||Enables color and fonts settings for decorators. This will slow down decorator performance.||selected / unselected|
|Automatically associate MercurialEclipse with new projects containing a Mercurial repository||Checks if newly opened projects are already associated with an Eclipse Team provider. If not, it checks if this settings is set. If it is, it checks if the project has a Mercurial repository in the project directory or uptree. If this true as well, such anewly opened project is automatically shared as MercurialEclipse team project.||selected / unselected|
|Number of commit messages to save||The number of previously entered commit messages to be saved for remembering them in the Commit dialog.||Should not exceed 30 as each saved comment will get added to a combo box in commit dialog|
Console preference page
This preference page controls how the Mercurial console behaves and looks like. The Mercurial console shows each Mercurial command and enables you to see how MercurialEclipse interacts with Mercurial.
|Wrap text||Do line wraps if necessary||selected / unselected|
|Console width||Number of characters to fit in one line||between 10 and 999|
|Limit output||Don't keep the full history of an Eclipse session in the console||selected / unselected|
|Number of characters||Number of characters to limit the console to||a number|
|Open console on message||Creates and opens a console if no console is open and brings the console view to the foreground when the Mercurial console receives a message.||selected / unselected|
|Show all Hg messages||Shows complete Mercurial output. USE WITH CARE as hg log and hg status data is output, too. So the amount of data written can become huge.||selected / unselected|
|Command color||The color with which Mercurial command invocations are displayed||a color|
|Message color||The color with which plugin messages are displayed||a color|
|Error color||The color with which error messages are displayed||a color|
Performance preference page
This preference page enables you to set performance related settings.
|hg log revision limit||The number of changesets / revisions to pull in a batch, e.g. in the History view||a number|
|Number of files to query hg status with||The number of files which we may add to one invocation to status||a number|
|Always call hg status for whole repository||Always get the status for all repository files instead of getting the status for single or multiple files. This option should be switched on (Bastian's Hint)||selected / unselected|
|Compute deep decoration||Enabling this will calculate the refreshed resources' uptree status in order to decorate the whole tree and all folders correctly. This option is a waste of time if the status option is set to getting status for the whole repository||selected / unselected|
|Show changeset information for files||This adds additional information to each resource's decoration like the last author, changeset-index of last modification etc. The downside of this is that it comes with a huge performance penalty.||selected / unselected|
Timeouts preference page
This preference page allows you to specify the longest time you want to wait for an operation. Usually the defaults are sufficient, so if you don't see timeouts just leave these settings alone.