3030/// explicitly using `as` allows a few more coercions that aren't allowed implicitly, such as
3131/// changing the type of a raw pointer or turning closures into raw pointers.
3232///
33- /// Other places `as` is used include as extra syntax for [`crate`] and [ `use`] , to change the name
33+ /// Other places `as` is used include as extra syntax for [`crate`] and `use`, to change the name
3434/// something is imported as.
3535///
3636/// For more information on what `as` is capable of, see the [Reference]
3737///
3838/// [Reference]:
3939/// https://doc.rust-lang.org/reference/expressions/operator-expr.html#type-cast-expressions
4040/// [`crate`]: keyword.crate.html
41- /// [`use`]: keyword.use.html
4241mod as_keyword { }
4342
4443#[ doc( keyword = "const" ) ]
@@ -75,7 +74,7 @@ mod as_keyword { }
7574/// const WORDS: &str = "hello convenience!";
7675/// ```
7776///
78- /// `const` items looks remarkably similar to [ `static`] items, which introduces some confusion as
77+ /// `const` items looks remarkably similar to `static` items, which introduces some confusion as
7978/// to which one should be used at which times. To put it simply, constants are inlined wherever
8079/// they're used, making using them identical to simply replacing the name of the const with its
8180/// value. Static variables on the other hand point to a single location in memory, which all
@@ -89,7 +88,6 @@ mod as_keyword { }
8988///
9089/// For more detail on `const`, see the [Rust Book] or the [Reference]
9190///
92- /// [`static`]: keyword.static.html
9391/// [pointer]: primitive.pointer.html
9492/// [Rust Book]:
9593/// https://doc.rust-lang.org/stable/book/2018-edition/ch03-01-variables-and-mutability.html#differences-between-variables-and-constants
@@ -114,7 +112,7 @@ mod const_keyword { }
114112/// The `as` keyword can be used to change what the crate is referred to as in your project. If a
115113/// crate name includes a dash, it is implicitly imported with the dashes replaced by underscores.
116114///
117- /// `crate` is also used as in conjunction with [ `pub`] to signify that the item it's attached to
115+ /// `crate` is also used as in conjunction with `pub` to signify that the item it's attached to
118116/// is public only to other members of the same crate it's in.
119117///
120118/// ```rust
@@ -127,7 +125,6 @@ mod const_keyword { }
127125/// ```
128126///
129127/// [Reference]: https://doc.rust-lang.org/reference/items/extern-crates.html
130- /// [`pub`]: keyword.pub.html
131128mod crate_keyword { }
132129
133130#[ doc( keyword = "enum" ) ]
@@ -263,8 +260,6 @@ mod extern_keyword { }
263260/// }
264261/// ```
265262///
266- /// See docs on [`impl`] and [`self`] for relevant details on those.
267- ///
268263/// In addition to presenting fixed types in the form of `fn name(arg: type, ..) -> return_type`,
269264/// functions can also declare a list of type parameters along with trait bounds that they fall
270265/// into.
@@ -281,20 +276,17 @@ mod extern_keyword { }
281276/// }
282277/// ```
283278///
284- /// Declaring trait bounds in the angle brackets is functionally identical to using a [ `where`]
279+ /// Declaring trait bounds in the angle brackets is functionally identical to using a `where`
285280/// clause. It's up to the programmer to decide which works better in each situation, but `where`
286281/// tends to be better when things get longer than one line.
287282///
288- /// Along with being made public via [ `pub`] , `fn` can also have an [`extern`] added for use in
283+ /// Along with being made public via `pub`, `fn` can also have an [`extern`] added for use in
289284/// FFI.
290285///
291286/// For more information on the various types of functions and how they're used, consult the [Rust
292287/// book] or the [Reference].
293288///
294289/// [`impl`]: keyword.impl.html
295- /// [`self`]: keyword.self.html
296- /// [`where`]: keyword.where.html
297- /// [`pub`]: keyword.pub.html
298290/// [`extern`]: keyword.extern.html
299291/// [Rust book]: https://doc.rust-lang.org/book/second-edition/ch03-03-how-functions-work.html
300292/// [Reference]: https://doc.rust-lang.org/reference/items/functions.html
@@ -307,7 +299,7 @@ mod fn_keyword { }
307299/// `for` is primarily used in for-in-loops, but it has a few other pieces of syntactic uses such as
308300/// `impl Trait for Type` (see [`impl`] for more info on that). for-in-loops, or to be more
309301/// precise, iterator loops, are a simple syntactic sugar over an exceedingly common practice
310- /// within Rust, which is to loop over an iterator until that iterator returns None (or [ `break`]
302+ /// within Rust, which is to loop over an iterator until that iterator returns None (or `break`
311303/// is called).
312304///
313305/// ```rust
@@ -365,7 +357,6 @@ mod fn_keyword { }
365357/// For more information on for-loops, see the [Rust book] or the [Reference].
366358///
367359/// [`impl`]: keyword.impl.html
368- /// [`break`]: keyword.break.html
369360/// [`IntoIterator`]: iter/trait.IntoIterator.html
370361/// [Rust book]:
371362/// https://doc.rust-lang.org/book/2018-edition/ch03-05-control-flow.html#looping-through-a-collection-with-for
@@ -402,7 +393,7 @@ mod for_keyword { }
402393/// thing you'd see in many languages, with an optional `else` block. Second uses `if` as an
403394/// expression, which is only possible if all branches return the same type. An `if` expression can
404395/// be used everywhere you'd expect. The third kind of `if` block is an `if let` block, which
405- /// behaves similarly to using a [ `match`] expression:
396+ /// behaves similarly to using a `match` expression:
406397///
407398/// ```rust
408399/// if let Some(x) = Some(123) {
@@ -423,8 +414,6 @@ mod for_keyword { }
423414/// }
424415/// ```
425416///
426- /// See [`let`] for more information on pattern bindings.
427- ///
428417/// Each kind of `if` expression can be mixed and matched as needed.
429418///
430419/// ```rust
@@ -444,8 +433,6 @@ mod for_keyword { }
444433///
445434/// For more information on `if` expressions, see the [Rust book] or the [Reference].
446435///
447- /// [`match`]: keyword.match.html
448- /// [`let`]: keyword.let.html
449436/// [Rust book]:
450437/// https://doc.rust-lang.org/stable/book/2018-edition/ch03-05-control-flow.html#if-expressions
451438/// [Reference]: https://doc.rust-lang.org/reference/expressions/if-expr.html
0 commit comments