summaryrefslogtreecommitdiff
path: root/src/click/termui.py
diff options
context:
space:
mode:
authorDavid Lord <davidism@gmail.com>2020-08-14 10:07:20 -0700
committerDavid Lord <davidism@gmail.com>2020-08-14 10:07:20 -0700
commit183a7f83836fae90affc28d6eb2676014b3077e9 (patch)
treea07315a114511404302e7589b9ca026b855726ae /src/click/termui.py
parenta141a2a1e646434c1d88d45003a1edd2e49d8b41 (diff)
downloadclick-183a7f83836fae90affc28d6eb2676014b3077e9.tar.gz
document that launch(wait) only works for blocking programs
Diffstat (limited to 'src/click/termui.py')
-rw-r--r--src/click/termui.py4
1 files changed, 3 insertions, 1 deletions
diff --git a/src/click/termui.py b/src/click/termui.py
index 44e0b80..1eb9ed8 100644
--- a/src/click/termui.py
+++ b/src/click/termui.py
@@ -658,7 +658,9 @@ def launch(url, wait=False, locate=False):
.. versionadded:: 2.0
:param url: URL or filename of the thing to launch.
- :param wait: waits for the program to stop.
+ :param wait: Wait for the program to exit before returning. This
+ only works if the launched program blocks. In particular,
+ ``xdg-open`` on Linux does not block.
:param locate: if this is set to `True` then instead of launching the
application associated with the URL it will attempt to
launch a file manager with the file located. This