Re: [Rfc-markdown] <referencegroup>, was: [xml2rfc-dev] New xml2rfc release: v2.18.0

Henrik Levkowetz <henrik@levkowetz.com> Thu, 07 February 2019 21:35 UTC

Return-Path: <henrik@levkowetz.com>
X-Original-To: rfc-markdown@ietfa.amsl.com
Delivered-To: rfc-markdown@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 38122129C6A; Thu, 7 Feb 2019 13:35:26 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.899
X-Spam-Level:
X-Spam-Status: No, score=-1.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id uqKs5tbIvsMt; Thu, 7 Feb 2019 13:35:23 -0800 (PST)
Received: from zinfandel.tools.ietf.org (zinfandel.tools.ietf.org [IPv6:2001:1890:126c::1:2a]) (using TLSv1.2 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id AD7E4129A87; Thu, 7 Feb 2019 13:35:23 -0800 (PST)
Received: from h-202-242.a357.priv.bahnhof.se ([158.174.202.242]:61313 helo=tannat.localdomain) by zinfandel.tools.ietf.org with esmtpsa (TLS1.2:DHE_RSA_AES_128_CBC_SHA1:128) (Exim 4.80) (envelope-from <henrik@levkowetz.com>) id 1grrKM-00068y-1j; Thu, 07 Feb 2019 13:35:22 -0800
To: Julian Reschke <julian.reschke@gmx.de>, xml2rfc-dev@ietf.org, xml2rfc@ietf.org
References: <E1grUuZ-0001Xw-Ix@durif.tools.ietf.org> <e7b09ee3-511f-5db1-6273-0c6a40317752@gmx.de> <25423be3-515b-87ea-dce0-7aac1f3db976@levkowetz.com> <26ead582-fcbe-7748-86b4-f1d6e3f401f6@gmx.de>
Cc: rfc-markdown@ietf.org
From: Henrik Levkowetz <henrik@levkowetz.com>
Message-ID: <c92e498c-6a20-ca03-c20f-dab62a11ec1d@levkowetz.com>
Date: Thu, 7 Feb 2019 22:35:14 +0100
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.11; rv:45.0) Gecko/20100101 Thunderbird/45.8.0
MIME-Version: 1.0
In-Reply-To: <26ead582-fcbe-7748-86b4-f1d6e3f401f6@gmx.de>
Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="uUm53r2MivEgPQaD3kbbSswQ3n4FMeLS4"
X-SA-Exim-Connect-IP: 158.174.202.242
X-SA-Exim-Rcpt-To: rfc-markdown@ietf.org, xml2rfc@ietf.org, xml2rfc-dev@ietf.org, julian.reschke@gmx.de
X-SA-Exim-Mail-From: henrik@levkowetz.com
X-SA-Exim-Version: 4.2.1 (built Mon, 26 Dec 2011 16:24:06 +0000)
X-SA-Exim-Scanned: Yes (on zinfandel.tools.ietf.org)
X-Clacks-Overhead: GNU Terry Pratchett
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/RVp-Jp1uoHuSDlpDLrYcYnU8p-g>
Subject: Re: [Rfc-markdown] <referencegroup>, was: [xml2rfc-dev] New xml2rfc release: v2.18.0
X-BeenThere: rfc-markdown@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "rfc-markdown is a discussion list for people writing I-Ds and RFCs in Markdown and the authors of the tools used for that." <rfc-markdown.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rfc-markdown/>
List-Post: <mailto:rfc-markdown@ietf.org>
List-Help: <mailto:rfc-markdown-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 07 Feb 2019 21:35:26 -0000


On 2019-02-07 22:11, Julian Reschke wrote:
> On 07.02.2019 22:05, Henrik Levkowetz wrote:
>> 
>> On 2019-02-07 21:56, Julian Reschke wrote:
>>> On 06.02.2019 22:39, Henrik Levkowetz wrote:
>>>> ...
>>>>     * Adjusted the text rendering of reference annotations to match the html
>>>>       rendering better.  Added support for <referencegroup> target rendering.
>>>>       Suppressed rendering of target URLs for individual entries in a
>>>>       referencegroup.
>>>> ...
>>>
>>> With that, I'm getting output such as:
>>>
>>>>     [STD69]    Hollenbeck, S., "Extensible Provisioning Protocol (EPP)",
>>>>                STD 69, RFC 5730, DOI 10.17487/RFC5730, August 2009.
>>>>
>>>>                Hollenbeck, S., "Extensible Provisioning Protocol (EPP)
>>>>                Domain Name Mapping", STD 69, RFC 5731,
>>>>                DOI 10.17487/RFC5731, August 2009.
>>>>
>>>>                Hollenbeck, S., "Extensible Provisioning Protocol (EPP)
>>>>                Host Mapping", STD 69, RFC 5732, DOI 10.17487/RFC5732,
>>>>                August 2009.
>>>>
>>>>                Hollenbeck, S., "Extensible Provisioning Protocol (EPP)
>>>>                Contact Mapping", STD 69, RFC 5733, DOI 10.17487/RFC5733,
>>>>                August 2009.
>>>>
>>>>                Hollenbeck, S., "Extensible Provisioning Protocol (EPP)
>>>>                Transport over TCP", STD 69, RFC 5734,
>>>>                DOI 10.17487/RFC5734, August 2009.
>>>
>>> So the links to the RFCs are gone.
>>>
>>> This matches slightly more what RFC 7322 says in
>>> <https://tools.ietf.org/html/rfc7322#section-4.8.6.3>:
>>>
>>>>        [STDXXX]  Last name, First initial., Ed. (if applicable),
>>>>                  "RFC Title", Sub-series number, RFC number, Date of
>>>>                  publication.
>>>>
>>>>                  Last name, First initial., Ed. (if applicable)
>>>>                  and First initial. Last name, Ed. (if applicable),
>>>>                  "RFC Title", Sub-series number, RFC number, Date of
>>>>                  publication.
>>>>
>>>>                  <http://www.rfc-editor.org/info/std#>
>>>
>>> ...but it still misses the link to the "aggregate" page.
>> 
>> Did you provide a target attribute in <referencegroup> in order to give it
>> an aggregate link to render?
>> ...
> 
> In fact I did not. Thanks for the explanation.
> 
> FWIW, xml2rfc (--v3 --text) renders that as "URL: <...>" - why the 
> "URL:" prefix?

A tentative implementation.  I tried it both with and without, and in the
<referencegroup> case it seemed to read better with.  I'm happy to adjust
based on feedback and consensus.


	Henrik