[rfc-i] [IAB] draft-hoffman-rfcexamples-04, "3. Example of a v3 Document"

jhildebr at cisco.com (Joe Hildebrand (jhildebr)) Tue, 01 March 2016 18:12 UTC

From: "jhildebr at cisco.com"
Date: Tue, 01 Mar 2016 18:12:34 +0000
Subject: [rfc-i] [IAB] draft-hoffman-rfcexamples-04, "3. Example of a v3 Document"
In-Reply-To: <56D3E2E7.2040405@gmx.de>
References: <56D1FB12.7000604@gmx.de> <B88E966E-01F6-423A-92E7-707DEFC90F9C@vpnc.org> <56D2212C.1040005@gmx.de> <ED732BC0-A1EE-4172-81F6-485961FF3DC4@att.com> <56D3E2E7.2040405@gmx.de>
Message-ID: <2FDB250F-A5EC-4B6F-9539-44F27B56305F@cisco.com>

Just expand all of the entity refs, and put the expansions in the v3.  This has to be done before any of the other translations, in case included entities generate old-style XML.

This is the only way to not lose information, and to make sure that all of the included bits have been translated.  If the document is too large at that point, the author can go back in and create x:includes as desired.

-- 
Joe Hildebrand







On 2/28/16, 11:19 PM, "IAB on behalf of Julian Reschke" <iab-bounces at iab.org on behalf of julian.reschke at gmx.de> wrote:

>On 2016-02-29 04:55, HANSEN, TONY L wrote:
>> I've looked at convertv2v3. The reference exists in the original v2 doc and is just preserved. That is, this is the entry in the v2 doc:
>>
>> <!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
>>     <!ENTITY RFC2119 SYSTEM
>>       "http://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.2119.xml">
>>     ]>
>>
>> All of the ENTITY references are pulled out and changed to x:includes. Then the remaining DOCTYPE was then just left alone, with no special checks as to what DTD was being referenced.
>>
>> I guess I can add some code to check for this special case and remove the DTD entirely if it's an rfc2629.dtd reference.
>
>Well, there are other cases that need to be considered. What would you map
>
><!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
>
>   <!-- re-declare "&nbsp;" as code point 160 (non-breaking space) -->
>   <!-- you may need this for UAs that do not read external DTDs -->
>   <!ENTITY nbsp
>   "&#160;">
>
>]>
>
>to?
>
>In general, how does the conversion treat Internal Entities defined in 
>the document to-be-converted? And how does it treat those defined by 
>rfc2629.dtd (and included files)?
>
>Best regards, Julian
>
>