LISTEN {containers} {offsets}* {option value}*

Use commas to delimit more than one container or offset.

Arguments:

  {containers}          One or more containers to hear.
  {offsets}*            Zero or more start time offsets.
  {option value}*       Zero or more option and value pairs.

  The exact {option value} pairs depend on the syntax and 
  output stream. For a complete list see OPEN help.

Overview:

The LISTEN command sends output from {containers} in parallel
to an open listener stream.  If {offsets} is a single number
it becomes the start time for all {containers}. If {offsets} 
is more than one number they are applied to each corresponding
object in {containers}. Otherwise, if {offsets} is the token *,
the start time for each {container} is interactively prompted
for.  Start time offsets are evaluated and apply only to the
current listening pass.

There are two common situations when providing start time offsets
is useful. The first is to experiment with shifting material
relative to other concurrent material.  The second situation is
when listening to an algorithm that takes a significant amount
of time to produce an event. Providing a few seconds start
time delay will allow the algorithm enough "head start" to 
perform its computations and also keep up with the demands of
realtime processing.

Examples:

Listen to Foo and Bar with a start offset of 1.5 seconds:

	listen foo,bar 1.5

Listen to Foo and Bar with start time prompting:

	listen foo,bar
  	Start time offset: (<cr>=None) *
  	Foo start time offset: (<cr>=None) 
  	Bar start time offset: (<cr>=None) 5

Listen to Foo and Bar with start offsets 0 and 2, and a
timescale factor of .5:

	listen foo,bar 0,2 timescale .5

See also:

WRITE, SLISTEN, SWRITE, TLIST, RUN, OPEN