DFDL V1 Draft 039 is available
All DFDL V1 draft 038 is available at https://forge.gridforum.org/sf/docman/do/downloadDocument/projects.dfdl-wg/d... There have again been many changes listed below including many editorial updates to make the specification more readable. The DFDL expression language and DFDL regular expression language sections have been moved towards the end as they are for more advanced users. All highlighted changes are for the changes made in this draft only and do not include changes made in previous drafts. Unfortunately I have had significant problems with MS Word crashes while creating this draft which have resulted the formatting going haywire in some places. I have corrected the major problems but many minor ones still exist. In particular all the cross references have lost the number of the section they reference. This will be fixed in the next draft. Please send comments to me by March 3rd Latest entry at the top please Version Author/ Contributor History Date(yyyy-mm-dd) 039 Alan Powell Added numberPattern section. Added defaulting of complex types Changed missingValueInitiatorPolicy to 'required' and 'prohibited' Changed separatorPolicy to 'required' 'supressed' 'supressedAtEnd' Added defaulting choices. Many editorial changes Added lengthKind delimited for 'binary' 'packed/bcd' Clarified empty sequqnce wording Reworded infoset round tripping. Moved DFDL Expression and regular expression section to near back os spec. Added treatment of unrepresentable characaters to infoset section. Clatified relative path expressions on global declarations. Representation assumed to be text for string and binary for hexBinary Change alignment to be 1 based. docmentFinalTerninatorCanBeMissing and docmentFinalSeparatorCanBeMissing change to dfdl:format only Added UPA checks Added Ambiguity checks Removed defineTextNumberFormat, TextNumberFormat and textNumberFormatRef and moved properties in line Revised 'Resolving points of uncertainty' and discriminators Clarified Nan and infinity values 2010-02-24 Regards Alan Powell Development - MQSeries, Message Broker, ESB IBM Software Group, Application and Integration Middleware Software ------------------------------------------------------------------------------------------------------------------------------------------- IBM MP211, Hursley Park Hursley, SO21 2JN United Kingdom Phone: +44-1962-815073 e-mail: alan_powell@uk.ibm.com Unless stated otherwise above: IBM United Kingdom Limited - Registered in England and Wales with number 741598. Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU
Alan I've marked up a hard copy of draft 039 and will drop it round. The review has highlighted a couple of issues that need resolving by the WG on this week's call. 1) Name of property dfdl:textNumberRepresentation is not consistent with dfdl:binaryNumberRep, dfdl:binaryFloatRep, etc. 2) The dfdl:numberPattern etc properties that have been moved from the defunct dfdl:textNumberFormat annotation to dfdl:element etc should be called dfdl:textNumberPattern etc. Otherwise users will think they apply to binary numbers too. 3) In section 14.3 on sequences, there are several sub-sections that talk about parsing according to different ways of specifying length (ie, lengthKind). But dfdl:sequence no longer carries dfdl:lengthKind so I think these sub-sections are not in the right place. I think they should be in section 12, under the correct 12.3.x lengthKind sub-section. 4) Section 19 on built-in specifications. Given that we don't have any for public comment phase we should reword this section. We also need to make sure we have done a mailing list final call for input. I also have the opportunity to update the OGF 28 session description before the printed program is finalised. The original session description assumed we would be in Public Comment phase so the WG needs to agree on some adjusted wording that reflects the slippage, which we should do on this week's call. Regards Steve Hanson Programming Model Architect, WebSphere Message Broker, Co-Chair, OGF DFDL WG Hursley, UK, Internet: smh@uk.ibm.com, Phone (+44)/(0) 1962-815848 From: Alan Powell/UK/IBM@IBMGB To: dfdl-wg@ogf.org Date: 24/02/2010 17:22 Subject: [DFDL-WG] DFDL V1 Draft 039 is available Sent by: dfdl-wg-bounces@ogf.org All DFDL V1 draft 038 is available at https://forge.gridforum.org/sf/docman/do/downloadDocument/projects.dfdl-wg/d... There have again been many changes listed below including many editorial updates to make the specification more readable. The DFDL expression language and DFDL regular expression language sections have been moved towards the end as they are for more advanced users. All highlighted changes are for the changes made in this draft only and do not include changes made in previous drafts. Unfortunately I have had significant problems with MS Word crashes while creating this draft which have resulted the formatting going haywire in some places. I have corrected the major problems but many minor ones still exist. In particular all the cross references have lost the number of the section they reference. This will be fixed in the next draft. Please send comments to me by March 3rd Latest entry at the top please Version Author/ Contributor History Date(yyyy-mm-dd) 039 Alan Powell Added numberPattern section. Added defaulting of complex types Changed missingValueInitiatorPolicy to 'required' and 'prohibited' Changed separatorPolicy to 'required' 'supressed' 'supressedAtEnd' Added defaulting choices. Many editorial changes Added lengthKind delimited for 'binary' 'packed/bcd' Clarified empty sequqnce wording Reworded infoset round tripping. Moved DFDL Expression and regular expression section to near back os spec. Added treatment of unrepresentable characaters to infoset section. Clatified relative path expressions on global declarations. Representation assumed to be text for string and binary for hexBinary Change alignment to be 1 based. docmentFinalTerninatorCanBeMissing and docmentFinalSeparatorCanBeMissing change to dfdl:format only Added UPA checks Added Ambiguity checks Removed defineTextNumberFormat, TextNumberFormat and textNumberFormatRef and moved properties in line Revised 'Resolving points of uncertainty' and discriminators Clarified Nan and infinity values 2010-02-24 Regards Alan Powell Development - MQSeries, Message Broker, ESB IBM Software Group, Application and Integration Middleware Software ------------------------------------------------------------------------------------------------------------------------------------------- IBM MP211, Hursley Park Hursley, SO21 2JN United Kingdom Phone: +44-1962-815073 e-mail: alan_powell@uk.ibm.com Unless stated otherwise above: IBM United Kingdom Limited - Registered in England and Wales with number 741598. Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU -- dfdl-wg mailing list dfdl-wg@ogf.org http://www.ogf.org/mailman/listinfo/dfdl-wg Unless stated otherwise above: IBM United Kingdom Limited - Registered in England and Wales with number 741598. Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU
Some comments. I am unable to make this week's call, but here is my feedback on these items.
1) Name of property dfdl:textNumberRepresentation is not consistent with dfdl:binaryNumber*Rep*, dfdl:binaryFloat*Rep*, etc.
I vote for "Rep" not "Representation" uniformly. It's just too long a word makes all the example word-wrap badly, the property tables all look yucky, etc.
2) The dfdl:numberPattern etc properties that have been moved from the defunct dfdl:textNumberFormat annotation to dfdl:element etc should be called dfdl:*text*NumberPattern etc. Otherwise users will think they apply to binary numbers too.
Agreed.
3) In section 14.3 on sequences, there are several sub-sections that talk about parsing according to different ways of specifying length (ie, lengthKind). But dfdl:sequence no longer carries dfdl:lengthKind so I think these sub-sections are not in the right place. I think they should be in section 12, under the correct 12.3.x lengthKind sub-section.
I had the action to revisit sequences w.r.t. the grammar stuff. I moved these sections you mention around in a revision I sent to Alan yesterday. I put them up into the general length discussion. ...mikeb
participants (3)
-
Alan Powell -
Mike Beckerle -
Steve Hanson