Reporting Issues
Bug 3749 - Update Package YAML files to ignore specific ECC files/errors
Summary: Update Package YAML files to ignore specific ECC files/errors
Status: RESOLVED FIXED
Alias: None
Product: EDK2
Classification: Unclassified
Component: Code (show other bugs)
Version: Current
Hardware: All All
: Lowest normal
Assignee: Michael Kinney
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2021-11-23 16:10 UTC by Michael Kinney
Modified: 2022-01-14 20:18 UTC (History)
6 users (show)

See Also:
EDK II Code First industry standard specifications: ---
Branch URL:
Release(s) the issue is observed: EDK II Master
The OS the target platform is running: ---
Package: ArmPkg, ArmPlatformPkg, ArmVirtPkg, CryptoPkg, EmulatorPkg, MdeModulePkg, MdePkg, SecurityPkg, ShellPkg, StandaloneMmPkg, UefiPayloadPkg, UnitTestFrameworkPkg
Release(s) the issues must be fixed: EDK II Master
Tianocore documents:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Michael Kinney 2021-11-23 16:10:08 UTC
A number of packages have ECC issues that were present before
the ECC check was enabled, or there have been no patch reviews 
against the lines of code in those packages that have ECC errors.

The work on the uncrustify source formatting tool is modifying
many lines of source files in packages that do have ECC issues.
These ECC issues do need to be reviewed and fixed, but that
work can be deferred till after the uncrustify source format
changes are made.

The temporary fix is to amend the EccCheck section of the 
Package YAML files with a set of IgnoreErrors and IgnoreFiles
statements to remove errors reported by the ECC tool.
Comment 1 Michael Kinney 2021-11-23 16:10:50 UTC
Assign to owner
Comment 2 Pierre Gondois 2021-11-25 06:12:45 UTC
Hello Michael,
I don't understand why we need to exclude some files/folders from the EccCheck to enable Uncrustify. Aren't they two different tools ? How do the files/folders are selected ?
From what I saw, even with the files/folders that are newly excluded, there are still EccError that are triggered.

For instance, in the ArmPlatformPkg:
- Error 9003
- ArmPlatformPkg/Drivers/NorFlashDxe/NorFlashBlockIoDxe.c
 -The first line of text in a comment block should be a brief description of the element being documented and the brief description must end with a period.
- line 109
is an error that remains. (remainder: ArmPlatformPkg/Drivers/PL061GpioDxe/PL061Gpio.c is to be excluded from the EccCheck, but not ArmPlatformPkg/Drivers/NorFlashDxe/NorFlashBlockIoDxe.c).

Regards,
Pierre
Comment 3 Pierre Gondois 2021-11-25 06:44:42 UTC
I think I now understand why some files are excluded, but shouldn't them be re-included once the Uncrustify modifications have been merged ?
Comment 4 Michael Kinney 2022-01-14 20:14:35 UTC
Each package owner need to review their YAML files and work on
address all ECC issues.  We can open new issues for each package.
The goal should be no ECC exceptions in any package and the YAML
files have no ECC exceptions listed and from that point forward
any proposed code change that has an ECC issues will be caught by
EDK II CI and require submitter to resolve before it can be merged.