Re: [xml2rfc-dev] docName?

Henrik Levkowetz <henrik@levkowetz.com> Fri, 10 May 2019 13:03 UTC

Return-Path: <henrik@levkowetz.com>
X-Original-To: xml2rfc-dev@ietfa.amsl.com
Delivered-To: xml2rfc-dev@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 6EE7012011F for <xml2rfc-dev@ietfa.amsl.com>; Fri, 10 May 2019 06:03:47 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.889
X-Spam-Level:
X-Spam-Status: No, score=-1.889 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, T_SUBJ_BRKN_WORDNUMS=0.01, 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 0f7YYOMbspTc for <xml2rfc-dev@ietfa.amsl.com>; Fri, 10 May 2019 06:03:45 -0700 (PDT)
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 CAE44120020 for <xml2rfc-dev@ietf.org>; Fri, 10 May 2019 06:03:45 -0700 (PDT)
Received: from h-202-242.a357.priv.bahnhof.se ([158.174.202.242]:52851 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 1hP5Bg-0007Ak-9q; Fri, 10 May 2019 06:03:44 -0700
To: Miek Gieben <miek@miek.nl>
References: <20190408214850.fbwdzhza7g4omyvs@miek.nl> <c49cafe0-37d7-8f32-7056-d37df808d96f@gmx.de> <20190509060348.77yjfr3uuff7e67j@miek.nl> <9f6f2abd-5cda-2611-b1e6-4e912a17f5bb@levkowetz.com> <20190510065425.iy74lntsbeeakjeg@miek.nl> <a96215de-8228-e9b4-2ee7-f64c73eaace8@gmx.de> <98223d05-21ec-e914-046d-30c9dcb0a695@levkowetz.com> <20190510120244.dl2sg3qopbb4qd4b@miek.nl>
Cc: Julian Reschke <julian.reschke@gmx.de>, XML Developer List <xml2rfc-dev@ietf.org>
From: Henrik Levkowetz <henrik@levkowetz.com>
Message-ID: <1b53c89f-6e5b-d009-5d6c-b672bdd02267@levkowetz.com>
Date: Fri, 10 May 2019 15:03:36 +0200
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: <20190510120244.dl2sg3qopbb4qd4b@miek.nl>
Content-Type: multipart/signed; micalg="pgp-sha256"; protocol="application/pgp-signature"; boundary="gFD2X1lPNAGhnb4TJIDnFxENaE7jbiixC"
X-SA-Exim-Connect-IP: 158.174.202.242
X-SA-Exim-Rcpt-To: xml2rfc-dev@ietf.org, julian.reschke@gmx.de, miek@miek.nl
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/xml2rfc-dev/8ENMPSwDbjl1VWDMY6PhFAbj3WQ>
Subject: Re: [xml2rfc-dev] docName?
X-BeenThere: xml2rfc-dev@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "Discussion about particulars of xml2rfc V3 design, development and code." <xml2rfc-dev.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/xml2rfc-dev>, <mailto:xml2rfc-dev-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/xml2rfc-dev/>
List-Post: <mailto:xml2rfc-dev@ietf.org>
List-Help: <mailto:xml2rfc-dev-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/xml2rfc-dev>, <mailto:xml2rfc-dev-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 10 May 2019 13:03:47 -0000

Hi Miek,

On 2019-05-10 14:02, Miek Gieben wrote:
> [ Quoting <henrik@levkowetz.com> in "Re: [xml2rfc-dev] docName?..." ]
>>No, the docName should not change to a number; the docName is used to add
>>metadata about the draft from which an RFC is derived when writing a v3
>>RFC in html format, and to insert the draft name when writing draft output.
>>
>>>> Also because there is a number attribute
>>>> (https://tools.ietf.org/html/rfc7991#section-2.45.7), which I added eons
>>>> ago because xml2rfc complained; maybe that can be removed now (because
>>>> its deprecated) ?
>>
>>No, as Julian indicates, follow 7749 with respect to metadata.  The number
>>still indicates which RFC number is to be generated.
>>
>>	Henrik
> 
> Ok, thanks for the info; I'll make those changes.
> 
> One more question if you have docName will xml2rfc; will this work as well:
> 
> Warning: Expected a <link> with rel='prev' providing the datatracker url for the origin draft.

The v2v3 converter inserts a <link> with rel='prev' if docName is given;
for v3 xml you should set that.  I think, however, that this warning should
more correctly be a note or comment.


Best regards,

	Henrik