From a7fc80cec09935316bb7ad0a838ea967fe4e5658 Mon Sep 17 00:00:00 2001
From: Frank Louwers <24672+franklouwers@users.noreply.github.com>
Date: Tue, 11 Mar 2025 21:22:20 +0100
Subject: [PATCH] Update actions.rst

clarify SpoofAction()
---
 pdns/dnsdistdist/docs/reference/actions.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/pdns/dnsdistdist/docs/reference/actions.rst b/pdns/dnsdistdist/docs/reference/actions.rst
index 5442d647c4..0fa2424d89 100644
--- a/pdns/dnsdistdist/docs/reference/actions.rst
+++ b/pdns/dnsdistdist/docs/reference/actions.rst
@@ -797,6 +797,9 @@ The following actions exist.
   Forge a response with the specified IPv4 (for an A query) or IPv6 (for an AAAA) addresses.
   If you specify multiple addresses, all that match the query type (A, AAAA or ANY) will get spoofed in.
 
+  Note that if you only specify only addresses of one type (e.g. only IPv4 addresses), then queries for the other type (in this case AAAA queries), will **not** be spoofed.
+  This means that for most practical cases, you'd need to specify at least one IPv4 and one IPv6 address.
+
   :param string ip: An IPv4 and/or IPv6 address to spoof
   :param {string} ips: A table of IPv4 and/or IPv6 addresses to spoof
   :param table options: A table with key: value pairs with options.
-- 
2.47.2