W3C home > Mailing lists > Public > public-forms@w3.org > July 2011

Re: Updated XPath Expression module

From: Nick Van den Bleeken <Nick.Van.den.Bleeken@inventivegroup.com>
Date: Fri, 1 Jul 2011 07:25:39 +0000
To: John Boyer <boyerj@ca.ibm.com>
CC: Public Forms <public-forms@w3.org>
Message-ID: <BD34105A-44B6-48B4-8F28-27E7F8AFA835@inventivegroup.com>
Hi John,

This module is indeed generated from Spec XML.

I Updated the text, but shouldn't we recommend an XPath 2.0 engine if one is available to maximize compatibility between.

(My mail client messed up and send the previous e-mail 4-times, lets hope it was a temporary hick-up)

Kind regards,

Nick Van den Bleeken
R&D Manager

Phone: +32 3 821 01 70
Office fax: +32 3 821 01 71
nick.van.den.bleeken@inventivegroup.com<mailto:nick.van.den.bleeken@inventivegroup.com>
www.inventivedesigners.com


[cid:image001.png@01CBF2F8.1DA19110][cid:image002.png@01CBF2F8.1DA19110][cid:image003.png@01CBF2F8.1DA19110]

On 30 Jun 2011, at 23:34, John Boyer wrote:

Hi Nick,

I would've made the suggested changes below on the wiki, but it actually looks like this this module is being done with spec xml?

Wording looks good overall.

I'd recommend getting rid of the "note" aspect and just make this another paragraph.  Some readers of W3C specs (not equal to me) have interpreted notes as informative rather than normative, whereas we're using the word "may" to indicate a legitimate implementation option.

Second, I'd recommend the sentence be rearranged a bit to enable you to change from "engine" to "implementation" and also to formally specref XPath 1.0 and XPath 2.0 in the sentence as you go.  Like this:

If XPath 1.0 compatibility mode is requesed, an XForms processor may use either an XPath 1.0 implementation [XPath 1.0] or an XPath 2.0 implementaiton in XPath 1.0 compatibility mode [XPath 2.0].

Then your following sentence that starts "Be aware that some expressions..." could instead just start as "Some expressions...".  It is tempting to make that sentence a note, but best not to because your final sentence says something normative again, namely that exceptions can happen.

Cheers,
John M. Boyer, Ph.D.
Distinguished Engineer, IBM Forms and Smarter Web Applications
IBM Canada Software Lab, Victoria
E-Mail: boyerj@ca.ibm.com<mailto:boyerj@ca.ibm.com>

Blog: http://www.ibm.com/developerworks/blogs/page/JohnBoyer
Blog RSS feed: http://www.ibm.com/developerworks/blogs/rss/JohnBoyer?flavor=rssdw





From:        Nick Van den Bleeken <Nick.Van.den.Bleeken@inventivegroup.com<mailto:Nick.Van.den.Bleeken@inventivegroup.com>>
To:        Public Forms <public-forms@w3.org<mailto:public-forms@w3.org>>
Date:        06/30/2011 01:18 PM
Subject:        Updated XPath Expression module
Sent by:        public-forms-request@w3.org<mailto:public-forms-request@w3.org>
________________________________



All,

I updated the XPath expression module.

I added the node creation functions to the module and added the follwing note to the xpath-version attribute:

Note:

If an XForm processor has no access to an XPath 2.0 engine, an XPath 1.0 engine may be used if XPath 1.0 compatibility mode is requested. Be aware that some expressions can't be executed with an XPath 1.0 engine and that some functions defined in [Functions and Operators] may be missing if an XPath 1.0 engine is used. If the XPath 1.0 engine can't evaluate the expression an xforms-compute-exception<http://www.w3.org/TR/xforms11/#evt-computeException>XF or an xforms-binding-exception<http://www.w3.org/TR/xforms11/#evt-bindingException>XF will be dispatched.


The full version is available at [1] and a diff marked version is available at [2]

Comments are welcome.

Kind regards,

Nick Van den Bleeken
R&D Manager

Phone: +32 3 821 01 70
Office fax: +32 3 821 01 71
nick.van.den.bleeken@inventivegroup.com<mailto:nick.van.den.bleeken@inventivegroup.com>
www.inventivedesigners.com<http://www.inventivedesigners.com/>


1: http://www.w3.org/MarkUp/Forms/specs/XForms1.2/modules/xpath20/index-all-20110630.html
2: http://www.w3.org/2007/10/htmldiff?doc1=http://www.w3.org/MarkUp/Forms/specs/XForms1.2/modules/xpath20/index-all-20110621.html&doc2=http://www.w3.org/MarkUp/Forms/specs/XForms1.2/modules/xpath20/index-all-20110630.html


________________________________

Inventive Designers' Email Disclaimer:
http://www.inventivedesigners.com/email-disclaimer

--
This message has been scanned for viruses and
dangerous content by MailScanner<http://www.mailscanner.info/>, and is
believed to be clean.


________________________________

Inventive Designers' Email Disclaimer:
http://www.inventivedesigners.com/email-disclaimer



image001.png
(image/png attachment: image001.png)

image002.png
(image/png attachment: image002.png)

image003.png
(image/png attachment: image003.png)

Received on Friday, 1 July 2011 07:26:05 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 1 October 2013 22:06:55 UTC