Re: [xml2rfc] rfc2629-xhtml.ent warning

Jay Daley <exec-director@ietf.org> Tue, 16 May 2023 13:19 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 A8FE9C151B3E for <xml2rfc@ietfa.amsl.com>; Tue, 16 May 2023 06:19:59 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.896
X-Spam-Level:
X-Spam-Status: No, score=-1.896 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, 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 VPecq6nox5AO for <xml2rfc@ietfa.amsl.com>; Tue, 16 May 2023 06:19:57 -0700 (PDT)
Received: from mail-wm1-x330.google.com (mail-wm1-x330.google.com [IPv6:2a00:1450:4864:20::330]) (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 C9111C151B0D for <xml2rfc@ietf.org>; Tue, 16 May 2023 06:19:57 -0700 (PDT)
Received: by mail-wm1-x330.google.com with SMTP id 5b1f17b1804b1-3f509ec3196so26273445e9.1 for <xml2rfc@ietf.org>; Tue, 16 May 2023 06:19:57 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ietf-org.20221208.gappssmtp.com; s=20221208; t=1684243196; x=1686835196; h=to:references:message-id:content-transfer-encoding:cc:date :in-reply-to:from:subject:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=o//KHZ0cC9SrHAu7ug0CVcwKJSkxpHH7WjLcmg1ASmU=; b=OQJQkR21VFfF9QhOA3NXCsAocXHw82tJhFCboDl3UO84oEu33+Crx3L5wBYqQGphVv eIrt/d4g83sIu6N/HS7BRG4S8n5ItPxaI2B4W+X6a+kSLTs/RM558/7jokTK+316hnaO /AikFuI+fSErWIn+ZyArX32VIj6RVMzr/lHKtK+HwI0RH08A6fudbiNIfAp4f2OCyHW3 RKf6AZZf2yV9iEt7PFP18eUEZ1HBKE8VqruOClzOvVI08hpCVwOKLbb2G2NrTWhZI3Bv H+oVTW6DLbdfkKtEkKNCQyVpxlYmSm/fCfB067subiqIe59krMUCYu/BIY39MvYkYJVi UhzQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1684243196; x=1686835196; h=to:references:message-id:content-transfer-encoding:cc:date :in-reply-to:from:subject:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=o//KHZ0cC9SrHAu7ug0CVcwKJSkxpHH7WjLcmg1ASmU=; b=jph+7NFtq91uVNo+sgwoDrwT/oM+PUpFyFyQY4WZqFnyWETpzcvN0pCC1FMKFI7wAP EpDW0Xlu6Vt9s1aNcE5pmb4DZYf6uGwytzHqPdYqm1MBbosNoYAbD3lIw90I/BdfaCqe xW3O7zFh3F72JFfebHjUqTtAAlJ0yGHJWuGj5w1V4oWLv0h9j91PRCqmJnLStJG5qKi9 b+k45uvSROqBiPpF54adSC9g99EskrrVActsMu+7/Arcg1ZP3OVYgs5fCjNt7qCmwOH2 ALwrtxqZ6dHUwkwOrYrLQuc6bj9a5N8RgU+EdPKlQci+8o4DUhPxDxnbOmP5COlPYa+u WmXw==
X-Gm-Message-State: AC+VfDzGtGcmZ2rBQUYZ9uQ1KMQxZxOgIqvKG9BH11nuaq3QWuguhSxZ soscEut3bQuXoT7bvzj+DvW89pHUjOLbr3FtWLMOsSxY
X-Google-Smtp-Source: ACHHUZ67TeHGkDd7kmT0SMpY3mg5QkWVpWDAOWVM5wJNdCnX5c7pijHDbtB5E7KEkHq374evXUw+TA==
X-Received: by 2002:a05:6000:c7:b0:307:9081:d355 with SMTP id q7-20020a05600000c700b003079081d355mr19383562wrx.26.1684243195827; Tue, 16 May 2023 06:19:55 -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 d1-20020a056000114100b003062d815fa6sm2599856wrx.85.2023.05.16.06.19.55 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Tue, 16 May 2023 06:19:55 -0700 (PDT)
Content-Type: text/plain; charset="us-ascii"
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3731.500.231\))
From: Jay Daley <exec-director@ietf.org>
In-Reply-To: <b09e9607-966a-6250-db4b-5d541b1e690d@htt-consult.com>
Date: Tue, 16 May 2023 14:19:31 +0100
Cc: "xml2rfc@ietf.org" <xml2rfc@ietf.org>
Content-Transfer-Encoding: quoted-printable
Message-Id: <EA51BFDA-0A1C-49DA-8301-FDF9BD805D2E@ietf.org>
References: <b09e9607-966a-6250-db4b-5d541b1e690d@htt-consult.com>
To: Robert Moskowitz <rgm@htt-consult.com>
X-Mailer: Apple Mail (2.3731.500.231)
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc/HAhjCHwuLhsVG6bjojxdowoL5Ko>
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:19:59 -0000

> 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

> 
> thanks
> 
> 
> _______________________________________________
> xml2rfc mailing list
> xml2rfc@ietf.org
> https://www.ietf.org/mailman/listinfo/xml2rfc

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