From 5bb19b04afb8e0cafc90dca7efb2cea3c93295b8 Mon Sep 17 00:00:00 2001 From: Philip Withnall Date: Fri, 26 Apr 2019 12:18:02 +0100 Subject: [PATCH] docs: Clarify support for multiple TXT record strings Most TXT records only contain a single string, but some may contain more. Signed-off-by: Philip Withnall Fixes: #1760 --- gio/gioenums.h | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/gio/gioenums.h b/gio/gioenums.h index cd92c7742..d3ada454a 100644 --- a/gio/gioenums.h +++ b/gio/gioenums.h @@ -735,7 +735,13 @@ typedef enum { * the mail exchanger hostname. * * %G_RESOLVER_RECORD_TXT records are returned as variants with the signature - * `(as)`, representing an array of the strings in the text record. + * `(as)`, representing an array of the strings in the text record. Note: Most TXT + * records only contain a single string, but + * [RFC 1035](https://tools.ietf.org/html/rfc1035#section-3.3.14) does allow a + * record to contain multiple strings. The RFC which defines the interpretation + * of a specific TXT record will likely require concatenation of multiple + * strings if they are present, as with + * [RFC 7208](https://tools.ietf.org/html/rfc7208#section-3.3). * * %G_RESOLVER_RECORD_SOA records are returned as variants with the signature * `(ssuuuuu)`, representing a string containing the primary name server, a