[Rfc-markdown] empty include files

Michael Richardson <mcr@sandelman.ca> Sun, 12 December 2021 21:38 UTC

Return-Path: <mcr@sandelman.ca>
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 C14443A0BA7 for <rfc-markdown@ietfa.amsl.com>; Sun, 12 Dec 2021 13:38:55 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.099
X-Spam-Level:
X-Spam-Status: No, score=-2.099 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, SPF_HELO_NONE=0.001, 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=sandelman.ca
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 0H9EbICxCEuB for <rfc-markdown@ietfa.amsl.com>; Sun, 12 Dec 2021 13:38:50 -0800 (PST)
Received: from tuna.sandelman.ca (tuna.sandelman.ca [IPv6:2607:f0b0:f:3:216:3eff:fe7c:d1f3]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id ABC5C3A0B98 for <Rfc-markdown@ietf.org>; Sun, 12 Dec 2021 13:38:47 -0800 (PST)
Received: from localhost (localhost [127.0.0.1]) by tuna.sandelman.ca (Postfix) with ESMTP id 091F338A95 for <Rfc-markdown@ietf.org>; Sun, 12 Dec 2021 16:42:45 -0500 (EST)
Received: from tuna.sandelman.ca ([127.0.0.1]) by localhost (localhost [127.0.0.1]) (amavisd-new, port 10024) with LMTP id 0FTRgxf-fW38 for <Rfc-markdown@ietf.org>; Sun, 12 Dec 2021 16:42:43 -0500 (EST)
Received: from sandelman.ca (obiwan.sandelman.ca [IPv6:2607:f0b0:f:2::247]) by tuna.sandelman.ca (Postfix) with ESMTP id 1668238A90 for <Rfc-markdown@ietf.org>; Sun, 12 Dec 2021 16:42:43 -0500 (EST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=sandelman.ca; s=mail; t=1639345363; bh=DAdi8+J0me/JKa3KsEL3SDaTbuzDdLz4zeyEH/aouSs=; h=From:To:Subject:Date:From; b=8DkFAqYGLICTHQWaeQ4KhdM6a1hj9gxjvxVpiWxFmBj/jSgiGlx/+7N2Lno3cxYUy ZxxOH2W6mLewd/xHTtt/Z8xEGyo3H77+h1udeojLcbZeiGMM6ixX6DDTVSu/pbLaEJ Xlem+uEpE64oL3sHFFYvECKgYzutIidhQUDNGWq7//flsbqNqPI1kvM/mF9GYWfD7g 8aviNhJckBdS1MnrG8XBJrrqtc2ach8fNhiLoPOmDkk3BVAeE8sN1V0m1nX0WdagIg S1TzvWXYAIhllW8sFrJd2/NhsaUzGkmpd+mJi2ltE4/jSg8QOAJg94oI9JJRMcFm8U hgltNTdWX3WUg==
Received: from localhost (localhost [IPv6:::1]) by sandelman.ca (Postfix) with ESMTP id 8E84C3E9 for <Rfc-markdown@ietf.org>; Sun, 12 Dec 2021 16:38:42 -0500 (EST)
From: Michael Richardson <mcr@sandelman.ca>
To: Rfc-markdown@ietf.org
X-Attribution: mcr
X-Mailer: MH-E 8.6+git; nmh 1.7+dev; GNU Emacs 26.1
X-Face: $\n1pF)h^`}$H>Hk{L"x@)JS7<%Az}5RyS@k9X%29-lHB$Ti.V>2bi.~ehC0; <'$9xN5Ub# z!G,p`nR&p7Fz@^UXIn156S8.~^@MJ*mMsD7=QFeq%AL4m<nPbLgmtKK-5dC@#:k
MIME-Version: 1.0
Content-Type: multipart/signed; boundary="=-=-="; micalg="pgp-sha512"; protocol="application/pgp-signature"
Date: Sun, 12 Dec 2021 16:38:42 -0500
Message-ID: <16473.1639345122@localhost>
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/4FoAYrVw7oTL7AfPeoXe5YK6CC0>
Subject: [Rfc-markdown] empty include files
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: Sun, 12 Dec 2021 21:38:56 -0000

While working on RFC8791 (sx:structure) updates to RFC8366bis, I would up
producing a zero length file which was then included. (Why the file is zero
is yet to be determined)

When this happens, I get:

xml2rfc -q -s 'Setting consensus="true" for IETF STD document' --rfc-base-url https://www.rfc-editor.org/rfc/ --id-base-url https://datatracker.ietf.org/doc/html/ --cache=/home/mcr/.cache/xml2rfc --css=lib/v3.css --metadata-js-url=/dev/null draft-richardson-anima-rfc8366bis.xml -o draft-richardson-anima-rfc8366bis.html --html
/corp/ietf/lwork/anima/voucher/draft-richardson-anima-rfc8366bis.xml(351): Error: Expected ascii-art artwork for <artwork type="">, but found b'<artwork xmlns:xi="http://www.w3.org/2001/XInclude" name="" type="" align="left" alt="" pn="section-5.1-2">\n</artwork>\n      '...

Line 351 says:
        <artwork name="" type="" align="left" alt=""><![CDATA[
]]></artwork>

As a result of:
~~~~
{::include yang/ietf-voucher-tree-latest.txt}
~~~~

Putting some content ("HELLO") into yang/ietf-voucher-tree-latest.txt makes
xml2rfc happy.

This feels like an XML2RFC bug in that it can't cope with an empty artwork.
The diagnostics from xml2rfc seems off too, since the input doesn't have what
was provided.

But, maybe kramdown-rfc2629 is at fault for daring to include no content.