[[Property:title|External compilation pane]]
[[Property:weight|3]]
[[Property:uuid|26525412-e8e5-8b1c-1074-58e00aed4c76]]


[[Image:External compilation pane 01]]  


==Introduction==

During the majority of ordinary development projects in Eiffel, it may be rare for programmers to need to know what's going on with the external compilation that occurs during freezing and finalization steps. However, during the development of some types of systems, particularly those that involve interfaces to non-Eiffel components, it is helpful to monitor the external compilation.

The external compilation pane shows a log of the compilation output from the external (typically C language) compiler. But the external compilation pane is more than just a log. It has powerful features that help you deal with the results of external compilation.

==Selecting your locale==

If the external compiler uses a different locale than your default locale, you can select your particular locale in the "Locale" box on the bottom bar of the Outputs tool.

==Opening a project folder==

You can explore a project folder by using '''open folder''' ( [[Image:general-open-icon|open]] ) on the bottom bar. When you click the triangle ( [[Image:toolbar-dropdown-icon]] ) to the right of the '''open folder''' icon, you will see a list of project folders, as shown in the figure below.

[[Image:Outputs tool Open folder|open]]

Selecting one of this will cause the folder to be opened by the explorer appropriate to your platform, such as Windows Explorer in the case of the Microsoft Windows platform.

==Starting a terminal session in a project folder==

The Outputs tool gives you a way to create a new terminal or console window targeted to one of your project folders. To do this, click the triangle ( [[Image:toolbar-dropdown-icon]] ) to the right of the '''terminal''' icon ( [[Image:terminal-icon|terminal]] ). You'll see a list of project folders like the one shown [[#Opening a project folder|above]]. Choose a folder and a terminal window will be created and targeted to the folder you selected.

==Opening a file mentioned in the external compilation output==

You can open a file mentioned in the external compiler output in a specified external editor by selecting the file name and then clicking the '''send to external editor''' ( [[Image:metrics-tool--command-send-to-external-editor-icon|send to external editor]] ) button, shown in the bottom bar of the following figure:

[[Image:External compilation pane file selection|Selecting a file to open]]  

If, as is often the case with C compilation errors, a line number is adjacent to the file name, you can select the line number and the file will be opened in the external editor and the cursor positioned at that line number.

==View external code for a class/feature==

You can view the external code for a particular Eiffel class or feature in an external editor. Pick the class or feature whose generated code you want to see, and drop it onto the [[Image:metrics-tool--command-send-to-external-editor-icon|send to external editor]] button. The external code for the class or feature will be shown in an external editor. 

The figure below shows an example of picking the feature <code>make</code> and dropping it on the '''send to external editor''' button.

[[Image:External compilation pane edit feature]]  

You can also drop a class or feature pebble on the '''open folder''' or '''terminal''' icon. This will get you to the folder in which the generated code for the class or feature resides. 

===View external code from the finalized folder===

By default the code that you see in an external editor is from the workbench (W_code) folder. You can see the corresponding external code from the finalized (F_code) folder by holding the <code>CTRL</code> key while you drop the class or feature pebble.