Skip to content

Commit 9a2c968

Browse files
committed
deprecated_lints: align doc comment indents with pub LINT_NAME
1 parent 1acea2e commit 9a2c968

File tree

1 file changed

+56
-56
lines changed

1 file changed

+56
-56
lines changed

clippy_lints/src/deprecated_lints.rs

Lines changed: 56 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -5,79 +5,79 @@ macro_rules! declare_deprecated_lint {
55
}
66

77
declare_deprecated_lint! {
8-
/// **What it does:** Nothing. This lint has been deprecated.
9-
///
10-
/// **Deprecation reason:** This used to check for `assert!(a == b)` and recommend
11-
/// replacement with `assert_eq!(a, b)`, but this is no longer needed after RFC 2011.
8+
/// **What it does:** Nothing. This lint has been deprecated.
9+
///
10+
/// **Deprecation reason:** This used to check for `assert!(a == b)` and recommend
11+
/// replacement with `assert_eq!(a, b)`, but this is no longer needed after RFC 2011.
1212
pub SHOULD_ASSERT_EQ,
1313
"`assert!()` will be more flexible with RFC 2011"
1414
}
1515

1616
declare_deprecated_lint! {
17-
/// **What it does:** Nothing. This lint has been deprecated.
18-
///
19-
/// **Deprecation reason:** This used to check for `Vec::extend`, which was slower than
20-
/// `Vec::extend_from_slice`. Thanks to specialization, this is no longer true.
17+
/// **What it does:** Nothing. This lint has been deprecated.
18+
///
19+
/// **Deprecation reason:** This used to check for `Vec::extend`, which was slower than
20+
/// `Vec::extend_from_slice`. Thanks to specialization, this is no longer true.
2121
pub EXTEND_FROM_SLICE,
2222
"`.extend_from_slice(_)` is a faster way to extend a Vec by a slice"
2323
}
2424

2525
declare_deprecated_lint! {
26-
/// **What it does:** Nothing. This lint has been deprecated.
27-
///
28-
/// **Deprecation reason:** `Range::step_by(0)` used to be linted since it's
29-
/// an infinite iterator, which is better expressed by `iter::repeat`,
30-
/// but the method has been removed for `Iterator::step_by` which panics
31-
/// if given a zero
26+
/// **What it does:** Nothing. This lint has been deprecated.
27+
///
28+
/// **Deprecation reason:** `Range::step_by(0)` used to be linted since it's
29+
/// an infinite iterator, which is better expressed by `iter::repeat`,
30+
/// but the method has been removed for `Iterator::step_by` which panics
31+
/// if given a zero
3232
pub RANGE_STEP_BY_ZERO,
3333
"`iterator.step_by(0)` panics nowadays"
3434
}
3535

3636
declare_deprecated_lint! {
37-
/// **What it does:** Nothing. This lint has been deprecated.
38-
///
39-
/// **Deprecation reason:** This used to check for `Vec::as_slice`, which was unstable with good
40-
/// stable alternatives. `Vec::as_slice` has now been stabilized.
37+
/// **What it does:** Nothing. This lint has been deprecated.
38+
///
39+
/// **Deprecation reason:** This used to check for `Vec::as_slice`, which was unstable with good
40+
/// stable alternatives. `Vec::as_slice` has now been stabilized.
4141
pub UNSTABLE_AS_SLICE,
4242
"`Vec::as_slice` has been stabilized in 1.7"
4343
}
4444

4545
declare_deprecated_lint! {
46-
/// **What it does:** Nothing. This lint has been deprecated.
47-
///
48-
/// **Deprecation reason:** This used to check for `Vec::as_mut_slice`, which was unstable with good
49-
/// stable alternatives. `Vec::as_mut_slice` has now been stabilized.
46+
/// **What it does:** Nothing. This lint has been deprecated.
47+
///
48+
/// **Deprecation reason:** This used to check for `Vec::as_mut_slice`, which was unstable with good
49+
/// stable alternatives. `Vec::as_mut_slice` has now been stabilized.
5050
pub UNSTABLE_AS_MUT_SLICE,
5151
"`Vec::as_mut_slice` has been stabilized in 1.7"
5252
}
5353

5454
declare_deprecated_lint! {
55-
/// **What it does:** Nothing. This lint has been deprecated.
56-
///
57-
/// **Deprecation reason:** This used to check for `.to_string()` method calls on values
58-
/// of type `&str`. This is not unidiomatic and with specialization coming, `to_string` could be
59-
/// specialized to be as efficient as `to_owned`.
55+
/// **What it does:** Nothing. This lint has been deprecated.
56+
///
57+
/// **Deprecation reason:** This used to check for `.to_string()` method calls on values
58+
/// of type `&str`. This is not unidiomatic and with specialization coming, `to_string` could be
59+
/// specialized to be as efficient as `to_owned`.
6060
pub STR_TO_STRING,
6161
"using `str::to_string` is common even today and specialization will likely happen soon"
6262
}
6363

6464
declare_deprecated_lint! {
65-
/// **What it does:** Nothing. This lint has been deprecated.
66-
///
67-
/// **Deprecation reason:** This used to check for `.to_string()` method calls on values
68-
/// of type `String`. This is not unidiomatic and with specialization coming, `to_string` could be
69-
/// specialized to be as efficient as `clone`.
65+
/// **What it does:** Nothing. This lint has been deprecated.
66+
///
67+
/// **Deprecation reason:** This used to check for `.to_string()` method calls on values
68+
/// of type `String`. This is not unidiomatic and with specialization coming, `to_string` could be
69+
/// specialized to be as efficient as `clone`.
7070
pub STRING_TO_STRING,
7171
"using `string::to_string` is common even today and specialization will likely happen soon"
7272
}
7373

7474
declare_deprecated_lint! {
75-
/// **What it does:** Nothing. This lint has been deprecated.
76-
///
77-
/// **Deprecation reason:** This lint should never have applied to non-pointer types, as transmuting
78-
/// between non-pointer types of differing alignment is well-defined behavior (it's semantically
79-
/// equivalent to a memcpy). This lint has thus been refactored into two separate lints:
80-
/// cast_ptr_alignment and transmute_ptr_to_ptr.
75+
/// **What it does:** Nothing. This lint has been deprecated.
76+
///
77+
/// **Deprecation reason:** This lint should never have applied to non-pointer types, as transmuting
78+
/// between non-pointer types of differing alignment is well-defined behavior (it's semantically
79+
/// equivalent to a memcpy). This lint has thus been refactored into two separate lints:
80+
/// cast_ptr_alignment and transmute_ptr_to_ptr.
8181
pub MISALIGNED_TRANSMUTE,
8282
"this lint has been split into cast_ptr_alignment and transmute_ptr_to_ptr"
8383
}
@@ -93,39 +93,39 @@ declare_deprecated_lint! {
9393
}
9494

9595
declare_deprecated_lint! {
96-
/// **What it does:** Nothing. This lint has been deprecated.
97-
///
98-
/// **Deprecation reason:** The original rule will only lint for `if let`. After
99-
/// making it support to lint `match`, naming as `if let` is not suitable for it.
100-
/// So, this lint is deprecated.
96+
/// **What it does:** Nothing. This lint has been deprecated.
97+
///
98+
/// **Deprecation reason:** The original rule will only lint for `if let`. After
99+
/// making it support to lint `match`, naming as `if let` is not suitable for it.
100+
/// So, this lint is deprecated.
101101
pub IF_LET_REDUNDANT_PATTERN_MATCHING,
102102
"this lint has been changed to redundant_pattern_matching"
103103
}
104104

105105
declare_deprecated_lint! {
106-
/// **What it does:** Nothing. This lint has been deprecated.
107-
///
108-
/// **Deprecation reason:** This lint used to suggest replacing `let mut vec =
109-
/// Vec::with_capacity(n); vec.set_len(n);` with `let vec = vec![0; n];`. The
110-
/// replacement has very different performance characteristics so the lint is
111-
/// deprecated.
106+
/// **What it does:** Nothing. This lint has been deprecated.
107+
///
108+
/// **Deprecation reason:** This lint used to suggest replacing `let mut vec =
109+
/// Vec::with_capacity(n); vec.set_len(n);` with `let vec = vec![0; n];`. The
110+
/// replacement has very different performance characteristics so the lint is
111+
/// deprecated.
112112
pub UNSAFE_VECTOR_INITIALIZATION,
113113
"the replacement suggested by this lint had substantially different behavior"
114114
}
115115

116116
declare_deprecated_lint! {
117-
/// **What it does:** Nothing. This lint has been deprecated.
118-
///
119-
/// **Deprecation reason:** This lint has been superseded by the warn-by-default
120-
/// `invalid_value` rustc lint.
117+
/// **What it does:** Nothing. This lint has been deprecated.
118+
///
119+
/// **Deprecation reason:** This lint has been superseded by the warn-by-default
120+
/// `invalid_value` rustc lint.
121121
pub INVALID_REF,
122122
"superseded by rustc lint `invalid_value`"
123123
}
124124

125125
declare_deprecated_lint! {
126-
/// **What it does:** Nothing. This lint has been deprecated.
127-
///
128-
/// **Deprecation reason:** This lint has been superseded by #[must_use] in rustc.
126+
/// **What it does:** Nothing. This lint has been deprecated.
127+
///
128+
/// **Deprecation reason:** This lint has been superseded by #[must_use] in rustc.
129129
pub UNUSED_COLLECT,
130130
"`collect` has been marked as #[must_use] in rustc and that covers all cases of this lint"
131131
}

0 commit comments

Comments
 (0)