Skip to content

Commit 50f631c

Browse files
committed
Removed dead links to unwritten keyword docs
Most of these will eventually be filled, but right now travis-ci enjoys complaining about the fact that there's links that lead nowhere, so they're gone. Hopefully someone remembers to re-add them later.
1 parent 76a353b commit 50f631c

File tree

1 file changed

+7
-20
lines changed

1 file changed

+7
-20
lines changed

src/libstd/keyword_docs.rs

+7-20
Original file line numberDiff line numberDiff line change
@@ -30,15 +30,14 @@
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
4241
mod 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
131128
mod 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

Comments
 (0)