JBoss.orgCommunity Documentation

Chapter 2. Using Forge

To begin using Forge, launch the Forge Console view by navigating to WindowShow ViewOtherForgeForge Console.

Selecting the Forge Console from the Views menu.

Figure 2.1. Forge Console selection


The Forge Console will launch in an inactive state. How and when Forge starts can be changed, see Chapter 5, Preferences.

Forge in an inactive state.

Figure 2.2. The Forge Console


To start Forge, click the green arrow in the Forge Console.

Starting Forge.

Figure 2.3. Starting Forge


Once Forge starts you will notice the name Forge appear in the Forge Console view and a command line currently in your root workspace directory, without a project selected.

Started Forge.

Figure 2.4. Started Forge


From the Forge Console command line you can type the command cd (change directory) followed by the directory to change to, and if a navigator view is opened, the navigator view will also change to the specified directory. If the resource is not in the local workspace and the Remote Systems view is open, the directory will be selected in the Remote Systems explorer.

Showing that the Remote Systems view is linked to what occurs in the Forge Console view.

Figure 2.5. Remote Systems view with the Forge Console


Through the Forge Console you can also link the console output to the currently open editor by clicking on the Link with Editor button.

The button to link the Forge Console output with the currently open Editor.

Figure 2.6. Link with Editor button


If you find it easier to navigate your project via the Project Explorer view, you can right-click on a file from this view and select Show InForge Console from the context menu.

Opening a file in Forge from the Project Explorer.

Figure 2.7. Opening a file in Forge from the Project Explorer


This will automatically execute the pick-up command, changing the current Forge runtime context to the selected resource and opening the file or folder. For more on this command see: Section 4.2, “The pick-up command”

Having executed the menu option on a file, the file is now opened in an editor and the Forge runtime context has changed.

Figure 2.8. Executing the menu option on a file


If you close the Forge Console view, Forge will continue to run in the background. Re-opeing the Forge Console view will display the latest Forge state.

To stop Forge, click on the red square in the Forge Console.

Stopping the Forge runtime.

Figure 2.9. Stopping Forge