Common Problems and Solutions
Outdated validation messages
When validation messages (errors or warnings) shown in the CommaSuite editors seem outdated it is useful to revalidate all files using:
-
Project > Clean
Sometimes a complete restart may be needed.
Updating the Documentation Template
The documentation template is a subject of regular updates. Existing projects may still use an outdated template. In some cases this can even result in errors during the execution of the generation tasks. To solve this, delete or rename the existing template and import the new one:
-
right-click on the project file and select 'Import Documentation Template' from the context menu.
Errors with names that duplicate keywords
If there are errors with names that duplicate keywords, use the escape character before the names, for instance ^type.
Problem saving a file
In case there is a problem with saving a file,
changing the character encoding to UTF-8 might help:
Right click on the file, select Properties; see Resource > Text file encoding > Other ; select UTF-8; Apply and Close
Files are not opened with right editor
It may happen that files are opened with the wrong editor by default.
For instance, '.event' files are opened with the text editor without syntax highlighting.
As an example, change the default editor for '.event' files as follows:
Right click on the file, select Open with > Other From the list select the TraceEvents editor and select the box before "Use it for all '*.events' files"
