From nobody Fri Jan 23 01:02:05 2015
Return-Path: <dev+ietf@seantek.com>
X-Original-To: media-types@ietfa.amsl.com
Delivered-To: media-types@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 74AA71A1A25; Fri, 23 Jan 2015 01:02:04 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.601
X-Spam-Level: 
X-Spam-Status: No, score=-2.601 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_PASS=-0.001] autolearn=ham
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 mlOeVaUCEWSP; Fri, 23 Jan 2015 01:02:01 -0800 (PST)
Received: from mxout-07.mxes.net (mxout-07.mxes.net [216.86.168.182]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 431AE1A00ED; Fri, 23 Jan 2015 01:02:01 -0800 (PST)
Received: from [192.168.123.7] (unknown [23.241.1.22]) (using TLSv1.2 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by smtp.mxes.net (Postfix) with ESMTPSA id BED4322E268; Fri, 23 Jan 2015 04:01:59 -0500 (EST)
Message-ID: <54C20E06.50104@seantek.com>
Date: Fri, 23 Jan 2015 01:01:58 -0800
From: Sean Leonard <dev+ietf@seantek.com>
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:31.0) Gecko/20100101 Thunderbird/31.4.0
MIME-Version: 1.0
To: "rfc-interest@rfc-editor.org" <rfc-interest@rfc-editor.org>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 8bit
Archived-At: <http://mailarchive.ietf.org/arch/msg/media-types/IKfY03MjDJ3NKCMK6Bg-TWIa65A>
Cc: media-types@ietf.org, "urn@ietf.org" <urn@ietf.org>
Subject: [media-types] v3imp #1 Control over spacing and line-breaking
X-BeenThere: media-types@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: "IANA mailing list for reviewing Media Type \(MIME Type, Content Type\) registration requests." <media-types.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/media-types>, <mailto:media-types-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/media-types/>
List-Post: <mailto:media-types@ietf.org>
List-Help: <mailto:media-types-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/media-types>, <mailto:media-types-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 23 Jan 2015 09:02:04 -0000

[this is to rfc-interest@, as well as to media-types@ and urn@, due to 
the need for <br> in registration templates in the xml2rfc v3 vocabulary]
Improvement Need
#1 Control over spacing and line-breaking

This improvement calls for greater control over spacing and 
line-breaking in the spec-text. This includes being able to preserve 
exact spacing {@xml:space="preserve" or equivalents}, and setting 
arbitrary non-paragraph separating line breaks <br>. Furthermore, the 
vocabulary needs to be able to identify places where line breaks are 
prohibited {<nobr> equivalent} or optionally allowed {<wbr> or equivalent}.

I note that <br> has been adopted in the vocabulary, which is a good 
thing. However, it seems to be limited to tables. It should be allowed 
in <t> elements, as well as possibly in other places where unstructured 
text is permitted. My main request is in <t> elements, however.

Extensive examples of the need are in draft-josefsson-pkix-textual (see 
draft-josefsson-pkix-textual-10 txt and pdf), which has been approved by 
the IESG for RFC publication. Further examples are in I-Ds and RFCs that 
include registration templates, including 
draft-ietf-appsawg-text-markdown-05 (media type registrations) and URN 
registrations of all kinds.

In pkix-textual, there are protocol elements that are mentioned in the 
spec-text ("text") where spacing and line-breaking are *absolutely 
critical, non-negotiable properties* of the textual productions. 
Furthermore, the text takes pains not to invent new and unnecssary terms 
out of whole cloth. Thus there are productions "-----BEGIN ", "-----END 
", "-----", etc. that need to be kept exactly as-is, with no line breaks 
between any hyphens, and exactly one space between the "BEGIN" and "END" 
characters and the end of the string.

I made heroic efforts to use existing xml2rfc tools to make these things 
work out, to no avail. Ultimately I gave up and modified the xml2rfc 
source myself to support various existing semi-documented (e.g., <spanx 
xml:space="preserve">) and novel commands.

The use of NSBP (NON-BREAKING SPACE) and NBHY (NON-BREAKING HYPHEN) 
Unicode characters are inappropriate. The repertoire of these protocol 
elements is US-ASCII; if someone copied and pasted the "-----" and " " 
characters out of the (PDF or XML) document, they would get the 
incorrect code points. Furthermore, xml2rfc had a stubborn tendency to 
strip off whitespace characters from the ends of plain text XML fragments.

Authors know what they are doing, and if a protocol or an in-text 
discussion requires exactly one space, two spaces, ten spaces with 
hyphens, Unicode EM spaces or figure dashes or ideographic spaces or 
what-have-you, it is the author's choice to use those characters. The 
vocabulary really cannot prohibit these things at a technical level.

Regarding line breaks: I now have a lot more experience filling out 
registration templates. Many registration templates use line breaks to 
separate field names from field values, such as the RFC 6838-mandated text:

    Additional information:

      Deprecated alias names for this type:
      Magic number(s):
      File extension(s):
      Macintosh file type code(s):


Stuffing the entire registration template in a <figure><artwork> is 
absurd and borders on actually being insulting. When over 50% of the RFC 
is ensconced in a single figure, you know you have a problem. Templates 
such as media type and URN registrations are "structured spec-text", 
i.e., specification text intended for humans to read that is broken up 
in a regularized way. Whether a <br> or a new paragraph is appropriate 
depends on context; the editorial process can sort this out.

Note that if you allow authors to preserve spacing and linebreaks, e.g., 
with @xml:space="preserve" or an equivalent, the author can always stuff 
a CRLF into the space-preserved text. So if you're going to allow one, 
you may as well allow the other one.

What ended up happening with a lot of these drafts, such as the xmlns 
and rdf URN registration and the text/markdown media type registration, 
is that I gave up on xml2rfc entirely and authored them in nroff. I 
encourge other authors to revolt similarly until <br> and other 
appropriate constructs are in the v3 vocabulary.

Because white-space controls can be a fundamental property of certain 
kinds of text, I encourage an attribute @white-space to apply to all 
text-containing elements, with similar values to CSS 
<http://www.w3.org/TR/CSS21/text.html#white-space-prop>: {normal}, 
{pre}, {nowrap}, {pre-wrap}, and {pre-line}.

Nevertheless, I would be satisfied if white-space controls are limited 
to certain elements, such as the elements discussed in Improvement #3 
(forthcoming). I would be partially satisfied if white-space controls 
are limited to two options: "default" ≈ "normal" and "preserve" ≈ "pre" 
(which roughly correspond to the values of xml:space).

Sean


From nobody Fri Jan 23 01:28:30 2015
Return-Path: <julian.reschke@gmx.de>
X-Original-To: media-types@ietfa.amsl.com
Delivered-To: media-types@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id EE68D1A020D; Fri, 23 Jan 2015 01:28:28 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.9
X-Spam-Level: 
X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-0.001] autolearn=ham
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 qF81OLzZs3Mv; Fri, 23 Jan 2015 01:28:27 -0800 (PST)
Received: from mout.gmx.net (mout.gmx.net [212.227.17.21]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 6E5D01A01D8; Fri, 23 Jan 2015 01:28:27 -0800 (PST)
Received: from [192.168.1.194] ([217.91.35.233]) by mail.gmx.com (mrgmx103) with ESMTPSA (Nemesis) id 0Mhhr5-1Y1AY92xd5-00MpdU; Fri, 23 Jan 2015 10:28:22 +0100
Message-ID: <54C2142A.1000303@gmx.de>
Date: Fri, 23 Jan 2015 10:28:10 +0100
From: Julian Reschke <julian.reschke@gmx.de>
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:31.0) Gecko/20100101 Thunderbird/31.4.0
MIME-Version: 1.0
To: Sean Leonard <dev+ietf@seantek.com>,  "rfc-interest@rfc-editor.org" <rfc-interest@rfc-editor.org>
References: <54C20E06.50104@seantek.com>
In-Reply-To: <54C20E06.50104@seantek.com>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit
X-Provags-ID: V03:K0:KibYXqRAxyC67yYn4UG732fG68sPDaQGXXFHeW92dS0deqxO1Vf Llu7InTHZAr6fHc5KiqR+tdwqWUv1bNkPYooJ4nR0W3viP8h+fDpKYqvvANsTLEThh9Orj3 wCoIX5t3P4d2o8ZASgBsbXycafBf4iSmh56jyG3rrJTxhS8wEsfamqUTgE4ExW/W45wIuIq thDUrfZ356RhzNll8yNng==
X-UI-Out-Filterresults: notjunk:1;
Archived-At: <http://mailarchive.ietf.org/arch/msg/media-types/N5FiBqfXXo7JA-3zgxpgaWEbbCs>
Cc: media-types@ietf.org, "urn@ietf.org" <urn@ietf.org>
Subject: Re: [media-types] v3imp #1 Control over spacing and line-breaking
X-BeenThere: media-types@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: "IANA mailing list for reviewing Media Type \(MIME Type, Content Type\) registration requests." <media-types.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/media-types>, <mailto:media-types-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/media-types/>
List-Post: <mailto:media-types@ietf.org>
List-Help: <mailto:media-types-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/media-types>, <mailto:media-types-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 23 Jan 2015 09:28:29 -0000

On 2015-01-23 10:01, Sean Leonard wrote:
> ...
> Extensive examples of the need are in draft-josefsson-pkix-textual (see
> draft-josefsson-pkix-textual-10 txt and pdf), which has been approved by
> the IESG for RFC publication. Further examples are in I-Ds and RFCs that
> include registration templates, including
> draft-ietf-appsawg-text-markdown-05 (media type registrations) and URN
> registrations of all kinds.
> ...

I'll comment just on the registration templates things right now.

There is no problem. There's no need to reproduce the template exactly. 
I have authored multiple RFCs that included media type registrations, 
and it just never has been a problem.

Best regards, Julian