Make it clear that the reference isn't normative

[rust.git] / src / doc / reference.md

diff --git a/src/doc/reference.md b/src/doc/reference.md
index a461023642afd6130df80eaf0b95de7c0cd32021..1c9530f1323632ce2d6391c99ad9fab4bb1f52b7 100644 (file)
--- a/src/doc/reference.md
+++ b/src/doc/reference.md
@@ -21,6 +21,11 @@ separately by extracting documentation attributes from their source code. Many
 of the features that one might expect to be language features are library
 features in Rust, so what you're looking for may be there, not here.
 
+Finally, this document is not normative. It may include details that are
+specific to `rustc` itself, and should not be taken as a specification for
+the Rust language. We intend to produce such a document someday, but this
+is what we have for now.
+
 You may also be interested in the [grammar].
 
 [book]: book/index.html