docs: added warning for call_cmd helper

1 files changed, 6 insertions, 1 deletions

diff --git a/alot/helper.py b/alot/helper.py
index 19976a4c..e2c85f05 100644
--- a/alot/helper.py
+++ b/alot/helper.py
@@ -214,7 +214,12 @@ def pretty_datetime(d):
 
 def call_cmd(cmdlist, stdin=None):
     """
-    get a shell commands output, error message and return value
+    get a shell commands output, error message and return value and immediately
+    return.
+
+    .. warning::
+
+        This returns with the first screen content for interctive commands.
 
     :param cmdlist: shellcommand to call, already splitted into a list accepted
                     by :meth:`subprocess.Popen`