W3C home > Mailing lists > Public > public-html-diffs@w3.org > January 2011

eliot: Rewrote Attribute Values based on mail feedback

From: poot <cvsmail@w3.org>
Date: Wed, 26 Jan 2011 18:49:54 -0500
To: public-html-diffs@w3.org
Message-Id: <E1PiF7Z-0007Zn-NN@jay.w3.org>
eliot: Rewrote Attribute Values based on mail feedback

http://dev.w3.org/cvsweb/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html?r1=1.53&r2=1.54&f=h

===================================================================
RCS file: /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html,v
retrieving revision 1.53
retrieving revision 1.54
diff -u -d -r1.53 -r1.54
--- html-xhtml-authoring-guide.html	13 Jan 2011 22:19:55 -0000	1.53
+++ html-xhtml-authoring-guide.html	26 Jan 2011 23:48:32 -0000	1.54
@@ -4,465 +4,8 @@
 <head>
 	<title>Polyglot Markup: HTML-Compatible XHTML Documents</title>
 	<meta name="GENERATOR" content="MSHTML 8.00.7600.16588"/>
-	<style type="text/css">
-		
-		/* --- INLINES --- */
-		em.rfc2119 { 
-		    text-transform:     lowercase;
-		    font-variant:       small-caps;
-		    font-style:         normal;
-		    color:              #900;
-		}
-		
-		h1 acronym, h2 acronym, h3 acronym, h4 acronym, h5 acronym, h6 acronym, a acronym,
-		h1 abbr, h2 abbr, h3 abbr, h4 abbr, h5 abbr, h6 abbr, a abbr {
-		    border: none;
-		}
-		
-		dfn {
-		    font-weight:    bold;
-		}
-		
-		a.internalDFN {
-		    color:  inherit;
-		    border-bottom:  medium solid #99c;
-		    text-decoration:    none;
-		}
-		
-		a.externalDFN {
-		    color:  inherit;
-		    border-bottom:  medium dotted #ccc;
-		    text-decoration:    none;
-		}
-		
-		a.bibref {
-		    text-decoration:    none;
-		}
-		
-		code {
-		    color:  #ff4500;
-		}
-		
-		
-		/* --- WEB IDL --- */
-		pre.idl {
-		    border-top: 1px solid #90b8de;
-		    border-bottom: 1px solid #90b8de;
-		    padding:    1em;
-		    line-height:    120%;
-		}
-		
-		pre.idl::before {
-		    content:    "WebIDL";
-		    display:    block;
-		    width:      150px;
-		    background: #90b8de;
-		    color:  #fff;
-		    font-family:    initial;
-		    padding:    3px;
-		    font-weight:    bold;
-		    margin: -1em 0 1em -1em;
-		}
-		
-		.idlType {
-		    color:  #ff4500;
-		    font-weight:    bold;
-		    text-decoration:    none;
-		}
-		
-		/*.idlModule*/
-		/*.idlModuleID*/
-		/*.idlInterface*/
-		.idlInterfaceID {
-		    font-weight:    bold;
-		    color:  #005a9c;
-		}
-		
-		.idlSuperclass {
-		    font-style: italic;
-		    color:  #005a9c;
-		}
-		
-		/*.idlAttribute*/
-		.idlAttrType, .idlFieldType {
-		    color:  #005a9c;
-		}
-		.idlAttrName, .idlFieldName {
-		    color:  #ff4500;
-		}
-		.idlAttrName a, .idlFieldName a {
-		    color:  #ff4500;
-		    border-bottom:  1px dotted #ff4500;
-		    text-decoration: none;
-		}
-		
-		/*.idlMethod*/
-		.idlMethType {
-		    color:  #005a9c;
-		}
-		.idlMethName {
-		    color:  #ff4500;
-		}
-		.idlMethName a {
-		    color:  #ff4500;
-		    border-bottom:  1px dotted #ff4500;
-		    text-decoration: none;
-		}
-		
-		/*.idlParam*/
-		.idlParamType {
-		    color:  #005a9c;
-		}
-		.idlParamName {
-		    font-style: italic;
-		}
-		
-		.extAttr {
-		    color:  #666;
-		}
-		
-		/*.idlConst*/
-		.idlConstType {
-		    color:  #005a9c;
-		}
-		.idlConstName {
-		    color:  #ff4500;
-		}
-		.idlConstName a {
-		    color:  #ff4500;
-		    border-bottom:  1px dotted #ff4500;
-		    text-decoration: none;
-		}
-		
-		/*.idlException*/
-		.idlExceptionID {
-		    font-weight:    bold;
-		    color:  #c00;
-		}
-		
-		.idlTypedefID, .idlTypedefType {
-		    color:  #005a9c;
-		}
-		
-		.idlRaises, .idlRaises a.idlType, .idlRaises a.idlType code, .excName a, .excName a code {
-		    color:  #c00;
-		    font-weight:    normal;
-		}
-		
-		.excName a {
-		    font-family:    monospace;
-		}
-		
-		.idlRaises a.idlType, .excName a.idlType {
-		    border-bottom:  1px dotted #c00;
-		}
-		
-		.excGetSetTrue, .excGetSetFalse, .prmNullTrue, .prmNullFalse, .prmOptTrue, .prmOptFalse {
-		    width:  45px;
-		    text-align: center;
-		}
-		.excGetSetTrue, .prmNullTrue, .prmOptTrue { color:  #0c0; }
-		.excGetSetFalse, .prmNullFalse, .prmOptFalse { color:  #c00; }
-		
-		.idlImplements a {
-		    font-weight:    bold;
-		}
-		
-		dl.attributes, dl.methods, dl.constants, dl.fields {
-		    margin-left:    2em;
-		}
-		
-		.attributes dt, .methods dt, .constants dt, .fields dt {
-		    font-weight:    normal;
-		}
-		
-		.attributes dt code, .methods dt code, .constants dt code, .fields dt code {
-		    font-weight:    bold;
-		    color:  #000;
-		    font-family:    monospace;
-		}
-		
-		.attributes dt code, .fields dt code {
-		    background:  #ffffd2;
-		}
-		
-		.attributes dt .idlAttrType code, .fields dt .idlFieldType code {
-		    color:  #005a9c;
-		    background:  transparent;
-		    font-family:    inherit;
-		    font-weight:    normal;
-		    font-style: italic;
-		}
-		
-		.methods dt code {
-		    background:  #d9e6f8;
-		}
-		
-		.constants dt code {
-		    background:  #ddffd2;
-		}
-		
-		.attributes dd, .methods dd, .constants dd, .fields dd {
-		    margin-bottom:  1em;
-		}
-		
-		table.parameters, table.exceptions {
-		    border-spacing: 0;
-		    border-collapse:    collapse;
-		    margin: 0.5em 0;
-		    width:  100%;
-		}
-		table.parameters { border-bottom:  1px solid #90b8de; }
-		table.exceptions { border-bottom:  1px solid #deb890; }
-		
-		.parameters th, .exceptions th {
-		    color:  #fff;
-		    padding:    3px 5px;
-		    text-align: left;
-		    font-family:    initial;
-		    font-weight:    normal;
-		    text-shadow:    #666 1px 1px 0;
-		}
-		.parameters th { background: #90b8de; }
-		.exceptions th { background: #deb890; }
-		
-		.parameters td, .exceptions td {
-		    padding:    3px 10px;
-		    border-top: 1px solid #ddd;
-		    vertical-align: top;
-		}
-		
-		.parameters tr:first-child td, .exceptions tr:first-child td {
-		    border-top: none;
-		}
-		
-		.parameters td.prmName, .exceptions td.excName, .exceptions td.excCodeName {
-		    width:  100px;
-		}
-		
-		.parameters td.prmType {
-		    width:  120px;
-		}
-		
-		table.exceptions table {
-		    border-spacing: 0;
-		    border-collapse:    collapse;
-		    width:  100%;
-		}
-		
-		/* --- TOC --- */
-		.toc a {
-		    text-decoration:    none;
-		}
-		
-		a .secno {
-		    color:  #000;
-		}
-		
-		/* --- TABLE --- */
-		table.simple {
-		    border-spacing: 0;
-		    border-collapse:    collapse;
-		    border-bottom:  3px solid #005a9c;
-		}
-		
-		.simple th {
-		    background: #005a9c;
-		    color:  #fff;
-		    padding:    3px 5px;
-		    text-align: left;
-		}
-		
-		.simple th[scope="row"] {
-		    background: inherit;
-		    color:  inherit;
-		    border-top: 1px solid #ddd;
-		}
-		
-		.simple td {
-		    padding:    3px 10px;
-		    border-top: 1px solid #ddd;
-		}
-		
-		.simple tr:nth-child(even) {
-		    background: #f0f6ff;
-		}
-		
-		/* --- DL --- */
-		.section dd > p:first-child {
-		    margin-top: 0;
-		}
-		
-		.section dd > p:last-child {
-		    margin-bottom: 0;
-		}
-		
-		.section dd {
-		    margin-bottom:  1em;
-		}
-		
-		.section dl.attrs dd, .section dl.eldef dd {
-		    margin-bottom:  0;
-		}
-		
-		/* --- EXAMPLES --- */
-		pre.example {
-		    border-top: 1px solid #ff4500;
-		    border-bottom: 1px solid #ff4500;
-		    padding:    1em;
-		    margin-top: 1em;
-		}
-		
-		pre.example::before {
-		    content:    "Example";
-		    display:    block;
-		    width:      150px;
-		    background: #ff4500;
-		    color:  #fff;
-		    font-family:    initial;
-		    padding:    3px;
-		    font-weight:    bold;
-		    margin: -1em 0 1em -1em;
-		}
-		
-		/* --- EDITORIAL NOTES --- */
-		.issue {
-		    padding:    1em;
-		    margin: 1em 0em 0em;
-		    border: 1px solid #f00;
-		    background: #ffc;
-		}
-		
-		.issue::before {
-		    content:    "Issue";
-		    display:    block;
-		    width:  150px;
-		    margin: -1.5em 0 0.5em 0;
-		    font-weight:    bold;
-		    border: 1px solid #f00;
-		    background: #fff;
-		    padding:    3px 1em;
-		}
-		
-		.note {
-		    margin: 1em 0em 0em;
-		    padding:    1em;
-		    border: 2px solid #cff6d9;
-		    background: #e2fff0;
-		}
-		
-		.note::before {
-		    content:    "Note";
-		    display:    block;
-		    width:  150px;
-		    margin: -1.5em 0 0.5em 0;
-		    font-weight:    bold;
-		    border: 1px solid #cff6d9;
-		    background: #fff;
-		    padding:    3px 1em;
-		}
-		
-		/* --- Best Practices --- */
-		div.practice {
-		    border: solid #bebebe 1px;
-		    margin: 2em 1em 1em 2em;
-		}
-		
-		span.practicelab {
-		    margin: 1.5em 0.5em 1em 1em;
-		    font-weight: bold;
-		    font-style: italic;
-		}
-		
-		span.practicelab   { background: #dfffff; }
-		
-		span.practicelab {
-		    position: relative;
-		    padding: 0 0.5em;
-		    top: -1.5em;
-		}
-		
-		p.practicedesc {
-		    margin: 1.5em 0.5em 1em 1em;
-		}
-		
-		@media screen {
-		    p.practicedesc {
-		        position: relative;
-		        top: -2em;
-		        padding: 0;
-		        margin: 1.5em 0.5em -1em 1em;
-		}
-		
-		/* --- SYNTAX HIGHLIGHTING --- */
-		pre.sh_sourceCode {
-		  background-color: white;
-		  color: black;
-		  font-style: normal;
-		  font-weight: normal;
-		}
-		
-		pre.sh_sourceCode .sh_keyword { color: #005a9c; font-weight: bold; }           /* language keywords */
-		pre.sh_sourceCode .sh_type { color: #666; }                            /* basic types */
-		pre.sh_sourceCode .sh_usertype { color: teal; }                             /* user defined types */
-		pre.sh_sourceCode .sh_string { color: red; font-family: monospace; }        /* strings and chars */
-		pre.sh_sourceCode .sh_regexp { color: orange; font-family: monospace; }     /* regular expressions */
-		pre.sh_sourceCode .sh_specialchar { color: 	#ffc0cb; font-family: monospace; }  /* e.g., \n, \t, \\ */
-		pre.sh_sourceCode .sh_comment { color: #A52A2A; font-style: italic; }         /* comments */
-		pre.sh_sourceCode .sh_number { color: purple; }                             /* literal numbers */
-		pre.sh_sourceCode .sh_preproc { color: #00008B; font-weight: bold; }       /* e.g., #include, import */
-		pre.sh_sourceCode .sh_symbol { color: blue; }                            /* e.g., *, + */
-		pre.sh_sourceCode .sh_function { color: black; font-weight: bold; }         /* function calls and declarations */
-		pre.sh_sourceCode .sh_cbracket { color: red; }                              /* block brackets (e.g., {, }) */
-		pre.sh_sourceCode .sh_todo { font-weight: bold; background-color: #00FFFF; }   /* TODO and FIXME */
-		
-		/* Predefined variables and functions (for instance glsl) */
-		pre.sh_sourceCode .sh_predef_var { color: #00008B; }
-		pre.sh_sourceCode .sh_predef_func { color: #00008B; font-weight: bold; }
-		
-		/* for OOP */
-		pre.sh_sourceCode .sh_classname { color: teal; }
-		
-		/* line numbers (not yet implemented) */
-		pre.sh_sourceCode .sh_linenum { display: none; }
-		
-		/* Internet related */
-		pre.sh_sourceCode .sh_url { color: blue; text-decoration: underline; font-family: monospace; }
-		
-		/* for ChangeLog and Log files */
-		pre.sh_sourceCode .sh_date { color: blue; font-weight: bold; }
-		pre.sh_sourceCode .sh_time, pre.sh_sourceCode .sh_file { color: #00008B; font-weight: bold; }
-		pre.sh_sourceCode .sh_ip, pre.sh_sourceCode .sh_name { color: #006400; }
-		
-		/* for Prolog, Perl... */
-		pre.sh_sourceCode .sh_variable { color: #006400; }
-		
-		/* for LaTeX */
-		pre.sh_sourceCode .sh_italics { color: #006400; font-style: italic; }
-		pre.sh_sourceCode .sh_bold { color: #006400; font-weight: bold; }
-		pre.sh_sourceCode .sh_underline { color: #006400; text-decoration: underline; }
-		pre.sh_sourceCode .sh_fixed { color: green; font-family: monospace; }
-		pre.sh_sourceCode .sh_argument { color: #006400; }
-		pre.sh_sourceCode .sh_optionalargument { color: purple; }
-		pre.sh_sourceCode .sh_math { color: orange; }
-		pre.sh_sourceCode .sh_bibtex { color: blue; }
-		
-		/* for diffs */
-		pre.sh_sourceCode .sh_oldfile { color: orange; }
-		pre.sh_sourceCode .sh_newfile { color: #006400; }
-		pre.sh_sourceCode .sh_difflines { color: blue; }
-		
-		/* for css */
-		pre.sh_sourceCode .sh_selector { color: purple; }
-		pre.sh_sourceCode .sh_property { color: blue; }
-		pre.sh_sourceCode .sh_value { color: #006400; font-style: italic; }
-		
-		/* other */
-		pre.sh_sourceCode .sh_section { color: black; font-weight: bold; }
-		pre.sh_sourceCode .sh_paren { color: red; }
-		pre.sh_sourceCode .sh_attribute { color: #006400; }
-	</style>
 	<link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/W3C-ED"/>
+	<link rel="stylesheet" type="text/css" href="http://dev.w3.org/2009/dap/ReSpec.js/css/respec.css"/>
 </head>
 
 <body style="display: inherit;">
@@ -471,7 +14,7 @@
 			<a href="http://www.w3.org/"><img height="48" width="72" alt="W3C" src="http://www.w3.org/Icons/w3c_home"/></a>
 		</p>
 		<h1 class="title" id="title">Polyglot Markup: HTML-Compatible XHTML Documents</h1>
-		<h2 id="w3c-editor-s-draft-05-january-2011">W3C Editor's Draft 13 January 2011</h2>
+		<h2 id="w3c-editor-s-draft-05-january-2011">W3C Editor's Draft 26 January 2011</h2>
 		<dl>
 			<dt>This version:</dt>
 			<dd><a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html">http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html</a></dd>
@@ -898,7 +441,7 @@
 <!--End section: Element Names-->
 		</div>
 		
-		
+
 		<div id="attribute-names" class="section">
 		<h4><span class="secno">6.3.2 </span>Attribute Names</h4>
 			<p><a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses the correct case for attribute names.</p>
@@ -977,71 +520,51 @@
 <!--End section: Attribute Names-->
 		</div>
 
+
 		<div id="attribute-values" class="section">
 		<h4><span class="secno">6.3.3 </span>Attribute Values</h4>
 		<p>
-			<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a>
- requires the case used for characters in the values of the following 
-attributes to be consistent between markup, DOM APIs, and CSS 
+			For characters in attribute values, <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> maintains case consistency between markup, DOM APIs, and CSS 
 			when these attributes are used on HTML elements. 
-			This is because XML is case sensitive, but the values of these 
-attributes are treated as case insensitive in HTML when matched via CSS 
-selectors 
-			(See <a href="http://dev.w3.org/html5/spec/links.html#selectors">4.14.1 Case-sensitivity</a>, in the HTML5 specification). [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>]  
-			In addition, <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a>
- respects the case sensitivity of all other attribute values and for 
-non-ASCII characters in the values of the attributes listed. 
-			Note that other specifications, such as RDFa, may place additional 
-restrictions on the allowed values of certain attributes. 
 		</p>
-			<ul>
-				<li><code>accept</code></li>
-				<li><code>accept-charset</code></li>
-				<li><code>align</code></li>
-				<li><code>alink</code></li>
-				<li><code>axis</code></li>
-				<li><code>bgcolor</code></li>
-				<li><code>charset</code></li>
-				<li><code>checked</code></li>
-				<li><code>clear</code></li>
-				<li><code>codetype</code></li>
-				<li><code>color</code></li>
-				<li><code>compact</code></li>
-				<li><code>declare</code></li>
-				<li><code>defer</code></li>
-				<li><code>dir</code></li>
-				<li><code>direction</code></li>
-				<li><code>disabled</code></li>
-				<li><code>enctype</code></li>
-				<li><code>face</code></li>
-				<li><code>frame</code></li>
-				<li><code>hreflang</code></li>
-				<li><code>http-equiv</code></li>
-				<li><code>lang</code></li>
-				<li><code>language</code></li>
-				<li><code>link</code></li>
-				<li><code>media</code></li>
-				<li><code>method</code></li>
-				<li><code>multiple</code></li>
-				<li><code>nohref</code></li>
-				<li><code>noresize</code></li>
-				<li><code>noshade</code></li>
-				<li><code>nowrap</code></li>
-				<li><code>readonly</code></li>
-				<li><code>rel</code></li>
-				<li><code>rev</code></li>
-				<li><code>rules</code></li>
-				<li><code>scope</code></li>
-				<li><code>scrolling</code></li>
-				<li><code>selected</code></li>
-				<li><code>shape</code></li>
-				<li><code>target</code></li>
-				<li><code>text</code></li>
-				<li><code>type</code></li>
-				<li><code>valign</code></li>
-				<li><code>valuetype</code></li>
-				<li><code>vlink</code></li>
-			</ul>
+		<p>
+			<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> maintains case consistency for values on the following attributes, which occur on 
+			MIME types, language tags, charsets, booleans, media queries, and keywords.
+			Though not required, an easy way to maintain case-consistency is to use only lower case values for these attributes.
+			<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> maintains case consistency for these values 
+			because, for the purpose of selector matching, attribute values in XML are all treated case sensitively;
+			however, HTML treats the values of these attributes as case insensitive
+			(See <a href="http://dev.w3.org/html5/spec/links.html#selectors">4.14.1 Case-sensitivity</a>, in the HTML5 specification). [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>]
+			
+		</p>
+		<ul>
+			<li><code>accept</code></li>
+			<li><code>accept-charset</code></li>
+			<li><code>charset</code></li>
+			<li><code>checked</code></li>
+			<li><code>defer</code></li>
+			<li><code>dir</code></li>
+			<li><code>direction</code></li>
+			<li><code>disabled</code></li>
+			<li><code>enctype</code></li>
+			<li><code>hreflang</code></li>
+			<li><code>http-equiv</code></li>
+			<li><code>lang</code></li>
+			<li><code>media</code></li>
+			<li><code>method</code></li>
+			<li><code>multiple</code></li>
+			<li><code>readonly</code></li>
+			<li><code>rel</code> (for values that do not contain a colon)</li> 
+			<li><code>scope</code></li>
+			<li><code>selected</code></li>
+			<li><code>shape</code></li>
+			<li><code>target</code> (keywords only; browsing context names are case-sensitive)</li>
+			<li><code>type</code> (on <code>a</code>, <code>link</code>, <code>object</code>, <code>script</code>, or <code>style</code> elements)</li>
+			<li><code>type</code> (on input)</li>
+		</ul>
+		<p>
+			Note that other specifications, such as RDFa, may place additional restrictions on the allowed values of certain attributes. 
+		</p>
 <!--End section: Attribute Values-->
 		</div>
 <!--End section: Case-Sensitivity-->
@@ -1434,7 +957,6 @@
 <!--End section: Example Document-->
 </div>
 
-
 <div id="acknowledgements" class="appendix section">
 <!--OddPage--><h2><span class="secno">A. </span>Acknowledgements</h2>
 <p>
Received on Wednesday, 26 January 2011 23:49:56 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 26 January 2011 23:49:58 GMT