Re: [xml2rfc] rfc2629-xhtml.ent warning

Jay Daley <exec-director@ietf.org> Tue, 16 May 2023 14:24 UTC

Return-Path: <jay@staff.ietf.org>
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 82EFEC151524 for <xml2rfc@ietfa.amsl.com>; Tue, 16 May 2023 07:24:25 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.895
X-Spam-Level:
X-Spam-Status: No, score=-1.895 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=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=ietf-org.20221208.gappssmtp.com
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 e-Kxkyi9Hjoa for <xml2rfc@ietfa.amsl.com>; Tue, 16 May 2023 07:24:23 -0700 (PDT)
Received: from mail-wr1-x42b.google.com (mail-wr1-x42b.google.com [IPv6:2a00:1450:4864:20::42b]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 28E87C1516E9 for <xml2rfc@ietf.org>; Tue, 16 May 2023 07:24:23 -0700 (PDT)
Received: by mail-wr1-x42b.google.com with SMTP id ffacd0b85a97d-307c040797bso4828115f8f.3 for <xml2rfc@ietf.org>; Tue, 16 May 2023 07:24:23 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ietf-org.20221208.gappssmtp.com; s=20221208; t=1684247061; x=1686839061; h=references:to:cc:in-reply-to:date:subject:mime-version:message-id :from:from:to:cc:subject:date:message-id:reply-to; bh=c1nc6rVxJfIXAyCByewdpgzzNlSdrchXPkx2EaU5oOY=; b=DP6na4O13+NskUTHUndA5kVuwqFYKB12SmegvskoWeyNxC1HMrR+UHW3/N2XurJgoV Ag4DMDhuEVutpLZOJXGQPlRT3MuJVwiLFn0xsx4HJbscLhbp5YuA/gZYUApxh069TPJX I/frBRazq12PMhGOvYltVtp24iT8KujNX6wxt1+LyXia6v9NnNA5rNm/fbANH2tLCCkY aIBdCYXUErOoHt/UWvvEcHtcjylYmmuFQVR+VZKLIgq2u7JVTpmWlNG0+oGkppwpMZQI XkUbosuW0rS0Ss7Y8aaAb1kxXNShd03pWnhFYmC++9wCYxDqrW06jP19YGwUiRZfUAHo LVNQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1684247061; x=1686839061; h=references:to:cc:in-reply-to:date:subject:mime-version:message-id :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=c1nc6rVxJfIXAyCByewdpgzzNlSdrchXPkx2EaU5oOY=; b=XVaDxyjd1NPrE2a57vcbZGJADZu4J4x7eqDEc9MX6sI+VCzX8dYC3Qj6g7Q/eMXph1 /8cbXZzsGlyneqvC30t4Mi0/0VbLwSxNYqNm+M/pFGcTimtidqEg00Jg2lWSEd8ltUkJ Axg964JTBG1kUgwPbwVwRiHiuNT9mqgQF1VUfWmIXHRRDgupTD3HZjiScSi+uvGpVmZB cggTHRS4L5+n0aaOnSzGlw7KZ7WUe54ZIRsv1nLyDpWypIGVD5cz4lbYznQXllHvbWRz ibVq/lYtAp3x4Dw+lLZxAfuiFtQyGoizfvJF8uNe7QTcLT614bKVFfC/pL5/vxozQokW YJyQ==
X-Gm-Message-State: AC+VfDzLqR0jJ3dPHiadh1puBqpfLhpjXoINKEI2H2TzkeIB35WD4Xeg S+u/FRxdrO+ejdTFnGUxDebAqz15gBGeocldIJ8+iWl3
X-Google-Smtp-Source: ACHHUZ4gUrCBiBwtOxY7DY3DavyQBB5Kezmx/Z+Lv8iiGHDQENIixnvw3GEVjSuICwZ4FHw7QwGn3A==
X-Received: by 2002:a5d:674b:0:b0:306:2dc3:8b67 with SMTP id l11-20020a5d674b000000b003062dc38b67mr28839257wrw.53.1684247061102; Tue, 16 May 2023 07:24:21 -0700 (PDT)
Received: from smtpclient.apple (host-92-27-125-209.static.as13285.net. [92.27.125.209]) by smtp.gmail.com with ESMTPSA id n11-20020a5d4c4b000000b002c70ce264bfsm2807900wrt.76.2023.05.16.07.24.20 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Tue, 16 May 2023 07:24:20 -0700 (PDT)
From: Jay Daley <exec-director@ietf.org>
Message-Id: <EA50DA32-4D0A-4FB9-B749-CAB07EF18B33@ietf.org>
Content-Type: multipart/alternative; boundary="Apple-Mail=_43EEE3E4-20E3-49F5-89E5-CCACA702B9DA"
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3731.500.231\))
Date: Tue, 16 May 2023 15:23:57 +0100
In-Reply-To: <9c8e932b-f6eb-5cf9-2dae-3018f0a217c0@gmx.de>
Cc: xml2rfc@ietf.org
To: Julian Reschke <julian.reschke@gmx.de>
References: <b09e9607-966a-6250-db4b-5d541b1e690d@htt-consult.com> <EA51BFDA-0A1C-49DA-8301-FDF9BD805D2E@ietf.org> <9c8e932b-f6eb-5cf9-2dae-3018f0a217c0@gmx.de>
X-Mailer: Apple Mail (2.3731.500.231)
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc/nYe8pQc_B_NIGtfmTq6ch706OIU>
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 14:24:25 -0000


> On 16 May 2023, at 14:37, Julian Reschke <julian.reschke@gmx.de> wrote:
> 
> 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.

I was trying to address two things at once, but yes I can see that I only confused things.

The page I pointed to explains this correctly https://authors.ietf.org/en/templates-and-schemas#character-entities

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

No it’s correct, the full rfc2629-xhtml.ent file is no longer required for exactly the reason explained in the warning.

JAy

> 
> Best regards, Julian
> 
> _______________________________________________
> xml2rfc mailing list
> xml2rfc@ietf.org <mailto:xml2rfc@ietf.org>
> https://www.ietf.org/mailman/listinfo/xml2rfc

-- 
Jay Daley
IETF Executive Director
exec-director@ietf.org