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

Henrik Levkowetz <henrik@levkowetz.com> Thu, 07 February 2019 21:06 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 E27B1129A85; Thu, 7 Feb 2019 13:06:02 -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 qo8Vik7wWucM; Thu, 7 Feb 2019 13:06:01 -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 127CE129284; Thu, 7 Feb 2019 13:06:01 -0800 (PST)
Received: from h-202-242.a357.priv.bahnhof.se ([158.174.202.242]:61070 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 1grqrv-0002OU-K2; Thu, 07 Feb 2019 13:06:00 -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>
Cc: rfc-markdown@ietf.org
From: Henrik Levkowetz <henrik@levkowetz.com>
Message-ID: <25423be3-515b-87ea-dce0-7aac1f3db976@levkowetz.com>
Date: Thu, 7 Feb 2019 22:05:51 +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: <e7b09ee3-511f-5db1-6273-0c6a40317752@gmx.de>
Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="irrd2cNKbq7xKkO8k57Ql0sCIgTsdD8D2"
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/F3UwP0Wb8bV7Lzb6I8efFTHQ9Gw>
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:06:03 -0000

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?


	Henrik

> Now doing this properly (without weird heuristics) requires a vocabulary 
> change (see 
> <https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/10>, 
> raised over two years ago).
> 
> If we are in a hurry, and it seems we are, I would suggest to drop 
> <referencegroup> for now instead of doing something that is known to be 
> broken. And yes, I'm saying this after spending several hours over the 
> previous weekend to get <referencegroup> support into rfc2629.xslt.
> 
> Best regards, Julian
> 
> 
> 
> 
> 
> 
>