diff --git a/README.md b/README.md
index 6d3e072663..6da7b59653 100644
--- a/README.md
+++ b/README.md
@@ -1971,7 +1971,8 @@ when resolving imports, `my_package.foo` is considered a first-party import.
 
 This field supports globs. For example, if you have a series of Python packages in
 a `python_modules` directory, `src = ["python_modules/*"]` would expand to incorporate
-all of the packages in that directory.
+all of the packages in that directory. User home directory and environment variables
+will also be expanded.
 
 **Default value**: `["."]`
 
diff --git a/src/settings/options.rs b/src/settings/options.rs
index 3ed7416355..e29f609c3d 100644
--- a/src/settings/options.rs
+++ b/src/settings/options.rs
@@ -286,7 +286,8 @@ pub struct Options {
 
             This field supports globs. For example, if you have a series of Python packages in
             a `python_modules` directory, `src = ["python_modules/*"]` would expand to incorporate
-            all of the packages in that directory.
+            all of the packages in that directory. User home directory and environment variables
+            will also be expanded.
             "#,
         default = r#"["."]"#,
         value_type = "Vec<PathBuf>",