[Tools-discuss] xml2rfc in --v2 mode -- bug report?

John C Klensin <john-ietf@jck.com> Sat, 11 June 2022 19:29 UTC

Return-Path: <john-ietf@jck.com>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id DB7B6C157B53 for <tools-discuss@ietfa.amsl.com>; Sat, 11 Jun 2022 12:29:11 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.907
X-Spam-Level:
X-Spam-Status: No, score=-1.907 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_NONE=0.001, T_SCC_BODY_TEXT_LINE=-0.01] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id k5UQmNMM-Emu for <tools-discuss@ietfa.amsl.com>; Sat, 11 Jun 2022 12:29:10 -0700 (PDT)
Received: from bsa2.jck.com (ns.jck.com [70.88.254.51]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id C3B6DC157B5A for <tools-discuss@ietf.org>; Sat, 11 Jun 2022 12:29:10 -0700 (PDT)
Received: from [198.252.137.10] (helo=PSB) by bsa2.jck.com with esmtp (Exim 4.82 (FreeBSD)) (envelope-from <john-ietf@jck.com>) id 1o06nE-0005HS-P0 for tools-discuss@ietf.org; Sat, 11 Jun 2022 15:29:08 -0400
Date: Sat, 11 Jun 2022 15:29:03 -0400
From: John C Klensin <john-ietf@jck.com>
To: tools-discuss@ietf.org
Message-ID: <B39D28F0353AE74800217ADC@PSB>
X-Mailer: Mulberry/4.0.8 (Win32)
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
X-SA-Exim-Connect-IP: 198.252.137.10
X-SA-Exim-Mail-From: john-ietf@jck.com
X-SA-Exim-Scanned: No (on bsa2.jck.com); SAEximRunCond expanded to false
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/_s_Ai9xr2_prNY9IPn-SXp-Fs88>
Subject: [Tools-discuss] xml2rfc in --v2 mode -- bug report?
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss/>
List-Post: <mailto:tools-discuss@ietf.org>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sat, 11 Jun 2022 19:29:11 -0000

Hi.   I have an old document, in xml2rfc v2 format, whose
content I'm trying to upgrade.  When I run
   xml2rfc DocName.xml --v2
(with version 3.12.7) I get a series of messages that look like

 Warning:
	file:/C:/Users/Klensin/AppData/Local/Programs/Python/Pyt
	hon37/lib/site-packages/xml2rfc/templates/rfc2629-xhtml.
	ent is no longer needed as the special processing of
	non-ASCII characters has been superseded by direct
	support for non-ASCII characters in RFCXML.

The source does not contain any references to rfc2629-xhtml.ent.
It does, of course, contain 
	<?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?>
as well as the DOCTYPE statement that specifies the DTD

Are these warnings actually addressed to something in the DTD or
stylesheet file than should be cleaned out and, if so, how does
that get done?

Also, I see an additional statement that says 

	Warning: The 'docName' attribute of the <rfc/> element
	should have a revision number as the last component:
	docName="draft-foo-bar-02".

Not a huge problem as long as it is just a warning, but I'm
almost certainly not the only one who uses odd names to keep
track of evolving working versions of a draft between versions
that actually get posted.  I typically use draft-docname-NNa,
draft-docname-NNb, etc.  I've seen signs of others using
draft-docname-NN-DATE or other conventions).  I don't know how
best to do this (other than leaving the issue to the submission
tool), but, if the intent is that people read, study, and act on
warnings, keeping down the noise would be helpful.

thanks,
   john

p.s. Before someone asks why I don't just convert to v3 and be
done with it, when I try that, the conversion appears to work
(no error messages, no warning messages other than the one above
about /rfc2629-other.ent, file created successfully).  However,
when I try to process that file, I get an impressive traceback
whose entries appear to be pointing into different Python
modules followed by "KeyError: 'day'".   If anyone feels like
having a look at that, let me know offlist.  Otherwise, I need
to stay with v2 until I have much more time on my hands.