[Rfc-markdown] 1.2.13: add -3 (--v3) command line flag

Carsten Bormann <cabo@tzi.org> Fri, 01 November 2019 21:19 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 DC3331209A6 for <rfc-markdown@ietfa.amsl.com>; Fri, 1 Nov 2019 14:19:37 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.199
X-Spam-Status: No, score=-4.199 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, 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 oVXlPzcjHhm3 for <rfc-markdown@ietfa.amsl.com>; Fri, 1 Nov 2019 14:19:35 -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 6C67112024E for <rfc-markdown@ietf.org>; Fri, 1 Nov 2019 14:19:14 -0700 (PDT)
Received: from [] (p548DCA87.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 474ZnX4MPFzyNS; Fri, 1 Nov 2019 22:19:12 +0100 (CET)
From: Carsten Bormann <cabo@tzi.org>
Content-Type: text/plain; charset=utf-8
X-Mao-Original-Outgoing-Id: 594335950.359863-e6c48987029b1dbb23c5c63f112f4fdc
Content-Transfer-Encoding: quoted-printable
Mime-Version: 1.0 (Mac OS X Mail 11.5 \(3445.9.1\))
Date: Fri, 1 Nov 2019 22:19:12 +0100
Message-Id: <09101E74-4F4E-45E1-AB1D-E09E1C84401B@tzi.org>
To: RFC Markdown <rfc-markdown@ietf.org>
X-Mailer: Apple Mail (2.3445.9.1)
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/PPvtGZutdVqFl3DGEVMtyieY_9U>
Subject: [Rfc-markdown] 1.2.13: add -3 (--v3) command line flag
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: Fri, 01 Nov 2019 21:19:39 -0000

I just pushed version 1.2.13 of kramdown-rfc2629 (I know, daring a couple of days before the I-D deadline, so please do report problems right away so I can fix them quickly).

This adds a “-3” flag (long form: --v3) to both kdrfc and kramdown-rfc2629.

In the latter, this does not do much yet(*), but gradually will start to use more of v3’s features.
If you do need something in the markdown processing to use new v3 features, please speak up, otherwise the update schedule will remain leisurely.
(Note that in many cases just putting in the XML right into the markdown document is a valid workaround, but please do speak up when you need this.)

In kdrfc, the -3 flag invokes xml2rfc (local or remote) with the --v3 command line flag, so it is easy to see how RFCXMLv3 processing will look like.  I do not recommend to do this at this stage unless you want to take part in the debugging of the brave new v3 world.

Update as usual:

	gem update

Grüße, Carsten

(*) FYI: I needed this to enable “orgascii” as a short term workaround for the issue described in https://mailarchive.ietf.org/arch/msg/xml2rfc-dev/MOhbjkfsWDEMVDaBKlYcia-jm3w — I expect we will need to find a more general way to introduce ascii variants (really: Latin script, but that’s not how the attribute is called) for all kinds of text.