Subject: [xml2rfc-dev] <referencegroup> feedback

From: Julian Reschke <[email-masked]>
Date: Sun, 3 Feb 2019 11:26:42 +0100

<https://tools.ietf.org/html/draft-levkowetz-xml2rfc-v3-implementation-notes-07#section-4.2.20>:

>    This element is a sibling to <reference>, and <reference> is
>    described as being rendered as a <dl> with one set of <dt>, <dd>
>    child elements.

That is only true if you believe in the example instead of the prose, 
which says:

> If the parent of this element is not a <referencegroup>, this element will render as a <dt> <dd> pair with the defined term being the reference "anchor" attribute surrounded by square brackets and the definition including the correct set of bibliographic information as specified by [RFC7322].

The fact that these pairs should be contained in a single <dl> list is 
left to the reader - but may I say self-evident? After all, it is *one* 
list of references.

What *I* do not understand is why we have these special cases at all? 
Why aren't the individual referencegroup members not rendered as 
multiple <dd> element?

Another case of RFC 7992 over-specifying things causing confusion :-)

Best regards, Julian