Skip to content

Commit

Permalink
Add mention to RFC 940 in the Rust Reference.
Browse files Browse the repository at this point in the history
- It also keeps mentions to RFCs consistent with the format "RFC XXX"
  • Loading branch information
Isaac Andrade committed May 2, 2016
1 parent d80497e commit 8f76f93
Showing 1 changed file with 17 additions and 3 deletions.
20 changes: 17 additions & 3 deletions src/doc/reference.md
Expand Up @@ -845,6 +845,20 @@ extern crate std; // equivalent to: extern crate std as std;
extern crate std as ruststd; // linking to 'std' under another name
```

When naming Rust crates, hyphens are disallowed. However, Cargo packages may
make use of them. In such case, when `cargo.toml` doesn't specify a crate name,
Cargo will transparently replace `-` with `_` (Refer to [RFC 940] for more
details).

Here is an example:

```{.ignore}
// Importing the Cargo package hello-world/
extern crate hello_world; // The crate name replaced the hyphen
```

[RFC 940]: https://github.com/rust-lang/rfcs/blob/master/text/0940-hyphens-considered-harmful.md

#### Use declarations

A _use declaration_ creates one or more local name bindings synonymous with
Expand Down Expand Up @@ -3720,9 +3734,9 @@ Since `'static` "lives longer" than `'a`, `&'static str` is a subtype of

## Type coercions

Coercions are defined in [RFC401]. A coercion is implicit and has no syntax.
Coercions are defined in [RFC 401]. A coercion is implicit and has no syntax.

[RFC401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
[RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md

### Coercion sites

Expand Down Expand Up @@ -3862,7 +3876,7 @@ Coercion is allowed between the following types:

In the future, coerce_inner will be recursively extended to tuples and
structs. In addition, coercions from sub-traits to super-traits will be
added. See [RFC401] for more details.
added. See [RFC 401] for more details.

# Special traits

Expand Down

0 comments on commit 8f76f93

Please sign in to comment.