summaryrefslogtreecommitdiffstats
path: root/src/tools/clippy/src/docs/useless_attribute.txt
blob: e02d4c90789841e64801ded5d4a3a51d2ad4f0c3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
### What it does
Checks for `extern crate` and `use` items annotated with
lint attributes.

This lint permits lint attributes for lints emitted on the items themself.
For `use` items these lints are:
* deprecated
* unreachable_pub
* unused_imports
* clippy::enum_glob_use
* clippy::macro_use_imports
* clippy::wildcard_imports

For `extern crate` items these lints are:
* `unused_imports` on items with `#[macro_use]`

### Why is this bad?
Lint attributes have no effect on crate imports. Most
likely a `!` was forgotten.

### Example
```
#[deny(dead_code)]
extern crate foo;
#[forbid(dead_code)]
use foo::bar;
```

Use instead:
```
#[allow(unused_imports)]
use foo::baz;
#[allow(unused_imports)]
#[macro_use]
extern crate baz;
```