diff --git a/website/sphinx/database.rst b/website/sphinx/database.rst
index f6debdc9..ebdb2df3 100644
--- a/website/sphinx/database.rst
+++ b/website/sphinx/database.rst
@@ -1,5 +1,10 @@
 ``tornado.database`` --- Simple MySQL client wrapper
 ====================================================
 
+.. warning::
+   The ``tornado.database`` module is deprecated and will be removed
+   in Tornado 3.0.  It is now available separately as the
+   `torndb <https://github.com/bdarnell/torndb>`_ module.
+
 .. automodule:: tornado.database
    :members: