13.3 Code Coverage Files List Context Menu

The first items in the context menu allow you to open the first selected file, using the Editor tool. There are three ways to open the file:

Open With Color	Open the file for editing as usual, and add Code Coverage coloring. This corresponds to calling hcl:editor-color-code-coverage with `:for-editing t`. You can then edit the file as usual.
Open	Open the file in the usual way without any code coverage information.
Open With Counters	Open a special buffer (with a different name from the filename) with the code of the file, add code coverage coloring and also counters. This corresponds to calling hcl:editor-color-code-coverage with `:for-editing nil`. The buffer is made read-only initially. Adding counters means that the buffer contains extra characters, and it is therefore not useful to edit it, though you can make it writable and/or save it if this is useful. Note that the buffer name is constructed by appending `"-code-coverage"` to the filename, and this will be the default filename when you save it. Note that if this file is opened again with `:for-editing nil`, either from the tool or other call to hcl:editor-color-code-coverage, the previous special buffer is automatically deleted (see hcl:editor-color-code-coverage).

You can configure the coloring via Works > Tools > Preferences... > Code Coverage Browser > Coloring. The four check buttons correspond to the :color-covered, :color-uncovered, :runtime-only and :comment-counters keyword arguments in hcl:editor-color-code-coverage, and setting them sets the default values for these keywords.

By default, opening the file opens the file matching the truename that is recorded in the code coverage data and is displayed by default in the last column. You can change that by creating pathname mapping, which maps some root pathname to another one. You do that via Works > Tools > Preferences... > Code Coverage Browser > Pathname Mapping. If both of the Map from: and To: strings are not empty, the tool finds the pathname to use by first computing a relative pathname of truename relative to the Map From: pathname map-from, and then merging it with the To: pathname to, that is:

(merge-pathnames (enough-namestring truename map-from) to)

The next 4 items in the context menu operate on all of the selected files:

Mark Done	Mark the selected files as Done. Marking changes the color in which the line for the file is displayed, and can be hidden by Hide Done, but otherwise has no effect.
Mark Not Done	Mark the selected files as Not Done.
Hide Selected	Hide (remove from the list) the selected files.

The remaining items in the context menu operate on the list of files as a whole:

Hide Done	Hide the files that are marked as Done.
Unhide Others	Show all the hidden files.
Traverse	Implements the traverse operation. See 13.4 Traverse.