<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE spec PUBLIC "-//W3C//DTD Specification V2.1//EN"
               "http://www.w3.org/XML/1998/06/xmlspec-v21.dtd" [
  <!-- ================================================================ -->
  <!ENTITY draft.day "25">
  <!ENTITY draft.month "07">
  <!ENTITY draft.monthname "Jul">
  <!ENTITY draft.year "2002">
  <!ENTITY iso6.doc.date "&draft.year;-&draft.month;-&draft.day;">
  <!ENTITY http-ident "http://www.w3.org/2001/tag/doc/formatting-properties">
]>
<spec w3c-doctype='other'>
<?CVS id="$Id: formatting-properties.xml,v 1.7 2002/07/25 15:22:22 NormanWalsh Exp $"?>
<?CVS date="$Date: 2002/07/25 15:22:22 $"?>
<?CVS revision="$Revision: 1.7 $"?>
<header>
<title>Consistency of Formatting Property Names, Values, and Semantics</title>
<w3c-designation>&http-ident;-&iso6.doc.date;</w3c-designation>
<w3c-doctype>TAG Finding</w3c-doctype>
<pubdate><day>&draft.day;</day>
<month>&draft.monthname;</month>
<year>&draft.year;</year>
</pubdate>
<publoc>
<loc href="&http-ident;">&http-ident;</loc>
(<loc href="&http-ident;.html">HTML</loc>,
<loc href="&http-ident;.xml">XML</loc>)</publoc>
<!--
<latestloc><loc href="&http-ident;">&http-ident;</loc>
</latestloc>
-->
<prevlocs>
<loc href="&http-ident;-2002-07-15.html">&http-ident;-2002-07-15</loc>
<loc href="&http-ident;-2002-06-17.html">&http-ident;-2002-06-17</loc>
</prevlocs>
<authlist>
<author><name>Norman Walsh</name>
<affiliation>Sun Microsystems, Inc.</affiliation>
<email href="mailto:Norman.Walsh@Sun.COM">Norman.Walsh@Sun.COM</email></author>
</authlist>
<copyright>
<p>
<loc href="http://www.w3.org/Consortium/Legal/ipr-notice-20000612#Copyright">Copyright</loc> &#xA9; 2002
<loc href="http://www.w3.org/">W3C</loc><sup>&#xAE;</sup>
(<loc href="http://www.lcs.mit.edu/">MIT</loc>,
<loc href="http://www.inria.fr/">INRIA</loc>,
<loc href="http://www.keio.ac.jp/">Keio</loc>),
All Rights Reserved. W3C
<loc href="http://www.w3.org/Consortium/Legal/ipr-notice-20000612#Legal_Disclaimer">liability</loc>,
<loc href="http://www.w3.org/Consortium/Legal/ipr-notice-20000612#W3C_Trademarks">trademark</loc>,
<loc href="http://www.w3.org/Consortium/Legal/copyright-documents-19990405">document use</loc>, and
<loc href="http://www.w3.org/Consortium/Legal/copyright-software-19980720">software licensing</loc>
rules apply.
</p></copyright>

<abstract>
<p>The use of named formatting properties to influence the
presentation of documents on the web has become widespread. As XML
vocabularies are now being combined in many ways, it is
imperative that a common set of property names, values, and
semantics be maintained.</p>
<p>This finding establish an architectural principle
to that effect.</p>
</abstract>

<status>

<p>This document has been developed for discussion by the
<loc href="/2001/tag/">W3C Technical Architecture Group</loc>.
This finding addresses <loc href="http://www.w3.org/2001/tag/ilist#formattingProperties-19">issue
formattingProperties-19</loc>.</p>

<p>This finding was accepted by the TAG at its 
<loc href="/2002/07/22-tag-summary#Update">22 July 2002
teleconference</loc>. The TAG originally reached consensus on this finding
at its <loc href="/2002/07/15-tag-summary#Consistenc">15 July 2002 teleconference</loc>.</p>

<p><loc href="/2001/tag/findings">Additional TAG findings</loc>, both
approved and in draft state, may also be available. The TAG expects to
incorporate this and other findings into a Web Architecture Document
that will be published according to the process of the <loc
href="/Consortium/Process-20010719/tr#Recs">W3C Recommendation
Track</loc>.</p>

<p>Please send comments on this finding to the publicly archived TAG
mailing list <loc
href="mailto:www-tag@w3.org">www-tag@w3.org</loc>
(<loc
href="http://lists.w3.org/Archives/Public/www-tag/">archive</loc>).</p>

</status>
<pubstmt>
<p>Chicago, Vancouver, Mountain View, et al.: World-Wide Web Consortium,
Draft TAG Finding, 2002.</p>
</pubstmt>
<sourcedesc>
<p>Created in electronic form.</p>
</sourcedesc>
<langusage>
<language id="EN">English</language>
</langusage>
<revisiondesc>
<slist>
<sitem>2002-04-30: Published draft</sitem>
</slist>
</revisiondesc>
</header>
<body>

<div1 id="intro">
<head>Formatting Properties on the Web</head>

<p>The use of named formatting properties to influence the
presentation of documents on the web has grown from its introduction
in <bibref ref="css1"/> to include a wide range of specifications:
<bibref ref="css2"/>, <bibref ref="svg"/>, <bibref ref="smil"/>,
<bibref ref="mathml"/>, <bibref ref="xsl"/>, and possibly others.</p>

<p>This has a positive benefit for the user- and developer-communities
because it reduces the number of property languages that need to be
understood by users and applications. Furthermore, as XML vocabularies
are now being combined in many ways, it is becoming more than merely
beneficial, it is becoming imperative that a common set of properties
and values be developed.</p>

<p>Consider an application that is expected to render a compound
document that consists of XSL Formatting Objects, XHTML table markup,
SVG diagrams, and MathML equations. Typically, the author (and the
reader) would want consistent styling for all these pieces.</p>

<p>Because many properties are considered <quote>inheritable</quote>,
each of the vocabularies must use the same properties for the same
purpose in order for the styling to be consistent. In addition to
using the same properties, the interpretation of those properties must
be the same in each vocabulary.</p>

<p>Consider a simple concrete example, where only two vocabularies are nested:
</p>

<eg><![CDATA[<html:div xmlns:html="http://www.w3.org/1999/xhtml"
          style="font-family: serif; font-size: 18pt">
   <html:p>Some XHTML text</html:p>
   <svg:svg xmlns:svg="http://www.w3.org/2000/svg">
      <svg:g transform="scale(0.5)">
        <svg:text>Some SVG text</svg:text>
        ...
     </svg:g>
   </svg:svg>
</html:div>]]></eg>

<p>In the absence of any other direction (from an external stylesheet,
for example), one imagines that selection of a font family and size on
the XHTML <el>div</el> element applies to both the the XHTML text and
the SVG text.</p>

<p>It would be architecturally unsound to suggest that different
vocabularies should specify the same or very similar traits using
different property names or values. In this particular case, for example,
it would be unsound to suggest that the <quote>font-family</quote> property
be used to influence XHTML text but the <quote>fontFamily</quote> property
be used to exert the same influence over SVG.</p>
</div1>

<div1 id="coord">
<head>A History of Successful Coordination</head>

<p>The CSS, HTML, SVG, and XSL Working Groups have a shared history of
successful coordination on formatting properties and values. It is
possible that specific actions could be taken to assure continued
coordation: establishing key liasons, formation of a coordination
group, or even broad reorganization of the specifications.</p>

<p>However, these actions are outside the scope of this finding which aims
simply to specify an architectural principle.</p>
</div1>

<div1 id="principle">
<head>An Architectural Principle</head>

<p>Formatting property names, values, and semantics must be consistent
across all specifications. Whenever a working group suggests the
creation of a new formatting property, or the addition of, or a change
to, an existing formatting property's allowed values, the working
group must show a strong justification for not using an existing
formatting property or properties that are related to the proposed new
property or value.</p>

<p>Clearly innovation on the web will create situations where new
properties are required and existing properties will need to be
extended. What we must avoid doing is changing the semantics of
existing properties in ways that introduce unnecessary
interoperability issues.</p>

</div1>

<div1 id="references">
<head>References</head>

<blist>

<bibl id="css1" href="http://www.w3.org/TR/REC-CSS1" key="CSS1">Hakon Wium Lie,
Bert Bos, editors.
<titleref>Cascading Style Sheets, level 1</titleref>.
World Wide Web Consortium, 1996.</bibl>

<bibl id="css2" href="http://www.w3.org/TR/REC-CSS2" key="CSS2">Bert Bos,
Hakon Wium Lie, Chris Lilley, Ian Jacobs, editors.
<titleref>Cascading Style Sheets, level 2</titleref>.
World Wide Web Consortium, 1998.</bibl>

<bibl id="mathml" href="http://www.w3.org/TR/MathML2/" key="MathML">David Carlisle,
Patrick Ion, Robert Miner, Nico Poppelier, editors.
<titleref>Mathematical Markup Language (MathML) Version 2.0</titleref>.
World Wide Web Consortium, 1991.</bibl>

<bibl id="smil" href="http://www.w3.org/TR/smil20/" key="SMIL">Jeff Ayars,
Dick Bulterman, Aaron Cohen, et. al., editors.
<titleref>Synchronized Multimedia Integration Language (SMIL 2.0)</titleref>.
World Wide Web Consortium, 2001.</bibl>

<bibl id="svg" href="http://www.w3.org/TR/SVG/" key="SVG">Jon Ferraiolo, editor.
<titleref>Scalable Vector Graphics (SVG) 1.0 Specification</titleref>.
World Wide Web Consortium, 2001.</bibl>

<bibl id="xsl" href="http://www.w3.org/TR/xsl/" key="XSL">Sharon Adler,
Anders Berglund, Jeff Caruso, et. al., editors.
<titleref>Extensible Stylesheet Language (XSL) Version 1.0</titleref>
World Wide Web Consortium, 2001.</bibl>

</blist>

</div1>

</body>
</spec>
