Re: [Tools-implementation] Draft of message noting that we will allow xml2rfc to produce text formatted as an RFC but paginated with page numbers.

Alexey Melnikov <aamelnikov@fastmail.fm> Wed, 09 December 2020 18:04 UTC

Return-Path: <aamelnikov@fastmail.fm>
X-Original-To: tools-implementation@ietfa.amsl.com
Delivered-To: tools-implementation@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id F3C2B3A16DF for <tools-implementation@ietfa.amsl.com>; Wed, 9 Dec 2020 10:04:55 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.119
X-Spam-Level:
X-Spam-Status: No, score=-2.119 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=fastmail.fm header.b=Fvdg94TS; dkim=pass (2048-bit key) header.d=messagingengine.com header.b=Wef/S4i/
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 xzowvGWH18Dg for <tools-implementation@ietfa.amsl.com>; Wed, 9 Dec 2020 10:04:54 -0800 (PST)
Received: from wout2-smtp.messagingengine.com (wout2-smtp.messagingengine.com [64.147.123.25]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 759AD3A16DD for <tools-implementation@ietf.org>; Wed, 9 Dec 2020 10:04:54 -0800 (PST)
Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.west.internal (Postfix) with ESMTP id 550839E2; Wed, 9 Dec 2020 13:04:53 -0500 (EST)
Received: from imap21 ([10.202.2.71]) by compute1.internal (MEProxy); Wed, 09 Dec 2020 13:04:53 -0500
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.fm; h= mime-version:message-id:in-reply-to:references:date:from:to :subject:content-type; s=fm1; bh=t7vGXF4KjCqnF/jIgPZemmpBSELjB6l BdLYCZNTn0fw=; b=Fvdg94TS+WH7vjx/hyfBgMthEhb8JhxEYfKckR1s8Mxoloc H1+L8+VVfQBBsW0xBtWXwbjOxE5s6/+4NnnmBQ0FUp7+CJdLwuZq1nM9bVb/nowW LwDxI2Nxs4aZERxODh6pU96Lp8BdAc8eIZfchzca5oiTJlp1QwEXSvb4R/qHRmLx lJVUBoOca+OtDgzwSetTRZlMrPbZzyDmMq9YpErigwej2QMz1fr3mI60y1nY9odW g4fr/6Nmbugep6eYrlG45ZWgs3AZfF9HKDzUrw3Jx451P5Wdq8EQvaeDtjmjAK1y CN8G21QOHErw5hlwiaxU1yVnFKLX3K1aBXA4WZA==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-me-proxy :x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm1; bh=t7vGXF 4KjCqnF/jIgPZemmpBSELjB6lBdLYCZNTn0fw=; b=Wef/S4i/oMefbYOVCV6DNo L3S4f2APmY6lczKgXmjOC5Kcp4wdeBp++BdZUz7n24u2SuJ3UlB0Lwuyf/3qYwQv vn1ouLPGODD/5uMGQFC0qQrSfOyRN7wgdgbCpRB2VywgTWvmDysY4Y3G/RHfzLNp 7KvlnKQ7bw44lheBbFlr13Do3PW4zT0phoppU35Mqsle6hAOt97sseG+MA67ASLi PKTbSW0QDNNjLqXvUJziHDtfLfWKNDVs/qMW6wv/+rTFlJzybDDYOODcrzGLSO1N V7/ZYF6JOXsDqPiMleQdh8tCVEjWoPid76OjvTzitw4grBn2LLmr1pN3kKZBinPw ==
X-ME-Sender: <xms:xBHRX3QDpDhILgBQcGp5T4qtU6YP1LiR3bnungJGaxzgLJwBNUMhew> <xme:xBHRX4zM1Ye149uNOodcs4bMYziLxBjyfG_lbXqGihfxXLsfPgeAb9ZCaMEtg8hfi AxIwLbfnSd86mEEEw>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedujedrudejkedguddtkecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmd enucfjughrpefofgggkfgjfhffhffvufgtsehttdertderreejnecuhfhrohhmpedftehl vgigvgihucfovghlnhhikhhovhdfuceorggrmhgvlhhnihhkohhvsehfrghsthhmrghilh drfhhmqeenucggtffrrghtthgvrhhnpeeffffhhffffeehgfdtjedvfeettedtheffueeh teevvdevkeffuefgveduvddtleenucffohhmrghinhepihgvthhfrdhorhhgnecuvehluh hsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomheprggrmhgvlhhnihhk ohhvsehfrghsthhmrghilhdrfhhm
X-ME-Proxy: <xmx:xBHRX803PtyQTEm8xjw_o1mJRSncKBr3s9cx1GcOppNKsQwADfDNiw> <xmx:xBHRX3BcfyiHInJTWd9XVq1A4VCB8MqETmqJNGRCZ-Tic107947PKg> <xmx:xBHRXwjAyj6KG0bYcnG59G_PHsH799p7HNfqcAPqAryieAQcxUq-pw> <xmx:xBHRX4Khm5Q6T7A71DRsaugaMav0drW72plfmJBLOsRL1zdnHyXUzw>
Received: by mailuser.nyi.internal (Postfix, from userid 501) id 06B166F6005E; Wed, 9 Dec 2020 13:04:28 -0500 (EST)
X-Mailer: MessagingEngine.com Webmail Interface
User-Agent: Cyrus-JMAP/3.3.0-622-g4a97c0b-fm-20201115.001-g4a97c0b3
Mime-Version: 1.0
Message-Id: <f152ddf0-c19a-42ce-beb3-546070574bc9@www.fastmail.com>
In-Reply-To: <b75081de-b2ee-ecdd-f4b9-bfed2e7cfaf7@nostrum.com>
References: <b75081de-b2ee-ecdd-f4b9-bfed2e7cfaf7@nostrum.com>
Date: Wed, 09 Dec 2020 18:03:13 +0000
From: Alexey Melnikov <aamelnikov@fastmail.fm>
To: Robert Sparks <rjsparks@nostrum.com>, "tools-implementation@ietf.org" <tools-implementation@ietf.org>, jay@daley.org.nz
Content-Type: text/plain
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-implementation/83zR3F23IZHXbi7XTrD-_O5i6S4>
Subject: Re: [Tools-implementation] Draft of message noting that we will allow xml2rfc to produce text formatted as an RFC but paginated with page numbers.
X-BeenThere: tools-implementation@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Tools Implementation <tools-implementation.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-implementation>, <mailto:tools-implementation-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-implementation/>
List-Post: <mailto:tools-implementation@ietf.org>
List-Help: <mailto:tools-implementation-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-implementation>, <mailto:tools-implementation-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 09 Dec 2020 18:04:56 -0000

Hi Robert,
This looks reasonable to me!

On Wed, Dec 9, 2020, at 5:11 PM, Robert Sparks wrote:
> Tools-implementation team (plus Jay): -
> 
> I plan to send the below note to tools-discuss and forward a pointer to 
> it on the ietf list and rfc-interest on Friday unless I hear a request 
> for something significantly different from you before then.
> 
> Please comment. If you think this is ok as is, please say so.
> 
> RjS
> 
> ----------
> 
> Subject: Allowing xml2rfc to generate text documents with page numbers
> 
> The RFCs that define the format specifications for RFCs are clear that 
> the published rendered text format for RFCs will not have page numbers.
> 
> However, we have received many requests to allow the rendering tool to 
> add those numbers when people are rendering documents locally for their 
> own purposes. Adding and maintaining support for that is trivial, and we 
> plan to make that available via a command-line argument in an upcoming 
> release of xml2rfc.
> 
> This isn't a change to how RFCs will be published - published RFCs will 
> continue to follow the format requirements from RFC 7994 and the 
> discussions around the revision of the documents defining the RFC 
> formats. Those wishing to change how RFCs are published should 
> contribute to future efforts revising those specifications.
> 
> In general, the formatters will be able to produce a superset of what is 
> required for RFC publication, and we anticipate that new capabilities 
> will be added when there is appropriate demand.
> 
> We acknowledge the concerns around the potential for confusion raised 
> during the discussion of the request for this capability. However, we 
> note that it is possible to generate a document with the current tools 
> that looks like a published RFC with completely different content. 
> Addressing this potential for confusion is not an issue to solve with 
> the formatting tools.
> 
> Robert Sparks, Tools Team Chair
> 
> 
> 
> -- 
> Tools-implementation mailing list
> Tools-implementation@ietf.org
> https://www.ietf.org/mailman/listinfo/tools-implementation
>