Re: [Rfc-markdown] [xml2rfc] New xml2rfc release: v2.25.0

Henrik Levkowetz <henrik@levkowetz.com> Thu, 29 August 2019 20:26 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 F0D72120C14; Thu, 29 Aug 2019 13:26:13 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.9
X-Spam-Level:
X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-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 PvNb6a_BgOxR; Thu, 29 Aug 2019 13:26:12 -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 6EF2912001B; Thu, 29 Aug 2019 13:26:12 -0700 (PDT)
Received: from h-202-242.a357.priv.bahnhof.se ([158.174.202.242]:60571 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 1i3Qzj-000411-KB; Thu, 29 Aug 2019 13:26:12 -0700
To: Robert Moskowitz <rgm@htt-consult.com>, xml2rfc-dev@ietf.org, xml2rfc@ietf.org
References: <E1i2EMD-0002SA-UW@durif.tools.ietf.org> <d82ab9f2-5913-ad0e-dc05-2be319480a3c@htt-consult.com> <e206317e-bb51-c9e6-9dc2-c9d86b13b9da@levkowetz.com>
Cc: rfc-markdown@ietf.org
From: Henrik Levkowetz <henrik@levkowetz.com>
Message-ID: <53c88f77-a4e6-7ef5-9bd4-5de18a23f3e8@levkowetz.com>
Date: Thu, 29 Aug 2019 22:26:03 +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: <e206317e-bb51-c9e6-9dc2-c9d86b13b9da@levkowetz.com>
Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="oAgJ6ShEAo49rHnF5gACaK9iuMMpHxs3C"
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, rgm@htt-consult.com
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/wchU7pdxN3-W5UQPUTOE-h1Qlsk>
Subject: Re: [Rfc-markdown] [xml2rfc] New xml2rfc release: v2.25.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, 29 Aug 2019 20:26:14 -0000

I see Robert's responses landed while I was typing my response ,:-)

On 2019-08-29 22:24, Henrik Levkowetz wrote:
> Hi Bob,
> 
> On 2019-08-29 21:22, Robert Moskowitz wrote:
>> 
>> 
>> On 8/26/19 8:44 AM, Henrik Levkowetz wrote:
>>> Hi,
>>>
>>> This is an automatic notification about a new xml2rfc release,
>>> v2.25.0, generated when running the mkrelease script.
>> 
>> Notes on my experience with the upgrade:
>> 
>> I get the standard warning:
>> 
>> DEPRECATION: Python 2.7 will reach the end of its life on January 1st, 
>> 2020. Please upgrade your Python as Python 2.7 won't be maintained after 
>> that date. A future version of pip will drop support for Python 2.7.
>> 
>> I have both Python2 and 3 installed on my Fedora 30 system.
> 
> This warning indicates either that the default python is still 2.7, or
> that the pip command you are running is symlinked to pip-2.7.
> 
>> What is causing this message?  An old version of pip or xml2rfc?
> 
> Pip.  The pip that comes with Python 2.7 gives the warning above.
> 
> Irrespective of which pip and python you use (2.7, 3.5, 3.6, 3.7),
> the installed version of xml2rfc now supports vocabulary v3.
> 
>> Is there a way to install xml2rfc v3 to start checking it out without 
>> loosing v2?
> 
> xml2rfc v2 and v3 are supported by the same install.  In order to produce
> v3 output, use 'xml2rfc --v3 ...'.  In order to convert your v2 xml files
> to v3 xml, use 'xml2rfc --v2v3 ...'.
> 
> Note that when speaking about 'v3' xml2rfc, there is a certain need to
> indicate which aspect of xml2rfc v3 support you are referring to:
> 
> There is both the matter of the v3 xml vocabulary, where many v2 constructs
> are deprecated; and there are the v3 formatters, which are completely
> rewritten to handle the v3 xml.
> 
> Now, having made that clear, I'm afraid that the following may cause some
> blurring again, but it's been done in the interest of making forward progress
> easier:  If you invoke one of the v3 formatters, by saying for instance
> 'xml2rfc --v3 --text ...', but your input file uses deprecated v2 elements,
> those will be quietly converted internally, using the v2-to-v3 converter,
> and then handed to the v3 formatter.  This of course adds a bit of magic
> to the process, and you will have better control of your output if you work
> with clean v3 input files.  Converting your v2 files to v3 with --v2v3 should
> give you a good starting point for that.
> 
> I hope that helps.
> 
> 
> Best regards,
> 
> 	Henrik
> 
> 
> 
> _______________________________________________
> xml2rfc mailing list
> xml2rfc@ietf.org
> https://www.ietf.org/mailman/listinfo/xml2rfc
>