Files
swift-mirror/userdocs/diagnostics/diagnostic-groups.md
Ben Barham b3dd0ac2fa [Doc] Add missing diagnostic groups
These were meant to be part of #82002, but forgot to add them.
2025-06-07 11:13:16 -07:00

1.0 KiB

Diagnostic groups

Diagnostic groups allow controlling the behavior of warnings in a more precise manner.

Overview

Diagnostic groups collect some number of diagnostics together under a common group name. This allows for extra documentation to help explain relevant language concepts, as well as the ability to control the behavior of warnings in a more precise manner:

  • -Werror <group> - upgrades warnings in the specified group to errors
  • -Wwarning <group> - indicates that warnings in the specified group should remain warnings, even if they were previously upgraded to errors

As a concrete example, to upgrade deprecated declaration warnings to errors:

-Werror DeprecatedDeclaration

Or upgrade all warnings except deprecated declaration to errors:

-warnings-as-errors -Wwarning DeprecatedDeclaration

Topics