[xml2rfc-dev] feedback on <stream>

Julian Reschke <julian.reschke@gmx.de> Fri, 17 May 2019 14:35 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 1A2EA120103 for <xml2rfc-dev@ietfa.amsl.com>; Fri, 17 May 2019 07:35:40 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.6
X-Spam-Level:
X-Spam-Status: No, score=-2.6 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_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 NTtJA46EA3rk for <xml2rfc-dev@ietfa.amsl.com>; Fri, 17 May 2019 07:35:38 -0700 (PDT)
Received: from mout.gmx.net (mout.gmx.net [212.227.17.21]) (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 AC23E12008D for <xml2rfc-dev@ietf.org>; Fri, 17 May 2019 07:35:37 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1558103734; bh=7zYLIvuEIy/cPUjH7+R45p1Vuf0YmPlls5Jftsiidkg=; h=X-UI-Sender-Class:To:From:Subject:Cc:Date; b=iymfkvMHXw9pNQN+hMZ0X38BSXRSAmwUunu5B5c9IsisD2Fiow3blHGwOVyWu2fYk VZqLnDbXynXdx+cNhPjaqInhAm5ymC1N14U1hJgjleYXG5rbGtXF9iyS8Wb5DJQBDD G36EI85y7ZeoK4lunKi/EpwIB8v4LMB4/xsua45o=
X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c
Received: from [192.168.1.34] ([217.91.35.233]) by mail.gmx.com (mrgmx101 [212.227.17.168]) with ESMTPSA (Nemesis) id 0LaKaw-1gxIHA1zmY-00m1Ob; Fri, 17 May 2019 16:35:34 +0200
To: XML Developer List <xml2rfc-dev@ietf.org>
From: Julian Reschke <julian.reschke@gmx.de>
Message-ID: <f688c9ee-8059-65d8-4bfd-4a0e3a1bbb79@gmx.de>
Date: Fri, 17 May 2019 16:35:33 +0200
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101 Thunderbird/60.6.1
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:tsiyuwqcZXJ+c45wPPRunCVcZdPaZ2lGYRhCWBVpive2DfH7csJ feRiBOCROQUtoWR1gqjCgYo5Embzb0PSJigqLOAoXOOx5z71f0XY6ReM05ZSdFYdGNSQgRW jJKCi/KvXYTyl4ehxqC8K1zySDWZXmkeXUt0kyMkXU3B3yPKCnVfWxyXuDi50eT83R9jpqJ GcXjRA2b+LbsGReicMyyg==
X-UI-Out-Filterresults: notjunk:1;V03:K0:yKKP4nRlmWU=:U6TbbvVYniQ5qu7b99B7p6 hlT44QLzfmTB8Zow7Z53GcLdd6KnHYSCMQUc8yjVWC7X5JfYe5jICLriDKFMgz3QrvxDSTqlp aFM2QJVBWhwsnMxHLg4GJBZ3NBKihBUtp79kcHK9hUhRhIxlvpApm8cxHLr0agNAwcn/27khi QFZhvHiouowT9Cs55HE6ji4+ehq0vOXOp9q6T7FbeT6NmU8iCL9Motg7mdIDjpE1LsdqihycA gJBbPp71UgGQzA/lKG7i6LRLbRK/uXyirVqQagdT88XHy15kN+cCui0JvInJ/YNyI2XVcgt27 DGClZR+t4i8fiuk9RXcxff/ZV3agniG3qZc8amqcKMmZZDEoK97HSgrsNApNxqNM9tgNKxTTc PQpXDCFxCW85ixEuc4RwziLHnujGovAmOTAEChatMNjm7gDIJJyn1SWBSLZib4WdysPnLz2ZX spq4xvBH4OpHTYLgJyheBhJOVGT/iZE6npYgG1qzefJw6CEDDTmna6ci3iC5G+KmGVdFQ+6cZ bRxeGgQxYt7amAfTPYEBJj2T2XZsPRn4KpKkcny6USfJGlH2+lSVtJPnLM4a00gT/g/hgn06Q 0ZqdB08hvu41Tfu+S33czx5MSFsBjWjn/3uUOP+fZDAqyohAdNrCUqOc4M2Lkl3umi/THMtR9 n72lCKkgtEABJLDTLm4EedYHgmZFUFJuA6PgkY5is0O9xwqTbaIVOoQHk9Afqya7FwQeg+TJq kG0VGh1hh5MhYL2JjKIfYooySnIvbmg8v+RoEmJEvwHw9DF2pvLFp/O0LH4CafuzArhxKW0I2 bOQwr+5IiXcU4MRJygwoFUTjAMTPfY3mOWpTBfIMCQ3Bqpq9mImYN8Jv9ZlE5jke9Us9Kkc6C X2emiOkXA2uMTQr7uHap6TZO+pjV7VYIrsYWUpuU4qLUzW/5cm8X1X/H4ABNmEdshePdX5hSL c1WjE0m5ZZxcDUTay6+1DA8TtzWrTxkl+p24TMIXlwQ2cFuadPUby
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc-dev/gvqYSRnGSjSkhp_UIM4xfnkS1_M>
Subject: [xml2rfc-dev] feedback on <stream>
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: Fri, 17 May 2019 14:35:40 -0000

Hi there,

so I stumbled across the element <stream>, used in the test file
elements.xml (in the svn repo).

Source:

> 	 <reference anchor="RFC7997" target="https://www.rfc-editor.org/info/rfc7997" quote-title="true">
> 	    <stream>IAB</stream>
> 	    <front>
> 	       <title>The Use of Non-ASCII Characters in RFCs</title>
> 	       <author fullname="Heather Flanagan" role="editor">
> 		  <organization/>
> 	       </author>
> 	       <date year="2016" month="December"/>
> ... > 	    </front>
> 	    <seriesInfo name="RFC" value="7997"/>
> 	    <seriesInfo name="DOI" value="10.17487/RFC7997"/>
> 	 </reference>

The text output is:

>    [RFC7997]  Flanagan, H., Ed., "The Use of Non-ASCII Characters in
>               RFCs", IAB, RFC 7997, DOI 10.17487/RFC7997, December 2016,
>               <https://www.rfc-editor.org/info/rfc7997>.

Removing it yields:

>    [RFC7997]  Flanagan, H., Ed., "The Use of Non-ASCII Characters in
>               RFCs", RFC 7997, DOI 10.17487/RFC7997, December 2016,
>               <https://www.rfc-editor.org/info/rfc7997>.

...so the contents is inserted between title and series information.

Question: is there an actual requirement for this? I checked the style
guide and related information and could not find anything.

*If* this is indeed needed, my preference would be to name/define the
element more general terms; not in a way totally specific to IETF documents.

Best regards, Julian