From c7cbb5f62f077826bd92af2b2b0f1e4c21ee1d01 Mon Sep 17 00:00:00 2001
From: kevin <kevin@larke.org>
Date: Sat, 6 Jan 2024 08:43:42 -0500
Subject: [PATCH] cwIo.h/cpp, cwPresetSel.h : Added comments.

---
 cwIo.cpp      | 1 +
 cwIo.h        | 4 ++++
 cwPresetSel.h | 4 ++--
 3 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/cwIo.cpp b/cwIo.cpp
index d9cdbf9..1ccfd81 100644
--- a/cwIo.cpp
+++ b/cwIo.cpp
@@ -2366,6 +2366,7 @@ cw::rc_t cw::io::exec( handle_t h, void* execCbArg )
   if( p->wsUiH.isValid() )
   {
     ui::flushCache( ui::ws::uiHandle( p->wsUiH ));
+    // Note this call blocks on the websocket handle: See cwUi.h:ws:exec()
     rc = ui::ws::exec( p->wsUiH );
   }
   
diff --git a/cwIo.h b/cwIo.h
index 1446266..1ad7351 100644
--- a/cwIo.h
+++ b/cwIo.h
@@ -164,7 +164,11 @@ namespace cw
     rc_t start( handle_t h );
     rc_t pause( handle_t h );
     rc_t stop(  handle_t h );
+    
+    // Note that this call blocks on the the UI websocket handle.
+    // See ui:ws:exec().
     rc_t exec(  handle_t h, void* execCbArg=nullptr );
+    
     bool isShuttingDown( handle_t h );
     void report( handle_t h );
     void realTimeReport( handle_t h );
diff --git a/cwPresetSel.h b/cwPresetSel.h
index a7015af..59fefb0 100644
--- a/cwPresetSel.h
+++ b/cwPresetSel.h
@@ -13,8 +13,8 @@ namespace cw
       bool     playFl;      // play this preset
       bool     seqFl;       // play this preset during sequencing.
       unsigned preset_idx;  // preset index into preset_labelA[].
-      unsigned order;       //
-      char*    alt_str;
+      unsigned order;       // selection label
+      char*    alt_str;     // 'alt' label
     } preset_t;
 
     typedef struct frag_str