Next: , Previous: The Shell and Python Windows, Up: Description of the Main Windows


2.14 The Locations Tree

The Location Tree is filled whenever GPS needs to display a list of locations in the source files (typically, when performing a global search, compilation results, and so on).

locations-view.jpg

The Location Tree shows a hierarchy of categories, which contain files, which contain locations. Clicking on a location item will bring up a file editor at the requested place. Right-clicking on file or category items brings up a contextual menu allowing you to remove the corresponding node from the view.

Every time a new category is created, as a result of a compilation or a search operation for instance, the first entry of that category is automatically selected, and the corresponding editor opened. This behavior can be controlled through a preference Jump To First Location.

To navigate through the next and previous location (also called Tag), you can use the menu items Navigate->Previous Tag and Navigate->Next Tag, or the corresponding key bindings.

Left-clicking on a line in the Location Tree brings up a contextual menu with the following entries:

Sort by subcategory
Toggle the sorting of the entries by sub-categories. This is useful, for example, for separating the warnings from the errors in the build results.
Expand category
Expand all the files in the current categories.
Collapse all
Collapse all the categories in the Locations View
Jump to location
Open the location contained in the message, if any.
Clear Locations View
Remove all entries from the Locations View.

In some cases, a wrench icon will be associated on the left of a compilation message. See Code Fixing for more information on how to make advantage of this icon.