diff --git a/docs/manifest-format.txt b/docs/manifest-format.txt
index c51b84b..9589352 100644
--- a/docs/manifest-format.txt
+++ b/docs/manifest-format.txt
@@ -250,4 +250,6 @@
 these extra projects.
 
 Additional remotes and projects may also be added through a local
-manifest, stored in `$TOP_DIR/.repo/local_manifest.xml`.
+manifest, stored in `$TOP_DIR/.repo/local_manifest.xml`. This method
+is deprecated in favor of using multiple manifest files as mentioned
+above.