--- /usr/include/ladspa.h	Wed Aug  8 20:21:03 2001
+++ ladspa.h	Wed May 29 14:08:46 2002
@@ -352,14 +352,20 @@
      to be an array of LADSPA_Data for audio ports or a single
      LADSPA_Data value for control ports. Memory issues will be
      managed by the host. The plugin must read/write the data at these
-     locations every time run() or run_adding() is called and the data
-     present at the time of this connection call should not be
-     considered meaningful.
+     locations every time run() or run_adding() is called.
+
+     The data present at the time of calling connect_port() should not
+     be considered meaningful. However a plugin may suggest a "default"
+     control value by setting this data before returning from
+     connect_port(). Thus a host that requires useful default values
+     for control inputs can get these by examining the data contents
+     immediately after a call to connect_port().
 
      connect_port() may be called more than once for a plugin instance
      to allow the host to change the buffers that the plugin is
-     reading or writing. These calls may be made before or after
-     activate() or deactivate() calls.
+     reading or writing, or to request updated "default" control values.
+     These calls may be made before or after activate() or deactivate()
+     calls.
 
      connect_port() must be called at least once for each port before
      run() or run_adding() is called. When working with blocks of