W3C home > Mailing lists > Public > xsl-editors@w3.org > October to December 2000

master-name property

From: Dave Pawson <daveP@dpawson.freeserve.co.uk>
Date: Sat, 23 Dec 2000 11:01:19 +0000
Message-Id: <4.3.1.2.20001223105334.00ba3c20@127.0.0.1>
To: xsl-editors@w3.org
The use of the master-name property within
fo:simple-page-master ,  fo:page-sequence-master and fo:page-sequence 
I find very confusing.

Within fo:single-page-master-reference you specify master-name, but
element indicates its a reference, not a 'name' or identifier.
For the previous 3 elements, I'm not sure if each is a reference or
an identifier.

I would find it far more helpful if the property were changed to
clearly indicate to users that the first two are idenfiers,
and in the third case its a reference, perhaps by changing the 
property name to master-name-reference. If this is done, the practice
could be made common by renaming the master-name property in the sub-sequence
elements of page-sequence-master.

E.g.

  <fo:page-sequence-master master-name="master-sequence">
	  <fo:single-page-master-reference
	     master-name-reference="first"/>
           <fo:repeatable-page-master-reference 
                 master-name-reference="red" 
                 maximum-repeats="10"/>
           <fo:repeatable-page-master-reference
                 master-name-reference="green"
	        maximum-repeats="no-limit"/>
   </fo:page-sequence-master>


Then fo:page-sequence would read

<fo:page-sequence
    master-page-reference="master-sequence"

Its difficult enough to understand without adding to the complexity
by misleading readers with poorly named properties.

Regards DaveP
AC, RNIB.
Received on Saturday, 23 December 2000 06:02:48 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 7 December 2009 10:59:51 GMT