FAQ



Emacs+ for Eclipse FAQ:

Eclipse versions: Which versions of Eclipse does Emacs+ support?

          Emacs+ 4.x.x supports all versions of Eclipse E4 starting with Kepler.  It can also be used with Juno, but Eclipse key-binding support was wonky in that release.
          Emacs+ 3.6.5 supports all versions of Eclipse from Europa to Indigo.

Team (CVS, SVN, etc.) commands in Helios:  What happened to all the Team commands (M-x commit, M-x compare-with-latest-from-repository, etc.) that were available in previous versions of Eclipse?

[update: this appears to be fixed in the SR1 release of Helios]
The Eclipse team fixed a bug (300526) in 3.6 that resulted in a number of regressions in the team commands.  According to Eclipse bug 306173 the fix for this will not be available until 3.6.1 sometime in September 2010.   A workaround that will re-enable some (but not all) of the commands is to modify the Command Groups Availability for each perspective where you want the commands to appear:
  1. Go to the perspective (e.g. Java, Debug, etc.) you want to modify
  2. Go to Window -> Customize Perspective... 
  3. Select the Command Groups Availability tab
  4. Add Team
  5. Add CVS (SVN, etc. as appropriate)
  6. Repeat as necessary for each perspective

Keyboard Macros:
Why do I sometimes see transposed characters after executing a keyboard macro?

Certain features of Eclipse's specialized editors can impact the creation of keyboard macros.  For example, the Java editor provides options for the auto-closing of parentheses, brackets, strings, etc.  Along with this it adds the convenience of letting the user type the closing syntax, and rather than re-inserting the close it moves forward to the next position.  Unfortunately, Eclipse doesn't expose this in a way Emacs+ can detect, so when defining a keyboard macro, users should avoid typing the closing syntax when it has already been inserted and use Ctrl-F instead. See keyboard macros in Emacs+ for additional information.


Keyboard Macros:
Why does Eclipse show M-X [Aborted] when I attempt to execute a named keyboard macro?

To enable Alt-X execution of a named keyboard macro, the Emacs+ Keyboard Macros category must be present in the list of Executable Command Categories in the Emacs+ Preferences.  If you have modified this list prior to installing Emacs+ 3.x, it may not be present by default.  If it is not, select New and add it from the interface.

Also, attempting to execute a misspelled command name in the minibuffer will provoke this message.


Keyboard Macros:
Why does the execution of my keyboard macro end prematurely?

Eclipse cannot distinguish between the replayed key event and any actual character the user may type on the keyboard during macro execution.  Emacs+ detects this and interrupts the execution of the macro.  See keyboard macros in Emacs+ for additional information.


Key bindings and international keyboards: Why do some key strokes call an Emacs+ command rather than generating the character I want, and what can I do about it?

Certain key bindings may interfere with the key codes generated on an international keyboard.  A common example is the AltGraph key.  Internally in Eclipse this is interpreted as Ctrl+Alt.  So, if there is character that requires the AltGraph+key and a key binding, like Ctrl+Alt+[, that calls a command, you will need to unbind the command in order to generate the character. This is done through the Keys Preferences page.  Go to Window -> Preferences -> General -> Keys, locate the command, select it and use the Unbind Command button (at this point you can also rebind the command if desired).

NB: A quick way to determine the appropriate command to unbind is to use the describe-key command (bound to Ctrl+H K).


Key bindings and Mac OS X:  Can I swap Alt for Command as Meta in the Emacs+ key bindings?

On the update site there are a pair of subsidiary plugins that will do precisely that.  See Installation Details for more information.


Key bindings and Mac OS X:  Emacs+ interferes with the shortcuts for entering symbols and international characters (or vice-versa).  How can I turn this off?

The easiest way is to swap Alt for Command as Meta in the Emacs+ key bindings.  See Installation Details for more information.


Other key binging issues:  What happened to the quick fix key binding?

If you have Optional Bindings feature installed and have enabled the Force digit-argument interpretation preference, the default binding for the quick fix command (Ctrl+1 or COMMAND+1 on Mac OS X) will be shadowed by the digit-argument.  To restore the default binding either disable the preference or unbind the Emacs+ binding for Ctrl+1 (or COMMAND+1).  Alternatively, you can supply a different binding for quick fix.


Other key binding issues:  What's up with the Emacs+ key bindings? (aka why is Emacs+ not working?)

In most cases this is due to issues in the Eclipse key binding mechanism.  After making sure you have properly set the Emacs+ scheme, try reverting to the default bindings and then re-enabling the Emacs+ scheme (see the key binding issues page for instructions on resetting the bindings in Eclipse).  For more general questions on key bindings, see the Eclipse help documentation.  A good discussion is contained in the Workbench Users Guide section under Reference -> Preferences -> Keys


Warnings: What does the warning: Cannot bind to an undefined command mean?

[Note: this should no longer be an issue in Emacs+ 3.5.0 and above]
This may occur when loading the Optional bindings and your Eclipse environment does not have the javascript plugin loaded.  Eclipse errs on the side of verbosity, and there does not appear to be any way for Emacs+ to suppress these warnings.  They are annoying, but harmless.


Ctrl+A and Ctrl+E: Is there a way to redefine Ctrl-A to go all the way to the beginning of the line rather than stopping at some indent point along the way?

The behavior of Ctrl+A (and Ctrl+E) is controlled by an Eclipse preference.  Go to: Window -> Preferences -> General -> Editors -> Text Editors and uncheck the Smart caret positioning at line start and end preference.


Favorite: How do I 'Favorite' Emacs+ (and why)?

The new Eclipse Marketplace site has replaced the old rating system with a simple Favorites mechanism.  Although a login is required, once created, simply selecting the star in the Emacs+ icon near the top of Emacs+' Marketplace page will add it to your favorites.  This will help to increase the visibility of Emacs+ and make it easier for others to find it.


Local install: How can Emacs+ be installed when my Eclipse is prevented from accessing the update site? 

Download the desired release from the source site (see below).  Un-zip it into a local directory and build it.  Now you can point your Eclipse at the Emacs+Update sub-directory of that local directory rather than the update site and perform the install/update as usual.


Sources:

          Sources to the 4.x.x version can be found at github.


MulgaSoft:  Who or what is MulgaSoft? 

MulgaSoft is the programming arm of Mark Feber


Emacs+ for IntelliJ IDEA FAQ:

<Coming Soon>