Re: [xml2rfc] XInclude should be used instead of PI include

Randy Bush <randy@psg.com> Mon, 26 June 2023 22:35 UTC

Return-Path: <randy@psg.com>
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 8ED2AC151063 for <xml2rfc@ietfa.amsl.com>; Mon, 26 Jun 2023 15:35:33 -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, RCVD_IN_DNSWL_BLOCKED=0.001, 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
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 4st5qzwgKEy1 for <xml2rfc@ietfa.amsl.com>; Mon, 26 Jun 2023 15:35:29 -0700 (PDT)
Received: from ran.psg.com (ran.psg.com [IPv6:2001:418:8006::18]) (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 506C9C14CE54 for <xml2rfc@ietf.org>; Mon, 26 Jun 2023 15:35:29 -0700 (PDT)
Received: from localhost ([127.0.0.1] helo=ryuu.rg.net) by ran.psg.com with esmtp (Exim 4.93) (envelope-from <randy@psg.com>) id 1qDunv-000ceB-W1; Mon, 26 Jun 2023 22:35:28 +0000
Date: Mon, 26 Jun 2023 15:35:26 -0700
Message-ID: <m2v8f9ua1d.wl-randy@psg.com>
From: Randy Bush <randy@psg.com>
To: Robert Sparks <rjsparks@nostrum.com>
Cc: xml2rfc@ietf.org
In-Reply-To: <40975c07-be1c-124b-f9fa-6d8a979157b5@nostrum.com>
References: <m25y7auglb.wl-randy@psg.com> <B71CAF97-2924-47FF-B28C-61E9C1B93CB1@tzi.org> <m21qhyueoj.wl-randy@psg.com> <2612E60E-6B70-44DE-A87A-5ADB7F21F923@tzi.org> <40975c07-be1c-124b-f9fa-6d8a979157b5@nostrum.com>
User-Agent: Wanderlust/2.15.9 (Almost Unreal) Emacs/26.3 Mule/6.0 (HANACHIRUSATO)
MIME-Version: 1.0 (generated by SEMI-EPG 1.14.7 - "Harue")
Content-Type: text/plain; charset="ISO-8859-1"
Content-Transfer-Encoding: quoted-printable
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc/vwCsXRvACseKGV_AIi8Vz0eLK1k>
Subject: Re: [xml2rfc] XInclude should be used instead of PI include
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: Mon, 26 Jun 2023 22:35:33 -0000

>>> i have a local rsunk repo and am doing
>>> 
>>>     <references title="Normative References">
>>>       <?rfc include="reference.RFC.2119.xml"?>
> 
> That would look like <xi:include
> href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.2119.xml"/>
> 
> All of Carsten's observation about this hardcoding an external
> reference and that the URLs have been changing a _lot_ recently are
> correct, as you can see from the before-preptool source for one of the
> most recently published RFCs:
> 
> rjsparks@undex feat-rfc % curl --no-progress-meter
> https://www.rfc-editor.org/prerelease/rfc9425.notprepped.xml | grep
> 8174
>     <xref target="RFC8174"/> when, and only when, they appear in all
> capitals,
> <xi:include
> href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.8174.xml"/>
> 
> (The RPC is shifting to using bib.ietf.org to which xml2rfc.ietf.org
> redirects).
> 
> For Internet-Drafts, you'll need to use an href that looks like
> 
> https://bib.ietf.org/public/rfc/bibxml-ids/reference.I-D.ietf-rtgwg-segment-routing-ti-lfa.xml
> 
> That is, using xi:include comes with the extra burden of knowing the
> names of the bibxml datasets.
> 
> There are conversations ongoing about how to avoid these
> author-unfriendly aspects.

i demand a refund!!!!

i need to build when there is no net connectivity.  this is why i have
rsunc repos.

randy