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

[Kesara Rathnayake <[e-mail]>]

Hi Randy,

On Tue, 27 Jun 2023 at 13:49, Randy Bush <[e-mail]> wrote:
>
> > Unless I'm missing something obvious here
>
> that's my traditional role
>

:)

> > xml2rfc has implemented "XInclude" similarly to RFC PI include.  Both
> > look at the cache directory for the BibXML first.  So "XInclude" will
> > work offline if you have BibXML references in the cache directory.
>
> i read https://authors.ietf.org/en/references-in-rfcxml and see no clue
> to a "cache directory."
>

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

> as discussed the other day, i rsync as much as i can, though some are
> broken these weeks.
>
>     RSY="/usr/bin/rsync -vaHx --delete"
>
>     $RSY rfc-editor.org::rfcs-text-only $HOME/rfcs
>     $RSY rsync.ietf.org::internet-drafts $HOME/ids
>     # old + new, though i really want only old
>     $RSY rsync.ietf.org::id-archive $HOME/ids.old
>     # for xml2rfc
>     $RSY rsync.ietf.org::xml2rfc.bibxml/bibxml $HOME/refs/rfc
>     $HOME/bin/do-allid
>
> that last being a ruby blob i was given the last time things broke for
> me
>

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

Cheers,
Kesara

> i am old and slow, so need specific recipes.
>
> randy



-- 
Kesara Rathnayake
Senior Software Development Engineer - IETF Administration LLC
[e-mail]