- 19.12 (released) ...
Error List Tool
- Accessing the Tool
- Reading Errors and Warnings
- Filtering Errors and Warnings
- Navigating Errors and Warnings
- Copying Errors and Warnings
The Error List Tool is a general purpose tool for logging error and warning conditions raised when compiling or using other parts of the EiffelStudio interactive development environment. Optionally, the tool can aid in the process of fixing problems by filtering both errors and warnings.
Accessing the Tool
The Error List Tool will be shown automatically at the end of a compilation if an error occurs during any part of the compilation,
or it can be accessed via the EiffelStudio menu path:
View --> Tools --> Error List
or from the default shortcut key
Reading Errors and Warnings
There are numerous ways to gather information on the errors and warnings logged to the tool. Even when the tool is not shown directly, because it is displayed tabbed behind another tool or docked as a hidden slide-in tool on one of the EiffelStudio's bounding window edges, there's enough visible information to indicate how many errors and warnings were generated during the last compilation or in another processing task.
By default, the tool's title (in the tab-docked tab or on the tool's title bar when visible) will read 'Error List'. In its default state there are no errors or warnings. When performing a compilation resulting in the logging of any number of errors or warnings the tool title will be update to indicate the respective number of errors and warning as Error List (#Errors, #Warning) where #Errors indicates the number of logged errors and #Warnings indicates the number of logged warnings. When there are no errors or warnings the tool's title will be reset to the default title Error List.
When the tool is visible, not only does the tab (if docked) and the title bar reflect the number of logged errors and warnings but the tool bar Errors and Warnings filter toggle buttons also reflect the number of respective logged errors and warnings. For more information on filtering error and warnings, see Filtering Errors and Warnings .
Reading Logged Error and Warning Reports
When performing a task that produces errors and/or warning the tool will display a number of rows containing information on the logged errors and warnings. Error rows are indicated with the error icon ( ) and warnings with the exclamation icon ( ). Both errors and warnings show a single-line, terse description of the offending issue. Error and warning entries can be expanded by clicking the adjacent (+) to reveal a verbose description and an indication on how possibly to fix the problem. You can also press
RIGHT (right arrow) or
+ (plus) to expand a selected row. To collapse a row either click the (-), or press
Error can be automatically expanded to reveal the more verbose information immediately. Toggling the Expand Errors ( ) button will automatically expand or collapse when toggled on or off respectively.
Error and Warning Help
If you are unsure exactly what the error or warning code means, then you can receive help by selecting the error and pressing the Error Info tool bar button ( ). Alternately pick and drop may be used to pick the error code from the error or warning onto the Error Info button.
Filtering Errors and Warnings
There is no limit on the number of errors or warnings that can be shown in the tool. All the errors and warnings mean something and should be addressed. However, sometimes it is desirable to filter errors and warnings while you work through the process of fixing the causes of them. Also sometimes it is advantageous to set temporarily the level of warnings you receive without modifying the project configuration.
There are two types of filtration, basic and fine-grained. Basic filtering can be applied to both warnings and errors. Fine-grained filtering applies only to warnings.
Basic filtering of the errors and warnings can be achieved by toggling with tool bar Errors and/or Warnings button. Both are toggled on by default so all errors and warnings are displayed. Toggling either off will hide the error or warnings respectively.
For warnings, it might be desirable to filter out specific warnings temporarily without modifying the project's configuration file. You can do this by using the Filter ( ) tool bar button. Uncheck any warnings that you do not want to be shown in the tool. When warnings are being filtered, the Filter button is displayed with exclamation icon overlay ( ) to indicate that some warnings may not appear in the tool because they are being filtered out. The fine-grained filter state is only effective during the current EiffelStudio project session. Anything more permanent should be done by changing the project settings.
When performing any type of filtering, the error and warning count information is unaffected. This indicates that there can be more errors and warnings than are actually visible in the tool.
Navigating Errors and Warnings
There are multiple ways to navigate the logged errors and warnings in the Error List Tool and for some, it doesn't even require the tool to be in view or even opened at all.
All navigation functions off of the currently selected logged error or warning. When the Error List tool is open and in view the most direct way to navigate between the errors and warnings is through the tool itself. There are four tool bar buttons designed for this purpose:
These tool bar buttons are mirrored in the Project main menu. Those actions mirrored in the Project menu do not require the tool to be opened or be in view, providing a shortcut to their actual function.
There are also a matching number of keyboard shortcuts that can be used with or without the Error List tool being in view; To go to the next error use
F8, To go to the previous error use
F8, to go to the next warning use
F8 and to go to the previous warning use
In the event of no visible errors or warnings, the respective Next/Previous buttons and menu items will be unavailable. This is also effective when filtering errors and warnings, as the unseen logged error and warnings are treated as if they had never been logged ensuring that, when navigating, the irrelevant errors and warnings are bypassed.
When navigating between a logged error or warning the context where the error/warning occurred is shown. At anytime, double-left clicking on an error or warning will show the corresponding context to that logged error/warning. Pressing ENTER on the selected error or warning will also show the correspond context.
The pick and drop mechanism may also be used to navigate to any part of an error's or warning's context. Any colored text in the logged error/warning description is pickable, even the Position information.
Copying Errors and Warnings
From time to time it may be helpful to copy the information in one or more logger errors and/or warnings. To perform a copy of the information, select one or more logged errors and/or warning in the tool and press
C. The selected error and warning information will then be placed into the clipboard of the resident operating system.