diff --git a/docs/rbtools/index.txt b/docs/rbtools/index.txt
index 50eaa3e5d275cdd2dd4f6f8ce4eccf23c1d9ec4b..1a9d1cff15dff413eff4fa4fba180a33e2f65d9a 100644
--- a/docs/rbtools/index.txt
+++ b/docs/rbtools/index.txt
@@ -9,8 +9,8 @@ This consists of the following officially supported tools:
 .. toctree::
    :maxdepth: 1
 
-   post-review
    rbt/index
+   post-review
    api/index
 
 
diff --git a/docs/rbtools/post-review.txt b/docs/rbtools/post-review.txt
index 2b86848037fe7415a31880956aec866f43dbcd62..64b67b309b5f3b71fb2416d5cdbc370ac4fee75f 100644
--- a/docs/rbtools/post-review.txt
+++ b/docs/rbtools/post-review.txt
@@ -15,6 +15,11 @@ review request on an associated Review Board server. This saves a lot of time
 over the web UI, and for some types of code repositories (such as Perforce),
 it's actually required in order to produce a compatible diff.
 
+.. deprecated:: 0.5
+
+   The :command:`post-review` command is deprecated in favor of the new
+   :command:`rbt` suite of tools.
+
 
 Posting and Updating Review Requests
 ====================================
diff --git a/docs/rbtools/rbt/index.txt b/docs/rbtools/rbt/index.txt
index 306527b060b1ef271b9011456edd46901eb3d001..60c8c0b2ca7c9c08380e4b3dc140cda31829fc1e 100644
--- a/docs/rbtools/rbt/index.txt
+++ b/docs/rbtools/rbt/index.txt
@@ -8,8 +8,8 @@ has the following usage::
 
    $ rbt [--version] <command> [options] [<args>]
 
-While :command:`rbt` is currently in beta, it will eventually replace
-:command:`post-review` completely. For built in help you may execute::
+The :command:`rbt` command obsoletes the old :command:`post-review` command.
+For built in help you may execute::
 
    $ rbt help