Re: [xml2rfc-dev] https://tools.ietf.org/html/draft-levkowetz-xml2rfc-v3-implementation-notes-09#section-3.1.20

Julian Reschke <julian.reschke@gmx.de> Tue, 29 October 2019 21:08 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 5857912006D for <xml2rfc-dev@ietfa.amsl.com>; Tue, 29 Oct 2019 14:08:21 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.898
X-Spam-Level:
X-Spam-Status: No, score=-1.898 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=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 JnS3kpywmyhx for <xml2rfc-dev@ietfa.amsl.com>; Tue, 29 Oct 2019 14:08:19 -0700 (PDT)
Received: from mout.gmx.net (mout.gmx.net [212.227.15.19]) (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 4CB0E120119 for <xml2rfc-dev@ietf.org>; Tue, 29 Oct 2019 14:08:19 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1572383284; bh=TUeyO5j8kEMBkeYT8FEPEr0lRwOwNRtuWzUfdwMC5ns=; h=X-UI-Sender-Class:Subject:To:Cc:References:From:Date:In-Reply-To; b=EzuMn13tOzl8pj3xn0UFfRi4yHA21Xpmw0cw4a22uVsSs+Jf+f1C65M+EPVndyCA1 JDzpky28uZq4FdZqDcM4D44FQgKRSkURLAABbk+lX6sI8kRAaiAg3P+QTS1hM3U1Lk ASqtcvK510Lz6NktvetNmj5+WlX7h3tcT3nfQSuI=
X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c
Received: from [192.168.178.124] ([84.171.146.73]) by mail.gmx.com (mrgmx005 [212.227.17.190]) with ESMTPSA (Nemesis) id 1MG9kM-1iBEpk0Vum-00Gb1n; Tue, 29 Oct 2019 22:08:04 +0100
To: Henrik Levkowetz <henrik@levkowetz.com>, Heather Flanagan <rse@rfc-editor.org>
Cc: XML Developer List <xml2rfc-dev@ietf.org>
References: <dd955428-7129-c0e9-4064-ef963ada90c7@gmx.de> <159956F3-1DDA-436E-8565-689F4EA74609@rfc-editor.org> <cbffe2cb-9c71-28b2-fac0-36325b193bfd@levkowetz.com>
From: Julian Reschke <julian.reschke@gmx.de>
Message-ID: <36788e82-18ca-f6ff-b1e4-c47ed9bd882d@gmx.de>
Date: Tue, 29 Oct 2019 22:08:00 +0100
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: <cbffe2cb-9c71-28b2-fac0-36325b193bfd@levkowetz.com>
Content-Type: text/plain; charset="utf-8"; format="flowed"
Content-Language: en-US
Content-Transfer-Encoding: quoted-printable
X-Provags-ID: V03:K1:SopL6c0HUESWM7tXD645VN18QOoU/IKFayefXAL4+oA6p45hfrV yk4yM80akxQYtKT99R6UNlysRS9DU6l3wL+hUMTZoPBOi4gJlP2lXA3w4S65hT7GmAajlS1 AqWhkRsXupNlG5gyZZEKy5z4ErChLlXxSdAXohPyFvzvlAhSKAk6Jd+9GnEAsDVuL3zQ+U0 LdsQfaP2Y4aaIwHZcJvPw==
X-UI-Out-Filterresults: notjunk:1;V03:K0:Ml3EjYRPiR8=:iyWCPMZobIVZKR4O9VZKvT RTBUYLDnyL+V2VMEO43/KEZwe24WnanoJ+wel+in56UYoo1IbERAo9FxliFnKFnaiYMDfA/1m v/B27h+ZxBrZfCXlDDesAas0BNjeA+HfEsifkybd/f/zbVhsARd8JJ9W/o+Bwa7sbjhtS05/N GpL2CcHsmQYEEhzMSRdDZ8PPBnNH7WMDH9AxJYW9wAMd8tjcEy1qAcEWNuXC07hpoM5zP2zBI wZ2qcgbECLS9tX+7gW2FMR6P/wyYS5SyEHkQUYCuHaXjex8n65A/l7I1/KSzaqk0ps+c3VBQQ zWtMthSib6SRK3faAmiRpl91a5nECaQa5gJecaw2eGInguNQ0PtjqgmNTeyYK2B9sGHAQDz3k pzJIS4SUa1E2jlyrm/mFC261LFT2kxFZyfZSqMjSqI7/6dHWeLUWC7gaFVc6aR3PW9NysY8QW p89gbmVJ75YHv5DgmN6T7TOlHRg2qG1rYtrZxgDhHSifTbHj3Br7e2noiNXLf9k/tGmhWHEip TYKNu+/Nj97naFEnd0WKJ5U0zJeFZhm48vPjs7QznZ4SjqQOOBhvHaiuKTbpHF4daEcTPD6KF iDqItzrbeETwVd+PFERioJ6+QYDdxNYxx1PYCltBtSBp7pt67v7wV7ihA81CbHbOQRE1lsVpb uJxl7Qwadq9VloPbXv+sDg3wwf/Npgg+Irun+1FsIIc3LOhe1v2nJykzymSRJ+aHevTXcP5B0 iRpCcxqKvrUKaB3USNGsiY0IXmjIMoPeN+FP5mK7EdfPdj8iqsrILwtU9k+2Oqg1lpcDApMUw rPLcx/lsYGMuCOpy/1CVBFpAxG1xjcGJBVK3NRkbUrdbHbQdHnAyFiFxGC4YvmZklUfxAQO+E Ow5O7KTNCUfT0DAI9aq6qn6ZbWSJEh+6HPgh0YqQyXdVBprWkvHvABy30D5AUywzQ7g263SRx 3/cKSdtddQfHh3QDKagcrUO/RKgnMZveygvysg4IPaCtq2k8M+lS/BRBNnX1/hZNevwVILm2k K1iSjAONLVFMdisWfOpJJtlxcwIe80TTla3sEZuKBjTZ1ORPXIr+K8kvGMaYtjxsvOTjViuHU xb4CvqVaKi4bblqsUHxiweK24bM5aYGOd/sg/5YBcME/1OK6kSnK9FHaw0+UaQGpFSD8ZylYM V2pdTglEsNc0PSXyif1MaWCvwye2icUG8KI7zmMse54Y5t17G5hNI20vaMSzsQuXS21nseSMG 8RJXLS/DPNdhY2SFXYEYkvBnJXwSk6okQPLqbmOWWwcNzqOiffPrm1YAwrcI=
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc-dev/Z8L1FY9xfLEEz_klLNFifNVcrho>
Subject: Re: [xml2rfc-dev] https://tools.ietf.org/html/draft-levkowetz-xml2rfc-v3-implementation-notes-09#section-3.1.20
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: Tue, 29 Oct 2019 21:08:21 -0000

On 29.10.2019 21:59, Henrik Levkowetz wrote:
>
>
>>> On Oct 29, 2019, at 11:09 AM, Julian Reschke <julian.reschke@gmx.de> wrote:
>>>
>>> ...see also
>>> <https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/pull/107>, which
>>> I believe is misguided.
>>>
>>>
>>>> 3.1.20.  In Section 2.46.2, "numbered" Attribute
>>>>
>>>>    The text indicates that only top-level sections may have
>>>>    numbered="false", and that a section with numbered="false" may not
>>>>    have a child section with numbered="true".  But that leaves no value
>>>>    that is valid for child sections of an unnumbered section: They
>>>>    cannot have numbered="false", since they are not top-level sections,
>>>>    and they cannot have numbered="true", since the parent has
>>>>    numbered="false".
>>>
>>> That is correct, but very easy to fix by saying that numbering is
>>> inherited from the parent section.
>>>
>>>>    Additionally, the prohibition against child sections having
>>>>    numbered="false" removes the option of truncating the ToC listing for
>>>>    some child sections; without providing a good explanation for this
>>>>    limitation, it seems arbitrary and counter-intuitive to disallow this
>>>>    feature.
>>>
>>> That doesn't make any sense - the presence in the ToC does not depend on
>>> numbering at all. To control the ToC, we already have
>>> <https://greenbytes.de/tech/webdav/rfc7991.html#element.section.attribute.toc>.
>>>
>>>>    Proposal:  Permit sections which are not top-level sections to have
>>>>       numbered="false".
>>>>
>>>>    Implementation:  In The current version of xml2rfc, child sections
>>>>       may have numbered="false".
>>>
>>> Limiting this to top-level sections was very intentional; the reasons
>>> given above are IMHO not sufficient at all for this change.
>>>
>>> Heather, by any means, please undo this change for now.
>
> Prohibiting numbered="false" in a child of a section with numbering="false"
> does not provide any feature or any gain, but will make life harder on
> authors.

Nobody proposed that. You might be misreading what I said. When I said
"limiting this" I was referring to the feature of having control only
over top-level section numbering. That doesn't mean you couldn't set
numbered="false" on a child section of an unnumbered section; it just
would not be needed.

>  ...

Best regards, Julian