From dffc8b0018705cf868115a2aa02e39f6e9e1f831 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pedro=20L=C3=B3pez-Cabanillas?=
 <pedrolcl@users.noreply.github.com>
Date: Wed, 2 Sep 2026 14:09:24 +0200
Subject: [PATCH] fix documentation of EAS_SetVolume and EAS_GetVolume

---
 arm-wt-22k/host_src/eas.h       |  8 +++++---
 arm-wt-22k/lib_src/eas_public.c | 10 +++++-----
 2 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/arm-wt-22k/host_src/eas.h b/arm-wt-22k/host_src/eas.h
index f8af602..012de66 100644
--- a/arm-wt-22k/host_src/eas.h
+++ b/arm-wt-22k/host_src/eas.h
@@ -383,11 +383,12 @@ EAS_PUBLIC EAS_RESULT EAS_GetPriority (EAS_DATA_HANDLE pEASData, EAS_HANDLE stre
  *----------------------------------------------------------------------------
  * Purpose:
  * Set the master volume for the mixer. The default volume setting is
- * 90 (-10 dB). The volume range is 0 to 100 in 1dB increments.
+ * 100 (+0 dB). The volume range is 0 to EAS_MAX_VOLUME=196 in 1dB increments.
  *
  * Inputs:
  * pEASData         - pointer to overall EAS data structure
- * volume           - the desired master volume
+ * streamHandle     - file or stream handle (may be NULL)
+ * volume           - the desired master volume (EAS_MAX_VOLUME = 196 is max)
  *
  * Outputs:
  *
@@ -407,9 +408,10 @@ EAS_PUBLIC EAS_RESULT EAS_SetVolume (EAS_DATA_HANDLE pEASData, EAS_HANDLE stream
  *
  * Inputs:
  * pEASData         - pointer to overall EAS data structure
- * volume           - the desired master volume
+ * streamHandle     - file or stream handle
  *
  * Outputs:
+ * volume           - the current master volume
  *
  *
  * Side Effects:
diff --git a/arm-wt-22k/lib_src/eas_public.c b/arm-wt-22k/lib_src/eas_public.c
index 216a8c7..5f52526 100644
--- a/arm-wt-22k/lib_src/eas_public.c
+++ b/arm-wt-22k/lib_src/eas_public.c
@@ -1908,8 +1908,8 @@ EAS_PUBLIC EAS_RESULT EAS_GetPriority (EAS_DATA_HANDLE pEASData, EAS_HANDLE pStr
  *
  * Inputs:
  * pEASData         - pointer to overall EAS data structure
- * volume           - the desired master gain (100 is max)
- * handle           - file or stream handle
+ * pStream          - file or stream handle (may be NULL)
+ * volume           - the desired master gain (EAS_MAX_VOLUME = 196 is max)
  *
  * Outputs:
  *
@@ -1963,14 +1963,14 @@ EAS_PUBLIC EAS_RESULT EAS_SetVolume (EAS_DATA_HANDLE pEASData, EAS_HANDLE pStrea
  *----------------------------------------------------------------------------
  * Purpose:
  * Returns the master volume for the synthesizer. The default volume setting is
- * 50. The volume range is 0 to 100;
+ * 100 (+0 dB). The volume range is 0 to 196;
  *
  * Inputs:
  * pEASData         - pointer to overall EAS data structure
- * volume           - the desired master volume
- * handle           - file or stream handle
+ * pStream          - file or stream handle
  *
  * Outputs:
+ * volume           - the current master volume
  *
  *
  * Side Effects: