manual-premium.md: how to generate compliance report (danmar#6890)

Author: danmar

man/manual-premium.md

@@ -1166,6 +1166,37 @@ Command to active Misra C++ 2008 checkers:
 
     cppcheck --premium=misra-c++-2008 ....
 
+## Compliance report
+
+### Graphical user interface
+
+Run a analysis with some coding standards enabled. After that you can click on
+the `Compliance report...` in the `File` menu.
+
+### Command line
+
+There is a tool `compliance-report` that is distributed with Cppcheck Premium. To see
+all available options run `compliance-report` in a terminal with any options.
+
+Below is example usage to generate a Misra C 2012 compliance report.
+
+1. Execute cppcheck and save warnings in an xml file. Save the checkers report.
+
+    `cppcheck --premium=misra-c-2012 --checkers-report=r.txt --xml src 2> results.xml`
+
+2. Use `compliance-report` to convert the files to an html report.
+
+    `compliance-report --misra-c-2012 --project-name=Device --project-version=2.3 --checkers-report=r.txt --output-file=report.html results.xml`
+
+Description of the options:
+
+ * `--misra-c-2012`: Generate a compliance report for misra-c-2012
+ * `--project-name`: The name of the project
+ * `--project-version`: The version of the project
+ * `--checkers-report`: Provide the checkers report generated by Cppcheck
+ * `--output-file`: html filename that the report should be written to
+ * `results.xml`: The xml output from cppcheck
+
 ## Licenses
 
 ### Individual license