diff --git a/mercurial/debugcommands.py b/mercurial/debugcommands.py
index cbcbf63b6dbf804603e0a3d008a9bda449bfb346_bWVyY3VyaWFsL2RlYnVnY29tbWFuZHMucHk=..89556caf3c663ac98aea80982d1d48ad73fa6b9e_bWVyY3VyaWFsL2RlYnVnY29tbWFuZHMucHk= 100644
--- a/mercurial/debugcommands.py
+++ b/mercurial/debugcommands.py
@@ -617,6 +617,10 @@
 
     Stream bundles are special bundles that are essentially archives of
     revlog files. They are commonly used for cloning very quickly.
+
+    This command creates a "version 1" stream clone, which is deprecated in
+    favor of newer versions of the stream protocol. Bundles using such newer
+     versions can be generated using the `hg bundle` command.
     """
     # TODO we may want to turn this into an abort when this functionality
     # is moved into `hg bundle`.