cargo doc breaks for 2018-06-18 nightly

[ErichDonGubler]

The crux of the issue seems to be lib.rs:9, where [notified] doesn't actually refer to anything in source.

I've included a sample invocation below, but if you need any further information please let me know! Builds for uploads-im-client-rs are breaking because I decided to include a cargo doc --verbose command. I would love to keep my CI more rigorous, but I can't with this issue!

Log output

~/…/tokio/tokio-executor master$ cargo +nightly-2018-06-18 doc
 Documenting futures v0.1.21
    Checking futures v0.1.21
warning: `[Debug]` cannot be resolved, ignoring it...
   |
   = note: #[warn(intra_doc_link_resolution_failure)] on by default
   = note: the link appears in this line:

            themselves through the [`Display`] and [`Debug`] traits, and may provide
                                                    ^^^^^^^
   = help: to escape `[` and `]` characters, just add '\' before them like `\[` or `\]`

 Documenting tokio-executor v0.1.2 (file:///C:/Users/egubler/workspace/personal/bug-reports/tokio/tokio-executor)
error: `[notified]` cannot be resolved, ignoring it...
 --> tokio-executor\src\lib.rs:9:27
  |
9 | //! whenever the task is [notified]. Notification happens when the internal
  |                           ^^^^^^^^ cannot be resolved, ignoring
  |
note: lint level defined here
 --> tokio-executor\src\lib.rs:33:54
  |
33| #![deny(missing_docs, missing_debug_implementations, warnings)]
  |                                                      ^^^^^^^^
  = note: #[deny(intra_doc_link_resolution_failure)] implied by #[deny(warnings)]
  = help: to escape `[` and `]` characters, just add '\' before them like `\[` or `\]`

error: Could not document `tokio-executor`.

Caused by:
  process didn't exit successfully: `rustdoc --crate-name tokio_executor tokio-executor\src\lib.rs -o C:\Users\egubler\workspace\personal\bug-reports\tokio\target\doc -L dependency=C:\Users\egubler\workspace\personal\bug-reports\tokio\target\debug\deps --extern futures=C:\Users\egubler\workspace\personal\bug-reports\tokio\target\debug\deps\libfutures-2ecc8546a5859d7a.rmeta` (exit code: 101)

[carllerche]

My understanding is that cargo doc on nightly is under a lot of flux / bugs.

That said, there probably are also issues w/ the docs. I will happily accept PRs to fix broken links.

[kpp]

Depends on deprecrated/net2-rs#76 | Done

[kpp]

Depends on crossbeam-rs/crossbeam-utils#21 | Released v0.4.1

[kpp]

Depends on #450 | Done

[kpp]

Depends on tokio-rs/bytes#218 | Done

[kpp]

Depends on #458 | Done

[kpp]

Depends on #471 | Done

[kpp]

Depends on rust-random/rand#584 | Released v0.5.5

[kpp]

Depends on tokio-rs/mio#861 | Released v0.6.16

[kpp]

Depends on #518 | Done

[kpp]

Depends on #556 | Done

[kpp]

Depends on #557 | Fixed

[kpp]

Depends on #792 | Done