diff --git a/src/doc/reference.md b/src/doc/reference.md
index 8a6f15a1ba4..44266fb4050 100644
--- a/src/doc/reference.md
+++ b/src/doc/reference.md
@@ -149,10 +149,11 @@ sequence (`/**`), are interpreted as a special syntax for `doc`
 `#[doc="..."]` around the body of the comment (this includes the comment
 characters themselves, ie `/// Foo` turns into `#[doc="/// Foo"]`).
 
-Line comments beginning with `//!` are doc comments that apply to the parent
-of the comment, rather than the item that follows.  That is, they are
-equivalent to writing `#![doc="..."]` around the body of the comment. `//!`
-comments are usually used to display information on the crate index page.
+Line comments beginning with `//!` and block comments beginning with `/*!` are
+doc comments that apply to the parent of the comment, rather than the item
+that follows.  That is, they are equivalent to writing `#![doc="..."]` around
+the body of the comment. `//!` comments are usually used to display
+information on the crate index page.
 
 Non-doc comments are interpreted as a form of whitespace.