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

Randy Bush <randy@psg.com> Tue, 27 June 2023 06:52 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 CF952C1526F4 for <xml2rfc@ietfa.amsl.com>; Mon, 26 Jun 2023 23:52:54 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.897
X-Spam-Level:
X-Spam-Status: No, score=-1.897 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, 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
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 kGhoS2MoSX6V for <xml2rfc@ietfa.amsl.com>; Mon, 26 Jun 2023 23:52:50 -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 06D1CC1524DE for <xml2rfc@ietf.org>; Mon, 26 Jun 2023 23:52:49 -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 1qE2ZD-000eND-DN; Tue, 27 Jun 2023 06:52:47 +0000
Date: Mon, 26 Jun 2023 23:52:46 -0700
Message-ID: <m2mt0ltn0h.wl-randy@psg.com>
From: Randy Bush <randy@psg.com>
To: Kesara Rathnayake <kesara@staff.ietf.org>
Cc: Robert Sparks <rjsparks@nostrum.com>, xml2rfc@ietf.org
In-Reply-To: <CAD2=Z86Nr1KnpPQNNu55kL75i5D9CaHXa0WDngkKxBJMLeHU+A@mail.gmail.com>
References: <m2v8f9ua1d.wl-randy@psg.com> <1C2D7469-A3FE-4029-9F5F-649E2AC3B390@nostrum.com> <m2ttutu5b9.wl-randy@psg.com> <CAD2=Z86oWFs6yPm6Fzt1S4HbFJnP8t=qE58c8NnFo-L=UouRiw@mail.gmail.com> <m2o7l1u11k.wl-randy@psg.com> <CAD2=Z86Nr1KnpPQNNu55kL75i5D9CaHXa0WDngkKxBJMLeHU+A@mail.gmail.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="US-ASCII"
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc/EK5eSzUWWuTbUH5YKCAOtaOlFjE>
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: Tue, 27 Jun 2023 06:52:54 -0000

> That document needs some improvement.
> 
> You can provide a cache directory with `--cache, -c = PATH `
> See https://ietf-tools.github.io/xml2rfc/#appendix-B.5-1.4.1
> And use `--no-network, -N` to avoid network resolvers.
> See https://ietf-tools.github.io/xml2rfc/#appendix-B.4-1.6.1

thanks, i think.  will try to get time to trudge through this tomorrow

> After setting up your rsync data directories, how do you run xml2rfc?
> What configuration options do you use?

    $ grep -i xml .bashrc
    export XML_LIBRARY=.:/Users/randy/refs/rfc:/Users/randy/refs/id

and the Makefile has

    xml2rfc $(NAME).xml --html --text

randy