some comment changes

pio/uart_rx/uart_rx.c

@@ -52,7 +52,8 @@ int main() {
     uint offset;
 
     // This will find a free pio and state machine for our program and load it for us
-    // We use pio_claim_free_sm_and_add_program_for_gpio_range so we can address gpios >= 32 if needed and supported by the hardware
+    // We use pio_claim_free_sm_and_add_program_for_gpio_range (for_gpio_range) variant
+    // so we will get a PIO instance suitable for addressing gpios >= 32 if needed and supported by the hardware
     bool success = pio_claim_free_sm_and_add_program_for_gpio_range(&uart_rx_program, &pio, &sm, &offset, PIO_RX_PIN, 1, true);
     hard_assert(success);
 

pio/uart_rx/uart_rx_intr.c

@@ -108,7 +108,8 @@ int main() {
     async_context_add_when_pending_worker(&async_context.core, &worker);
 
     // This will find a free pio and state machine for our program and load it for us
-    // We use pio_claim_free_sm_and_add_program_for_gpio_range so we can address gpios >= 32 if needed and supported by the hardware
+    // We use pio_claim_free_sm_and_add_program_for_gpio_range (for_gpio_range) variant
+    // so we will get a PIO instance suitable for addressing gpios >= 32 if needed and supported by the hardware
     bool success = pio_claim_free_sm_and_add_program_for_gpio_range(&uart_rx_program, &pio, &sm, &offset, PIO_RX_PIN, 1, true);
     hard_assert(success);
 

pio/uart_tx/uart_tx.c

@@ -26,7 +26,8 @@ int main() {
     uint offset;
 
     // This will find a free pio and state machine for our program and load it for us
-    // We use pio_claim_free_sm_and_add_program_for_gpio_range so we can address gpios >= 32 if needed and supported by the hardware
+    // We use pio_claim_free_sm_and_add_program_for_gpio_range (for_gpio_range) variant
+    // so we will get a PIO instance suitable for addressing gpios >= 32 if needed and supported by the hardware
     bool success = pio_claim_free_sm_and_add_program_for_gpio_range(&uart_tx_program, &pio, &sm, &offset, PIO_TX_PIN, 1, true);
     hard_assert(success);
 

pio/ws2812/ws2812.c

@@ -118,7 +118,8 @@ int main() {
     uint offset;
 
     // This will find a free pio and state machine for our program and load it for us
-    // We use pio_claim_free_sm_and_add_program_for_gpio_range so we can address gpios >= 32 if needed and supported by the hardware
+    // We use pio_claim_free_sm_and_add_program_for_gpio_range (for_gpio_range) variant
+    // so we will get a PIO instance suitable for addressing gpios >= 32 if needed and supported by the hardware
     bool success = pio_claim_free_sm_and_add_program_for_gpio_range(&ws2812_program, &pio, &sm, &offset, WS2812_PIN, 1, true);
     hard_assert(success);
 

pio/ws2812/ws2812_parallel.c

@@ -290,7 +290,8 @@ int main() {
     uint offset;
 
     // This will find a free pio and state machine for our program and load it for us
-    // We use pio_claim_free_sm_and_add_program_for_gpio_range so we can address gpios >= 32 if needed and supported by the hardware
+    // We use pio_claim_free_sm_and_add_program_for_gpio_range (for_gpio_range) variant
+    // so we will get a PIO instance suitable for addressing gpios >= 32 if needed and supported by the hardware
     bool success = pio_claim_free_sm_and_add_program_for_gpio_range(&ws2812_parallel_program, &pio, &sm, &offset, WS2812_PIN_BASE, count_of(strips), true);
     hard_assert(success);