wireproto: document quirk of _callstream between http and ssh
authorAugie Fackler <augie@google.com>
Wed, 02 Mar 2016 14:18:43 -0500
changeset 28435 176736afa886
parent 28434 d549cbb5503d
child 28436 8d38eab2777a
wireproto: document quirk of _callstream between http and ssh This tripped me up when trying to use it, so it feels like we should document this to avoid future pain.
mercurial/wireproto.py
--- a/mercurial/wireproto.py	Tue Mar 01 16:37:56 2016 -0500
+++ b/mercurial/wireproto.py	Wed Mar 02 14:18:43 2016 -0500
@@ -396,9 +396,12 @@
     def _callstream(self, cmd, **args):
         """execute <cmd> on the server
 
-        The command is expected to return a stream.
+        The command is expected to return a stream. Note that if the
+        command doesn't return a stream, _callstream behaves
+        differently for ssh and http peers.
 
-        returns the server reply as a file like object."""
+        returns the server reply as a file like object.
+        """
         raise NotImplementedError()
 
     def _callcompressable(self, cmd, **args):