From 85bbbad5926ab93c4c41c47eb11faffb4c8aeb5f Mon Sep 17 00:00:00 2001
From: Steve Klabnik <steve@steveklabnik.com>
Date: Sun, 19 Jun 2016 16:27:37 -0400
Subject: [PATCH] A disclaimer about keywords.

Some people cite this list as "zomg Rust has so many keywords," so make
it clear that these aren't all used by the language today.
---
 src/doc/grammar.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/doc/grammar.md b/src/doc/grammar.md
index fac488d9c4aa3..be64379b516e7 100644
--- a/src/doc/grammar.md
+++ b/src/doc/grammar.md
@@ -172,6 +172,11 @@ token : simple_token | ident | literal | symbol | whitespace token ;
 Each of these keywords has special meaning in its grammar, and all of them are
 excluded from the `ident` rule.
 
+Not all of these keywords are used by the language. Some of them were used
+before Rust 1.0, and were left reserved once their implementations were
+removed. Some of them were reserved before 1.0 to make space for possible
+future features.
+
 ### Literals
 
 ```antlr