diff --git a/docs/upgrading.rst b/docs/upgrading.rst
index b44fae879..21da5b26d 100644
--- a/docs/upgrading.rst
+++ b/docs/upgrading.rst
@@ -110,7 +110,7 @@ This will now result in a failure.
 Substitutions removed
 ---------------------
 
-- The ``distshare`` substitution has been removed.
+- The ``distshare`` and ``homedir`` substitutions have been removed.
 
 Disallowed env names
 --------------------