Remote Makefile Editor

Edit online

The Remote Makefile Editor provides the following features:

  • Syntax coloring
  • Folding
  • Content assist
  • Open Declarations
  • Save As action
  • Outline view
  • Hovers.

Syntax coloring

The Remote Makefile Editor color codes syntax, such as comments, and makefile targets. This coloring makes it easier to visually understand the structure of the source code that you are editing. You can also modify the color and font settings through the Remote Makefile Editor preference page.

Folding

When the folding preference is activated, the Remote Makefile Editor collapses, or folds, the contents of the editor into sections which make it more manageable.

Save As

You can use the Save As action to save documents to a remote location.

Opening declarations

Edit online

You can use the Open Declaration action to open the declaration of a selected makefile element.

About this task

Note: Included makefiles not in the workspace are not resolved by the Remote Makefile Editor's content assistant.
The selection must be a valid variable or target for the editor to open the declaration. For example, you can select a variable and invoke the Open Declaration action to go to the line where the variable is declared or open the file that contains the declaration of the variable.

To invoke the Open Declaration action, do any of the following in the Remote Makefile Editor:

  • Right-click the reference to open the pop-up menu and select Open Declaration.
  • Place the cursor on the reference and press F3.

The declaration of the selected makefile element is located and the cursor is moved to the declaration. In the case where the declaration is another file in the workspace, the file that contains this declaration is opened.

Using Hovers in the Remote Makefile Editor

Edit online

You can use hovers to view the value of a variable.

About this task

Note: Included makefiles not in the workspace are not resolved by the Remote Makefile Editor during variable value determination when hovering.

Procedure

To view a variable's value in a hover, complete the following step:

Move your mouse pointer so that it is over the variable you want to inspect, and leave it there for a moment. A hover will appear displaying the variable's value.

Using content assist in the Remote Makefile Editor

Edit online

You can use content assist to help you complete a target or variable in the Remote Makefile Editor.

About this task

Note: Included makefiles not in the workspace are not resolved by the Remote Makefile Editor's content assistant.
To perform content assist, complete the following steps:

Procedure

  1. The placement of the cursor in your code provides the context for the content assist to offer suggestions for completion. Place the cursor in a valid position on a line of code in the Remote Makefile Editor, start typing a target or variable name, and then do one of the following to launch content assist:
    1. Press Ctrl+Spacebar to provide proposals.
    2. Select Edit > Content Assist from the menu bar to proposals.
  2. Use the arrow keys or scroll bars to navigate the completion list.
  3. To choose a completion from the list, do one of the following:
    1. Select the completion and press Enter.
    2. Double-click the completion.

Using the Outline view in the Remote Makefile Editor

Edit online

The Outline view is a tree representation of the current makefile that you are editing. It is updated as text is modified in the editor.

About this task

This view displays a structural view of makefile elements such as variables, targets, and included files. When you select any of these elements in the Outline view, the editor moves to the location of the element in the source file.

You can display the following elements in the Outline view:

  • variables
  • targets
  • commands
  • included makefiles
  • conditional statements
You can customize the Outline view by ordering or filtering elements according to certain criteria using the view toolbar. For example, you can:
  • Order the Outline view alphabetically.

Comment and Uncomment

Edit online

You can use the Comment and Uncomment actions in the Remote Makefile Editor to toggle whether or not a line is a comment line.

About this task

To change one or more lines into a comment line, do any of the following in the Remote Makefile Editor:
  • Place the cursor on a line, or select multiple lines, then right-click on a line to open the pop-up menu and select Comment.
  • Place the cursor on a line, or select multiple lines, and press Ctrl+/.

To change one or more lines from a comment line, to a regular line, do any of the following in the Remote Makefile Editor:

  • Place the cursor on a line, or select multiple lines, then right-click on a line to open the pop-up menu and select Uncomment.
  • Place the cursor on a line, or select multiple lines, and press Ctrl+\.