Re: [xml2rfc-dev] xml2rfc: use of <boilerplate> in preptool step

[Julian Reschke <[e-mail]>]

On 09.10.2019 18:44, Heather Flanagan wrote:
> ...
>> That said, I still don't get why the Table of Contents needs to be part
>> of the canonical XML. I understand why it's desirable to be present in
>> an intermediate representation before rendering, but that doesn't mean
>> it needs to leak out into the canonical format.
>
> I feel fairly strongly that the final XML must be self-contained. While someone can derive the TOC based in section headers, deriving details is not as good as just have the thing available in one place.
>
> You don’t agree. I get that. But I am insisting on this one.
> ...

I don't see the point (and it contradicts the specs). But well, it won't
hurt either, except that it causes potential confusion. Just make sure
it's fully specified (for instance, what to do when it's present in the
input source and does not match the to-be-generated ToC).

Also, as a reminder, there are other places where text is generated, and
which is not reflected in the canonical XML (for instance, anything
generated by processing <u>, or the code that reformats the contents of
<postal>).

Best regards, Julian