dkogan
diff --git a/‎README.org
Copy file name to clipboardExpand all lines: README.org
+25-8Lines changed: 25 additions & 8 deletions b/‎README.org
Copy file name to clipboardExpand all lines: README.org
+25-8Lines changed: 25 additions & 8 deletions
@@ -1354,29 +1354,46 @@ _with='image', tuplesize=3). See the documentation for plot() and class
 gnuplotlib for full details.
 
 ** wait()
-Waits until the open interactive plot window is closed
+Waits until the given interactive plot window(s) are closed
 
 SYNOPSIS
 
 #+BEGIN_SRC python
 import numpy as np
 import gnuplotlib as gp
 
-gp.plot(np.arange(5))
-
+### Waiting for the global plot window
+gp.plot(...)
 # interactive plot pops up
-
 gp.wait()
-
 # We get here when the user closes the plot window
+
+
+### Waiting on some arbitrary plots
+plot0 = gp.gnuplotlib(...)
+plot1 = gp.gnuplotlib(...)
+plot0.plot(...)
+plot1.plot(...)
+gp.wait(plot0,plot1)
+# We get here when the user closes the plot windows
 #+END_SRC
 
+
 DESCRIPTION
 
-This applies to the global gnuplotlib object.
+Wait for the interactive plot window(s) to be closed by the user. Without
+any argument this applies to the global gnuplotlib object. Or the specific
+plots to wait for can be given in arguments (in-line or as a single
+iterable):
+
+- wait() waits on the global gnuplot object
+
+- wait(plot0,plot1)
+- wait((plot0,plot1),) both wait on the given gnuplotlib objects
 
-It's not at all trivial to detect if a current plot window exists. If not,
-this function will end up waiting forever, and the user will need to Ctrl-C
+It's not at all trivial to detect if a plot object has an open plot window.
+If it does not, this function will end up waiting forever, and the user will
+need to Ctrl-C
 
 ** add_plot_option()
 Ingests new key/value pairs into an option dict