Main Content

-ignore-code-annotations

Ignore C/C++ code annotations justifying Polyspace results and show all results as unreviewed

Since R2022a

Syntax

-ignore-code-annotations

Description

-ignore-code-annotations causes a Polyspace® analysis to ignore code annotations justifying Polyspace results and show previously annotated results as unreviewed.

To avoid reviewing a result multiple times, you can add Polyspace-specific annotations to your code with review information such as justification for a result. Later runs take into account these annotations and prepopulate the annotated results with associated review information. However, in some cases, you might want to run a clean analysis as if the results have not been previously reviewed. You can use the option -ignore-code-annotations to run such an analysis with no history. The analysis ignores the code annotations and shows all annotated results without any review information taken from the annotations.

For instance, an analysis that takes into account code annotations shows these features:

  • The Results Details pane for an annotated result is prepopulated with the review information. You can use filters to hide or show these annotated results.

    Annoated result as it appears in the Polyspace user interface

  • Statistics on the Dashboard perspective in Polyspace Access use review information from the annotations. For instance, results that are justified using annotations are counted as Done.

If you use the option -ignore-code-annotations, both the individual results and the aggregated statistics do not include information from the code annotations.

For details on the code annotations workflow, see Annotate Code and Hide Known or Acceptable Results.

If you are running an analysis from the user interface (Polyspace desktop products only), on the Configuration pane, you can enter this option in the Other field. See Other.

Examples

To ignore previous code annotations, use the option -ignore-code-annotations.

  • Bug Finder:

    polyspace-bug-finder -sources file.c -ignore-code-annotations
  • Bug Finder Server:

    polyspace-bug-finder-server -sources file.c -ignore-code-annotations
  • Code Prover:

    polyspace-code-prover -sources file.c -ignore-code-annotations
  • Code Prover Server:

    polyspace-code-prover-server -sources file.c -ignore-code-annotations

Tips

If you do not want to see any previous review information, you must also make sure that you are not importing review information from previous results. For instance, make sure that:

  • You are not using options such as -import-comments.

  • You have disabled automatic comment import from last results in the Polyspace user interface.

See also Import Review Information from Previous Polyspace Analysis.

Version History

Introduced in R2022a