Re: Preprocessor and propdef tables

On Thursday 20 September 2012 21:41:43 L. David Baron wrote:
> So it seems that every time I edit a spec these days, I initially
> can't preprocess it because there's something wrong with the
> property templates.  I don't mind so much having to add items, but
> having to reorder items in weird ways has become a little annoying
> (I had to do this to animations and transitions this morning to get
> them to preprocess).
> 
> Is it documented somewhere what the rules of the property templates
> are?  There seem to be some ordering constraints but they're not
> that strict.

I integrated some decisions we made about the property tables, I don't 
remember when. And I checked that the order that the script tested for 
was the same as the order in the module template. (I didn't think about 
updating the documentation in http://www.w3.org/Style/spec-mark-up until 
just now...)

But it seems that the order of rows in the property definitions in the 
module template has since changed. So what is the right order?

The script actually only *warns* about the order of the fields. It 
doesn't need any particular order to function. (Originally it did, but 
when we added "Animatable" and later "Canonical order," there were so 
many drafts without them that I changed the script to work with or 
without those fields.) You can ignore the warnings if you want. Usually,

    make Overview.html

will generate the draft directly, without first checking for errors.

Some Makefiles, such as the one in css3-layout, are also smart enough to 
distinguish warnings from errors. They will continue to generate 
Overview.html if the check produced only warnings.



Bert
-- 
  Bert Bos                                ( W 3 C ) http://www.w3.org/
  http://www.w3.org/people/bos                               W3C/ERCIM
  bert@w3.org                             2004 Rt des Lucioles / BP 93
  +33 (0)4 92 38 76 92            06902 Sophia Antipolis Cedex, France

Received on Friday, 21 September 2012 18:54:36 UTC