Skip to content

Commit 83efbd8

Browse files
committed
---
yaml --- r: 182804 b: refs/heads/beta c: 761efa5 h: refs/heads/master v: v3
1 parent b8d3f3e commit 83efbd8

File tree

2 files changed

+1
-72
lines changed

2 files changed

+1
-72
lines changed

[refs]

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ refs/heads/automation-fail: 1bf06495443584539b958873e04cc2f864ab10e4
3131
refs/heads/issue-18208-method-dispatch-3-quick-reject: 2009f85b9f99dedcec4404418eda9ddba90258a2
3232
refs/heads/batch: b7fd822592a4fb577552d93010c4a4e14f314346
3333
refs/heads/building: 126db549b038c84269a1e4fe46f051b2c15d6970
34-
refs/heads/beta: 47905f98eef9c0ee5d64eb8c536c821e86f6c4cd
34+
refs/heads/beta: 761efa5e8c82c365304f143e550def966603847e
3535
refs/heads/windistfix: 7608dbad651f02e837ed05eef3d74a6662a6e928
3636
refs/tags/1.0.0-alpha: e42bd6d93a1d3433c486200587f8f9e12590a4d7
3737
refs/heads/tmp: eb836bf767aa1d8d4cba488a9091cde3c0ab4b2f

branches/beta/src/doc/reference.md

Lines changed: 0 additions & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -2493,77 +2493,6 @@ Supported traits for `derive` are:
24932493
* `Show`, to format a value using the `{}` formatter.
24942494
* `Zero`, to create a zero instance of a numeric data type.
24952495

2496-
### Stability
2497-
2498-
One can indicate the stability of an API using the following attributes:
2499-
2500-
* `deprecated`: This item should no longer be used, e.g. it has been
2501-
replaced. No guarantee of backwards-compatibility.
2502-
* `experimental`: This item was only recently introduced or is
2503-
otherwise in a state of flux. It may change significantly, or even
2504-
be removed. No guarantee of backwards-compatibility.
2505-
* `unstable`: This item is still under development, but requires more
2506-
testing to be considered stable. No guarantee of backwards-compatibility.
2507-
* `stable`: This item is considered stable, and will not change
2508-
significantly. Guarantee of backwards-compatibility.
2509-
* `frozen`: This item is very stable, and is unlikely to
2510-
change. Guarantee of backwards-compatibility.
2511-
* `locked`: This item will never change unless a serious bug is
2512-
found. Guarantee of backwards-compatibility.
2513-
2514-
These levels are directly inspired by
2515-
[Node.js' "stability index"](http://nodejs.org/api/documentation.html).
2516-
2517-
Stability levels are inherited, so an item's stability attribute is the default
2518-
stability for everything nested underneath it.
2519-
2520-
There are lints for disallowing items marked with certain levels: `deprecated`,
2521-
`experimental` and `unstable`. For now, only `deprecated` warns by default, but
2522-
this will change once the standard library has been stabilized. Stability
2523-
levels are meant to be promises at the crate level, so these lints only apply
2524-
when referencing items from an _external_ crate, not to items defined within
2525-
the current crate. Items with no stability level are considered to be unstable
2526-
for the purposes of the lint. One can give an optional string that will be
2527-
displayed when the lint flags the use of an item.
2528-
2529-
For example, if we define one crate called `stability_levels`:
2530-
2531-
```{.ignore}
2532-
#[deprecated="replaced by `best`"]
2533-
pub fn bad() {
2534-
// delete everything
2535-
}
2536-
2537-
pub fn better() {
2538-
// delete fewer things
2539-
}
2540-
2541-
#[stable]
2542-
pub fn best() {
2543-
// delete nothing
2544-
}
2545-
```
2546-
2547-
then the lints will work as follows for a client crate:
2548-
2549-
```{.ignore}
2550-
#![warn(unstable)]
2551-
extern crate stability_levels;
2552-
use stability_levels::{bad, better, best};
2553-
2554-
fn main() {
2555-
bad(); // "warning: use of deprecated item: replaced by `best`"
2556-
2557-
better(); // "warning: use of unmarked item"
2558-
2559-
best(); // no warning
2560-
}
2561-
```
2562-
2563-
> **Note:** Currently these are only checked when applied to individual
2564-
> functions, structs, methods and enum variants, *not* to entire modules,
2565-
> traits, impls or enums themselves.
2566-
25672496
### Compiler Features
25682497

25692498
Certain aspects of Rust may be implemented in the compiler, but they're not

0 commit comments

Comments
 (0)