diff --git a/scripts/set_xtensa_params.sh b/scripts/set_xtensa_params.sh
index cbc2db5889d0..8a0e2aeb808e 100644
--- a/scripts/set_xtensa_params.sh
+++ b/scripts/set_xtensa_params.sh
@@ -11,6 +11,9 @@
 #
 # Not all variables are used in all use cases. Some are.
 #
+# Find some information about XTENSA_SYSTEM and XTENSA_CORE in
+# ./scripts/xtensa-build-zephyr.py --help
+#
 # The variables used by Zephyr are duplicated in
 # xtensa-build-zephyr.py, please keep in sync!
 
diff --git a/scripts/xtensa-build-zephyr.py b/scripts/xtensa-build-zephyr.py
index ecdf3b62807d..8a1c8fafcb5f 100755
--- a/scripts/xtensa-build-zephyr.py
+++ b/scripts/xtensa-build-zephyr.py
@@ -169,19 +169,27 @@ def parse_args():
 	parser = argparse.ArgumentParser(formatter_class=argparse.RawTextHelpFormatter,
 			epilog=(
 
-f"""This script supports XtensaTools but only when installed in a specific
-directory structure, example:
+f"""This script supports XtensaTools but only when installed in a specific directory
+structure where a single --xtensa-core is registered per --xtensa-system registry, example
+below. Different layouts may or may not work.
+
 myXtensa/
 └── install/
        ├── builds/
-       │   ├── RD-2012.5{xtensa_tools_version_postfix}
-       │   │   └── Intel_HiFiEP/
-       │   └── RG-2017.8{xtensa_tools_version_postfix}
-       │       ├── LX4_langwell_audio_17_8/
-       │       └── X4H3I16w2D48w3a_2017_8/
+       │   ├── RD-2012.5{xtensa_tools_version_postfix}
+       │   │   └── Intel_HiFiEP/config/        # XTENSA_SYSTEM registry
+       │   │        ├── default-params
+       │   │        └── Intel_HiFiEP-params    # single, default XTENSA_CORE per registry
+       │   └── RG-2017.8{xtensa_tools_version_postfix}
+       │       ├── LX4_langwell_audio_17_8/config/
+       │       │    ├── default-params
+       │       │    └── LX4_langwell_audio_17_8-params
+       │       └── X4H3I16w2D48w3a_2017_8/config/
+       │           ├── default-params
+       │           └── X4H3I16w2D48w3a_2017_8-params
        └── tools/
                ├── RD-2012.5{xtensa_tools_version_postfix}
-               │   └── XtensaTools
+               │   └── XtensaTools
                └── RG-2017.8{xtensa_tools_version_postfix}
                    └── XtensaTools/