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

Julian Reschke <julian.reschke@gmx.de> Wed, 09 October 2019 16:15 UTC

Return-Path: <julian.reschke@gmx.de>
X-Original-To: xml2rfc-dev@ietfa.amsl.com
Delivered-To: xml2rfc-dev@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id DD7B9120879 for <xml2rfc-dev@ietfa.amsl.com>; Wed, 9 Oct 2019 09:15:15 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.599
X-Spam-Level:
X-Spam-Status: No, score=-2.599 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=gmx.net
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id JuPQeyN7Y0iS for <xml2rfc-dev@ietfa.amsl.com>; Wed, 9 Oct 2019 09:15:12 -0700 (PDT)
Received: from mout.gmx.net (mout.gmx.net [212.227.17.22]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 54AF7120876 for <xml2rfc-dev@ietf.org>; Wed, 9 Oct 2019 09:15:12 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1570637702; bh=FGq/7M30HKdyksDEqi6kR6zfgZXcHBa/7dDvFq8LWUg=; h=X-UI-Sender-Class:Subject:To:Cc:References:From:Date:In-Reply-To; b=Bu+nguWB91a+wJkk5PIQ0sEeZuV2mqSVpDjTLDxqiTUOCzg+MedqS7JODJmxkby86 lMJJ+okktg09u6GDb03B8ubQztEeXzYUsvD1jlj5YHJ5bG2nzat2xXxo6v5mXzT+es o85hFiFe+zLNpG4Lfrcfm1TR5+8QbTGFdF2HST1M=
X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c
Received: from [192.168.178.124] ([84.171.145.63]) by mail.gmx.com (mrgmx104 [212.227.17.168]) with ESMTPSA (Nemesis) id 1M3DNt-1iFDHH2t9J-003ffb; Wed, 09 Oct 2019 18:15:02 +0200
To: Heather Flanagan <rse@rfc-editor.org>
Cc: XML Developer List <xml2rfc-dev@ietf.org>
References: <bd47caef-fe97-f078-3c23-0744fa9154ce@gmx.de> <6CBA5233-FDBE-4E5B-BC8D-C9AC27D17B80@rfc-editor.org>
From: Julian Reschke <julian.reschke@gmx.de>
Message-ID: <6e36282d-c6d2-6031-2002-e4bbc85b3fc0@gmx.de>
Date: Wed, 09 Oct 2019 18:14:59 +0200
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101 Thunderbird/60.9.0
MIME-Version: 1.0
In-Reply-To: <6CBA5233-FDBE-4E5B-BC8D-C9AC27D17B80@rfc-editor.org>
Content-Type: text/plain; charset="utf-8"; format="flowed"
Content-Language: en-US
Content-Transfer-Encoding: quoted-printable
X-Provags-ID: V03:K1:3i7o+i8G4s/XNRkQg7t8GCniRgioh50zdOfh97VKIZa1515U54I yhiYOTWAs7P0HaeN/PYZLh9p3K9gZDQazuyJNiIOmG444TFmeJub4yhiyejnfLuJ36Rsg46 cFzc7tjeNYqnKGYiH9MOKYpBU8h/7pKUFcdgqBX+Yw5MUAXmHbzaTNJnANMcZYd2fWEp9wL SifPc+xieH4/Zo0g3b+Ng==
X-UI-Out-Filterresults: notjunk:1;V03:K0:G1x/t5O1eu4=:idTxOynAnS2hRX6+SyBrUL ss0JC4pZJQB43SjsPrTKW6lVnhpHiIbYeWW51Hi1b0Y+zbiWez0tPV4FSOmeZ21sGGjsLRwS9 n0WDR9APSOxtZOgFqUXpdWZ8E5c7itB2jIWaeqhtPZ9DGbiZ+qow+REgZalVxJPTqle7Fw77k NOf+ft2UnqeNB5Umi26gr62NFK21vYw/VuZr3GSmD/FD9r7TXQ8GeoUaS7sLzaEMvN69IKQja VrRGcuMPh1u/heZpGRMH1/f8lRtdAwAS3ovbZ1eIt3UtXpztxMv2jvQwPcBvILsGEpofqMUzd SII8Gi502rBuYerie5asztJ0oLNkhTD+FB0Z6sLN9ycsOWEf2+gc2Lw3fY1xYQJvQDjafcWnh s5gKbxlr2vqqUk+eKNqCoXaMyKPC+i1lGMkKvTEtE9O7xwe7WLYQGA62hFk32/W30MgfVbBNq c8onF53rK5k+s7MJPImjxI757DS0Jk9yRHjAceskdZ2DymZfzt6hF+xIfioaF9W86kkRORXMR tUzCe0ksjMjg5D+0eypnVC4rGctcVGwLtJN/8MV6ymmxF3+Z9xLuQ/UBuL9U6R3hbkXm3Kgzx jTQiAnr6JhM9qRCh10tPJzXtAfFqtl3kBoDLXNvoJOZqLZopcd+GUnqEgKLva1Id9oTcqUtwD DQePBYpebjO1+XhESeiYjrw5zN8IU3ahM+vjg7R7IiihaDRTfsd04GVBs6T8ViCkUA0DAH58T RjQuY+DZegHAjDHQGazXD3PkZMaIKI4C2CyKVhVMWtCP1rK7GCj7ncKocZLet7Ze/pzZKrrin MEsthM3P6hiQHHGHzmar1T6FvgakRYeoMz3pDGlKSKT9WgeOG4/AE44Zy3+17Si2LxaNTnxEv 9PyNKALDbNac/GgGf14XWjZtamPoTpbgQs//nK+5nh37AsuD5Fj3GMSW6Eyowk6ue0ZnD71tN BiOc97XHxV+vj5lzBdq+vKQ28ZRNntEDBTruJPSzQPGyGol/E9d2Xs7iVp2fnH/zwUPi4YZnU dmbUNPac7jx/kjibfezXnv4y8bAIezMpJiUGBVRLcf2Cjy0o1TkSwaGVaPLQjm+ykCoFjrYnK nCwnJP0+oPp//Lqe5gDGS2ACT0prfynJf4U8vEeAuj3x1cWai/6Wae7IrcT2jQg7SBlaqAwd7 7teabnXQVj9bSxzm4ct5Id4MCeu20yagE5/FUASKfZDk7IKcQkqtKvBPvN5GrByzOaDopwgNs OwWCptAJ/oLpJZqKoNk1FHoyrbN4xqnWTrdxydf2MucMWw9bsHYkA9QTBRCI=
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc-dev/gs4TwybyZTvZyJMitH-i6qyCbKA>
Subject: [xml2rfc-dev] xml2rfc: use of <boilerplate> in preptool step
X-BeenThere: xml2rfc-dev@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "Discussion about particulars of xml2rfc V3 design, development and code." <xml2rfc-dev.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/xml2rfc-dev>, <mailto:xml2rfc-dev-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/xml2rfc-dev/>
List-Post: <mailto:xml2rfc-dev@ietf.org>
List-Help: <mailto:xml2rfc-dev-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/xml2rfc-dev>, <mailto:xml2rfc-dev-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 09 Oct 2019 16:15:16 -0000

On 09.10.2019 17:47, Heather Flanagan wrote:
> ...
> Hi -
>
> Is there any reason not to create a separate <toc> element that would live in <front>?
>
> -Heather
> ...

That would be better, as it wouldn't conflate things with <boilerplate>.

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.

Best regards, Julian