From d89c85d3747ae88c1d43aefd2a150eb1784a7913 Mon Sep 17 00:00:00 2001
From: Wim Taymans <wtaymans@redhat.com>
Date: Fri, 31 Oct 2025 11:51:32 +0100
Subject: [PATCH] doc: improve spa_pod_get_values() docs

---
 doc/dox/api/spa-pod.dox | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/doc/dox/api/spa-pod.dox b/doc/dox/api/spa-pod.dox
index 67ee20750..7d4e244cf 100644
--- a/doc/dox/api/spa-pod.dox
+++ b/doc/dox/api/spa-pod.dox
@@ -435,10 +435,11 @@ spa_pod_parser_get_object(&p,
 \endcode
 
 `spa_pod_get_values()` is a useful function. It returns a
-`struct spa_pod*` with and array of values. For normal POD's
-and choice none values, it simply returns the POD and one value.
-For other choice values it returns the choice type and an array
-of values:
+`struct spa_pod*` with and array of values. For invalid PODs
+it returns the POD and no values. For normal PODs it returns
+the POD and one value. For choice values it returns the choice
+type and an array of values. If the choice doesn't fit even a
+single value, the array will have no values.
 
 \code{.c}
 struct spa_pod *value;