V8.00.000.2025.06.17

Signed-off-by: Marc S. Weidner <msw@coresecret.dev>

func/cdi_1000_helper/1080_helper_chroot.sh

@@ -14,9 +14,13 @@ guard_sourcing
 
 #######################################
 # Use chroot_exec() for:
-#   - simple commands (e.g., dpkg, ln, mkdir, apt, etc.).
+#   - Simple commands (e.g., dpkg, ln, mkdir, apt, etc.).
 # Use chroot_script() for:
-#   - all shell scripts, redirects, pipes, conditions, loops, or subshells.
+#   - All shell scripts, redirects, pipes, conditions, loops, or subshells.
+# Use chroot_stdin() for:
+#   - Long, multi-line payloads without argv/ARG_MAX pain. Use it to stream robust, quoting-safe scripts via stdin (bash -s).
+#     Ideal for multi-line awk/sed edits, or any content that would otherwise suffer from nested quoting or size limits if
+#     passed via -c.
 #######################################
 
 #######################################
@@ -76,7 +80,7 @@ chroot_exec() {
 }
 
 #######################################
-# Execute a full shell script line inside the chroot via bash -c.
+# Run a complete shell script line inside the chroot using the command 'bash -c'.
 # Globals:
 #   BASH_SOURCE
 #   TERM
@@ -150,7 +154,7 @@ chroot_script() {
 }
 
 #######################################
-# Execute the desired code of the installer via stdin inside the chroot with bash -s.
+# Run the installer-desired code via stdin inside the chroot with bash -s.
 # Globals:
 #   BASH_SOURCE
 #   TERM