Re: [xml2rfc] rfc2629-xhtml.ent warning

Julian Reschke <julian.reschke@gmx.de> Tue, 16 May 2023 13:37 UTC

Return-Path: <julian.reschke@gmx.de>
X-Original-To: xml2rfc@ietfa.amsl.com
Delivered-To: xml2rfc@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id D2E6AC151081 for <xml2rfc@ietfa.amsl.com>; Tue, 16 May 2023 06:37:37 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.798
X-Spam-Level:
X-Spam-Status: No, score=-2.798 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, FREEMAIL_FROM=0.001, NICE_REPLY_A=-0.001, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmx.de
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 hPjt_BjA7a8Y for <xml2rfc@ietfa.amsl.com>; Tue, 16 May 2023 06:37:33 -0700 (PDT)
Received: from mout.gmx.net (mout.gmx.net [212.227.15.15]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 55455C14CE5D for <xml2rfc@ietf.org>; Tue, 16 May 2023 06:37:33 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.de; s=s31663417; t=1684244251; i=julian.reschke@gmx.de; bh=FmZGrtwGRgRhXJ4CMo7lNqc11PPFWbnBWjpnIdgvGdU=; h=X-UI-Sender-Class:Date:Subject:To:References:From:In-Reply-To; b=T36q7kmicki7jaFiNtsRoPQ+3qL+RSBvA/s6dpQ5zrV/vJE70eVv8lK3hV2H6NUEi txvVdP4E6ICamllHL6bQOtB6OKtHGsb++BONeR9sQB/c7K1bZzjgdrHAoz7+vE8I7a zvHi8Y7M/c1JD3R2h1WfmOZnQAylTHL23gubFJSS0nlCoh5M3kI3zb/xFx49mfdJlG hllbDAyEvn5fCcow+o4PV26r+A9wgjGxQU9iRCWYTkSIpH9fxGEUafXFOV//w9V5HS Yr+RgSLJst/kM0IZs37+8QZPfYPEoVjB3sYG7AEp7kWYCpk9IZTB7E85LSa13nQseV n1Gl8T4oRVlVw==
X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a
Received: from [10.173.37.15] ([193.105.139.131]) by mail.gmx.net (mrgmx005 [212.227.17.190]) with ESMTPSA (Nemesis) id 1MXXuH-1pfVwK0WGV-00YvDW for <xml2rfc@ietf.org>; Tue, 16 May 2023 15:37:31 +0200
Message-ID: <9c8e932b-f6eb-5cf9-2dae-3018f0a217c0@gmx.de>
Date: Tue, 16 May 2023 15:37:30 +0200
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Thunderbird/102.11.0
Content-Language: en-US
To: xml2rfc@ietf.org
References: <b09e9607-966a-6250-db4b-5d541b1e690d@htt-consult.com> <EA51BFDA-0A1C-49DA-8301-FDF9BD805D2E@ietf.org>
From: Julian Reschke <julian.reschke@gmx.de>
In-Reply-To: <EA51BFDA-0A1C-49DA-8301-FDF9BD805D2E@ietf.org>
Content-Type: text/plain; charset="UTF-8"; format="flowed"
Content-Transfer-Encoding: quoted-printable
X-Provags-ID: V03:K1:dHY5BfaZqCN0SgELpA+Wgxnvnyka9reBdOfiF3q9QhffdbfZkHw NinjcOuMVrehwaj+gBwVwFXqNkeDx6xmcTcK5uqe8jYqmHOkd4OH4Zf5TvbsDOcD6LUFyTl xzMxQU79pEPltBM4napNLC5pYNTnvOqz21qKYgLva+26F46k9pX7OClUS/N6nIg/8J+bY/f 3mmKGM9JoISQL7JN72GMQ==
UI-OutboundReport: notjunk:1;M01:P0:+KqXzmPk25s=;VHoSFHGjuOE/s1wg8H6Fo6V/T+B eLqpSQ11J2tOyWZdiUyA8NMSSZnaGrvHrhG2gqr2ZPDZoyxSodHsmkXhQdlBV0D8k0wIasxHp Qiz8+NuLQY2yGMoKCYTh4dVDCqu5EMx6eDYo9Xiijm+Wl3Xcn+Y+GB7fdTqebFvKF36MlPbrn 5J9dzpkzbmNzcbPXhc8nSvmqELpoWO0dlCw4faYJhRtyNZ9SdiOg0VUnoy3/PuyxUH8esVpki uXzClirbkNaXODOntErsm4xSEeFOeRDhhR+6RnJ3SzeA5qjG7hBRF6wnWJnZGIqZ30qdModmi 8oatkam3KFjBFxQlrL4gF7//Hyhw7djMtVoOxYzPaGg7ntB3VKVyWMF8KZlwuzHAzFMoemBu0 h4uwohfaUwTI+yCdS19WpkzTeLHWe+iqYADFX+6WPMr72rzpTRxW5kAhn/npL8TFaShVdOnx0 Qz+ZFQtoDXgEGfmxZnjYg1K6s+VNbo3wSE2JP52RU5FR50aluNcwuozIVDFQ/IAqB71QGUF0X hAG1igJIRcC4v0nvto++DLNh9X1f7S65CF9Vr22qB5/lH8wJVSZGMZ1FlAtH/fVyoAmEaNA41 v+D84K/AnCxUL8PtK7ahW+Rvt5onWJE7AwfsApOzmEIED83bcIvvjZP9qbE7+bCaTm31szdNK 5IqAG2aDAY9jYmh1tiA0Z0jYhllZU3UDrY5j8tpr/1TpwK8CQ9XGz+nwrL3OFTC0kCpWsYvSN XBmOnwsc0zNA4iModKq8D8bGiQi9L+UjiyDQyEgOxasM01C9d7WMLncXQ0CdxdXTBKL1ciog5 QoBagm0XvYWV5Ztw0oxp6z+J9D7EmQofOmN3j8dWFla39+Xgt9Mig+6tmvURzr+IsoqT2WfHa lV0JfDiEBz28ts4Rrq9QmPtHiIaZB9ZLRAEu0I02mt5oUFse58rRxfMnSrgh2kBCifnxskPlx clk7jQ==
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc/L0XLWuLtANkExq_4OKnAJCxl-4Y>
Subject: Re: [xml2rfc] rfc2629-xhtml.ent warning
X-BeenThere: xml2rfc@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: XML2RFC discussion list <xml2rfc.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/xml2rfc>, <mailto:xml2rfc-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/xml2rfc/>
List-Post: <mailto:xml2rfc@ietf.org>
List-Help: <mailto:xml2rfc-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/xml2rfc>, <mailto:xml2rfc-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 16 May 2023 13:37:37 -0000

On 16.05.2023 15:19, Jay Daley wrote:
>
>> On 16 May 2023, at 14:12, Robert Moskowitz <rgm@htt-consult.com> wrote:
>>
>> It has been a few weeks since my last run of xml2rfc, and that was on what I had installed on my old Fedora 35 notebook, now on my updated Fedora 38 system...
>>
>> So this morning I got (4 times):
>>
>> Warning: /home/rgm/data/htt/Projects/Critical/drafts/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 only use of rfc2629 in my xml is:
>>
>> <!DOCTYPE rfc SYSTEM "rfc2629-xhtml.ent">
>> <?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
>>
>> So obviously there has been a change that I did not catch.  No comments from the rfc editor on working with my drafts a couple months back for rfcs 9373 & 9374 that had these lines.
>>
>> So what is the current for !DOCTYPE and xml-stylesheet?
>
> A DOCTYPE is not recommended because the grammar is specified in Compact RelaxNG not any other schema format.   The recommended method to associate the schema with the XML is
>
> 	<?xml-model href="rfc7991bis.rnc"?>
>
> Note, this will require you to have rfc7991bis.rnc in your build path.
>
> This is fully explained in the authors documentation here:
>
> 	https://authors.ietf.org/en/templates-and-schemas
>
> That same page also links to the "official" templates that can be used as starting points.
>
> Finally, the authors documentation also lists various XML editors and how the interact with the schema
>
> 	https://authors.ietf.org/en/drafting-in-xml
>
> Jay

Jay,

I don't think this is helpful.

Robert's DOCTYPE declaration is used to define named character entities.
RelaxNG doesn't help with these at all.

The warning message from xml2rfc is completely misleading, as it
conflates entity declarations with validation.

Best regards, Julian