mirror of
https://github.com/apple/swift.git
synced 2025-12-21 12:14:44 +01:00
35 lines
1.0 KiB
Markdown
35 lines
1.0 KiB
Markdown
# 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:
|
|
```sh
|
|
-Werror DeprecatedDeclaration
|
|
```
|
|
|
|
Or upgrade all warnings except deprecated declaration to errors:
|
|
```sh
|
|
-warnings-as-errors -Wwarning DeprecatedDeclaration
|
|
```
|
|
|
|
|
|
## Topics
|
|
|
|
- <doc:clang-declaration-import>
|
|
- <doc:deprecated-declaration>
|
|
- <doc:preconcurrency-import>
|
|
- <doc:strict-language-features>
|
|
- <doc:strict-memory-safety>
|
|
- <doc:unknown-warning-group>
|
|
|