A couple of days ago somebody asked me how to use Forge after having installed the JBoss Tools nighty build. This is a valid question and indeed not so obvious at the moment. We don't want to overload the top level Eclipse menubar and toolbar so it is somewhat hidden until we find a good spot for the shortcuts. Suggestions are of course always welcome.


The Long and Winding Road

The normal way to start Forge is to start it by pressing the start toolbar button or choosing the start menu entry of the Forge Console View.


Now the question of course is how you can open this Forge Console View. This can be done by selecting the 'Forge->Forge Console' entry in the Eclipse 'Show View' dialog.


Now the question of course is how you can open this fancy 'Show View' dialog. The long and winding road to do this would be to use the Eclipse menu bar and select 'Window->Show View->Other...'. Luckily there is a quicker alternative to do this last step only using your keyboard:

  • Windows and Linux: press Alt+Shift+Q and then another Q
  • Mac: press Option+Cmd+Q and then another Q


The Fast Lane

Even with this last keyboard trick this is a very long process and it would be good if there was a faster way to do it. The good news is that there actually is a shortcut. Earlier, we posted how to bring up a popup containing all the Forge commands applicable in the current context

  • Windows and Linux: Ctrl+4
  • Mac: press Cmd+4

Now if only we extended the functionality of this combination to startup Forge if it is not running? That is exactly what we did. Pressing the above key combination brings up a dialog if Forge is not running yet and asks you if you want to start it.

forge_not_running.pngPressing 'Yes' on this menu will start Forge, open the Forge Console View and bring this last view into focus. If the above combination does not work on your machine (because of a different keyboard layout) or if you would like to hook up this functionality to a different keystroke combo, you can do so by bringing up the Eclipse Preferences dialog:

  • Windows and Linux: choose 'Window->Preferences'
  • Mac: choose 'Eclipse->Preferences...' or press Cmd+, (that is Cmd and the comma).

preferences.png As you can see in the above screenshot, you can change the binding by selecting the 'General->Keys' entry and then look for the 'Forge Command List' command. Go into the 'Binding' field and choose your favourite keyboard combination.


The Result

Whether you take the long and winding road or the fast lane, the result should in both cases that you are seeing the Forge welcome banner and a prompt inviting you to enter your command of choice.



This is a work in progress. If you have any suggestions to make a better binding, or ideas about a proper perspective or menu that could be a home for this functionality, be my guest!