[xml2rfc] Split expansion of <u> elements

Julian Reschke <julian.reschke@gmx.de> Mon, 15 July 2019 13:04 UTC

Return-Path: <julian.reschke@gmx.de>
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 A0DF712008B for <xml2rfc@ietfa.amsl.com>; Mon, 15 Jul 2019 06:04:47 -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 jVIZfPOi9rO6 for <xml2rfc@ietfa.amsl.com>; Mon, 15 Jul 2019 06:04:45 -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 376CF12004C for <xml2rfc@ietf.org>; Mon, 15 Jul 2019 06:04:45 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1563195877; bh=PxL7AAS3j/c4ajW2Ioh3dPpPI9mbKYq8C/stY+2sXbE=; h=X-UI-Sender-Class:To:From:Subject:Date; b=GJ6/dBQPL8iIk3fKidZJgT3ASd22cXuTWCtxEYN4NPGKT6VMnTpmMY4Hy8M5m3i6s uX1DP9DFO92a0GXzkGgHNvVQkIqhGXUI+bsvlh5crYFB8tpW8kskH+UsRJkHaCMhud zvFKQbeL1OXkfQc3/mu1EJwn5NtJpifoAZ72cs1s=
X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c
Received: from [192.168.1.34] ([217.91.35.233]) by mail.gmx.com (mrgmx104 [212.227.17.168]) with ESMTPSA (Nemesis) id 1Mk0JM-1iBImT2q3k-00kMWg for <xml2rfc@ietf.org>; Mon, 15 Jul 2019 15:04:37 +0200
To: "xml2rfc@ietf.org" <xml2rfc@ietf.org>
From: Julian Reschke <julian.reschke@gmx.de>
Message-ID: <10385dd4-4eff-0db7-df4e-377d535c7b87@gmx.de>
Date: Mon, 15 Jul 2019 15:04:36 +0200
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101 Thunderbird/60.8.0
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"; format="flowed"
Content-Language: en-US
Content-Transfer-Encoding: quoted-printable
X-Provags-ID: V03:K1:iWWT4fVJ03JbmgkFu300fOL62UYdHVC6tPuetNE3PffMwDZtuSU ZZSC9p2v832eixK0OpGOE8wija5zM+90P1GZsXXE8CsAfDPEUVs/h1VuOcdq7SvLq4Y7ZvJ Y+Xkdg1OgvODlm19iBYBdZFLPyWmi86eJlcsFwwOPv6wYD9WAnSnmdL3sVTLlZQU/EZ3Dv2 N7weCaBZ8tjmRAYgpuN6A==
X-UI-Out-Filterresults: notjunk:1;V03:K0:V+PQw5y6C5w=:It+nMm/PppYrSp4GyS9t6J Q3dKcM9nwk8yrsYoMzZ8biS9bx+Z8ZwJ8hb2BHX5QPnQs+xLE/Ay7amKPsISx27H8J/ucUQCJ 7K0IDaIe2UZ7WaPteOnTmfqBHb0PrAQM/p1BQqhExn7z7lUm7aTQ33lgsppGFmEc57JFWoc56 LM8RaG17Pj9BrveULDTW82MtkFFosJ+kQlhylhheZsmUINcRa7jGeovvh/Ou6NCXRga6olT3H TzWs61n/wLoMD8k12W5QtH4utkrjd2eyiOrk6zynMyq53tCqSCmBVhDDQ0czlANgzPV8q0isg /7C6PPNwkViI9Jy5ppM3y5J3oz1CXxcCoRiKKfgodokpqyDd/9SqRkzfzk5xQQwZn2dG7qAq5 STft6nD33zHasNaRJlszdzs0jn2BASYiZwWzMEJrwSfVWQJexiXc7S60+fp9zBcLyXaLthgKN kTbTQaf9RmG/242H/Esf310cFY5YKftWvw+farmPY3n3YWCtqSKmj+elwLvBgrqBi5//iXkNp hG4APdlmHRhY49pbAKDKxda79exFyYkAX9GsbxsdI/pqxgaC6t9kWQOV7gG8lD1iRwPAXG8Ci ZRodJ959pDdcvM5S1bsyhMjt+lO6An5twQXHi9DOloWoyHDF/83qMBJnVUV0gR+jSVZzXVEEE G8tNg+i3GMZssvJHjd6buNM+iVByoU/miUkALUp020jB9jI1fxKyH/XZG6ozGgLXMIx3+3cyP TVNR047AXiasR9oVHj1YEeg+DsfCdI4f5dPpl9+BRS8wO+BywPECWLT7X6k8GHLHbfCrxOz0s Q8HufokiF3RvOC7yqMPDgnQSUJ42Hlk55O2QfuEnRkfFIVznRlNaWrTa2kJECm0fgjy9nStfS TivRy+7uSRtm+D6lDWxdBAaAWJyZVKTBSaADQPDXLla9DvBR62uABRG/Qv9qBdxAkVNUW2KXd C1isgKi7w9MLX6D3MuLRXmgh8weZ//z6u1gxkq7SDJKeZobME7F9bJ3tRzIbYZszXbTGJoJP+ 9L6u1cnPuISuJs60Sjp82jupwgDKJUuDTVJOXpvKOHUd7uydV7W97FK9RWkNKxQyfcbw/TwvQ euhYYnRSbp3igsprtd9Kx6VPoznPDfpNrp2
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc/dT_nSNngdaJkfs2PunTkcrdiFss>
Subject: [xml2rfc] Split expansion of <u> elements
X-BeenThere: xml2rfc@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: <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: Mon, 15 Jul 2019 13:04:48 -0000

<https://tools.ietf.org/html/draft-levkowetz-xml2rfc-v3-implementation-notes-09#appendix-A.1.3>:

>    There are cases which cannot be handled with either the simplified or
>    full <u> format specifications.  One is exemplified in Table 1 of the
>    CSS sample document at https://rfc-format.github.io/draft-iab-rfc-
>    css-bis/sample2-v2.html#s-3.  Rendering this with <u> elements
>    requires that the non-ascii content be rendered in one place (a table
>    cell in one column) while the expansion is rendered in another cell
>    in a different column.  Provision for this has been made by modifying
>    the expansion of <u> when it is referenced by an <xref>.  This table,
>    with <u> elements referenced by <xref> instances:

I agree that there's a problem here to be solved, but I'm a bit unhappy
with the proposed solution.

Quoting:

>        <tr>
>          <td>5</td>
>          <td>
>             &lt;
>             <u format="name-num" anchor="greek-upper-sigma">Σ</u>
>             &gt;
>          </td>
>          <td> <xref target="greek-upper-sigma" /> </td>
>        </tr>

is converted to

>        +---+-------------+-----------------------------------------+
>        | 5 | <Σ>         | GREEK CAPITAL LETTER SIGMA (U+03A3)     |
>        +---+-------------+-----------------------------------------+


I think this violates the principle of least surprise, because the fact
that the element is target of an <xref> changes the rendering of the
element.

The following seems more natural to me:

 >        <tr>
 >          <td>5</td>
 >          <td>
 >             &lt;
 >             <u format="lit" anchor="greek-upper-sigma">Σ</u>
 >             &gt;
 >          </td>
 >          <td> <xref target="greek-upper-sigma" /> </td>
 >        </tr>

I would also argue that re-using <xref> complicates something that is
already complex enough. Maybe adding that functionality to <u> itself
would be better:


 >        <tr>
 >          <td>5</td>
 >          <td>
 >             &lt;
 >             <u format="lit" anchor="greek-upper-sigma">Σ</u>
 >             &gt;
 >          </td>
 >          <td> <u target="greek-upper-sigma" format="name-num" /> </td>
 >        </tr>

(it also puts the format attribute in the place it belongs to)

In any case, please by all means consider the feedback about the
rendering of <u> now being dependant on whether it is a link target or not.

Best regards, Julian