W3C home > Mailing lists > Public > public-forms@w3.org > May 2012

Re: XForms expression module diff version

From: John Boyer <boyerj@ca.ibm.com>
Date: Thu, 24 May 2012 06:56:11 -0700
To: Nick Van den Bleeken <Nick.Van.den.Bleeken@inventivegroup.com>
Cc: Public Forms <public-forms@w3.org>
Message-ID: <OFCC03AF3A.422F6AAB-ON88257A08.004B73B2-88257A08.004C9088@ca.ibm.com>
This looks great, Nick.
It is a little hard to tell whether green versus yellow means change 
versus add (the norm for W3C) or whether green means add and yellow means 
change (the norm for normal people who relate the color to what has 
conceptually happened).
For example, the eval() and eval-in-context() shows up mostly green, but 
it is added content, not changed content.  Functions like parse and 
serialize are added, but are yellow.  Similarly, the pre-existing examples 
in adjust-dateTime-to-timezone() have added words that showed up in green, 
and a whole new example that showed up yellow.
Again, I don't think the distinction matters much since an addition is 
just a special kind of change, and so having color in the right places is 
what's important, and so I think it's good to go.  If you're showing diffs 
relative to 1.1 content, then maybe the diff marking around the editors 
seems reversed :-)

Not to do with this document in particular, but I'm surprised W3C still 
let's red and green be used for diff marking, given emphasis on 

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

Twitter: http://twitter.com/johnboyerphd
Blog: http://www.ibm.com/developerworks/blogs/page/JohnBoyer
Blog RSS feed: 

From:   Nick Van den Bleeken <Nick.Van.den.Bleeken@inventivegroup.com>
To:     Public Forms <public-forms@w3.org>
Date:   24/05/2012 02:30 AM
Subject:        XForms expression module diff version


I managed to re-create a base version for the XForms Expression module and 
use this as a base for the diff version. I decided to not mark the change 
in notation of the function attributes as a change, because this isn't a 
real change but only a syntax change.

You can find the live diff version at 
any changes made to wiki spec will be reflected in the diff version.

Could all group members have a look at the differences and decide if they 
agree with those changes so we can advance this document and the XForms 
core document to FPWD.

Thanks in advance,

Nick Van den Bleeken
R&D Manager

Phone: +32 3 425 41 02
Office fax: +32 3 821 01 71

PS: I'm not completely happy with the diff marking (e.g.: the eval 
functions sections), but this is the best I could get it. Also be warned 
that the coloring schema isn't what you would expect (change: yellow, 
new:lime), for the FPWD version we can change the colors in the css if we 
want to. 

Inventive Designers' Email Disclaimer:
Received on Thursday, 24 May 2012 13:58:07 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:14:07 UTC