[Rfc-markdown] 1.3.10: switch web service to xml2rfc-dev.cgi [...]

Carsten Bormann <cabo@tzi.org> Sat, 25 July 2020 18:45 UTC

Return-Path: <cabo@tzi.org>
X-Original-To: rfc-markdown@ietfa.amsl.com
Delivered-To: rfc-markdown@ietfa.amsl.com
Received: from localhost (localhost []) by ietfa.amsl.com (Postfix) with ESMTP id AF6B33A08EC for <rfc-markdown@ietfa.amsl.com>; Sat, 25 Jul 2020 11:45:46 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.919
X-Spam-Status: No, score=-1.919 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_MSPIKE_H4=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([]) by localhost (ietfa.amsl.com []) (amavisd-new, port 10024) with ESMTP id eHFpIaQhfc-K for <rfc-markdown@ietfa.amsl.com>; Sat, 25 Jul 2020 11:45:43 -0700 (PDT)
Received: from gabriel-vm-2.zfn.uni-bremen.de (gabriel-vm-2.zfn.uni-bremen.de []) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id AE0253A08F5 for <rfc-markdown@ietf.org>; Sat, 25 Jul 2020 11:45:42 -0700 (PDT)
Received: from [] (p5089ae91.dip0.t-ipconnect.de []) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by gabriel-vm-2.zfn.uni-bremen.de (Postfix) with ESMTPSA id 4BDZl90dyVzyXw; Sat, 25 Jul 2020 20:45:41 +0200 (CEST)
From: Carsten Bormann <cabo@tzi.org>
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Mao-Original-Outgoing-Id: 617395540.4277411-2395c3202acdede3503813ac4ebe69dd
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.\))
Date: Sat, 25 Jul 2020 20:45:40 +0200
Message-Id: <8742F366-04EA-4BAA-9092-EE64258281A9@tzi.org>
To: rfc-markdown@ietf.org
X-Mailer: Apple Mail (2.3608.
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/NW1KJq7_M4qQG34Grjq0gWcBdLk>
Subject: [Rfc-markdown] 1.3.10: switch web service to xml2rfc-dev.cgi [...]
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: Sat, 25 Jul 2020 18:45:47 -0000

1.3.10: switch web service to xml2rfc-dev.cgi; better diagnostics

New environment parameter KRAMDOWN_XML2RFC_WEBSERVICE, default: http://xml2rfc.tools.ietf.org/cgi-bin/xml2rfc-dev.cgi

A little known feature of the kdrfc tool is that, if xml2rfc breaks for some reason (as it did for me when I recently messed up my python3 installation), the tool simply uses the web service at https://xml2rfc.tools.ietf.org/.  This is so seamless that it doesn’t even tell you unless you switch to verbose.

It appears that, for v3, the code was using a feature that is not in xml2rfc.cgi on the server.  I changed that URL to xml2rfc-dev.cgi and made the URL switchable using the environment variable KRAMDOWN_XML2RFC_WEBSERVICE .

Unless your local xml2rfc breaks (or you don’t have one), this won’t concern you.

As usual, upgrade with

	gem update kramdown-rfc2629

Grüße, Carsten