ReSpec formatting and bypassing some ReSpec generation errors (todo: rework IDL)
authorJames Craig <jcraig@apple.com>
Mon, 12 Nov 2012 11:11:19 -0800
changeset 27 2f68808a16c9
parent 26 074c1fd4bca5
child 28 be6d2ac588de
ReSpec formatting and bypassing some ReSpec generation errors (todo: rework IDL)
src/indie-ui-context.html
src/indie-ui-events.html
--- a/src/indie-ui-context.html	Sun Nov 11 23:16:04 2012 -0800
+++ b/src/indie-ui-context.html	Mon Nov 12 11:11:19 2012 -0800
@@ -17,11 +17,11 @@
           specStatus:           "ED",
           
           // the specification's short name, as in http://www.w3.org/TR/short-name/
-          shortName:            "indie-ui-events",
+          shortName:            "indie-ui-context",
 
           // if your specification has a subtitle that goes below the main
           // formal title, define it here
-          // subtitle   :  "an excellent document",
+          subtitle   :  "Contextual Information for User Interface Independence",
 
           // if you wish the publication date to be other than today, set this
           // publishDate:  "2009-08-06",
@@ -106,7 +106,7 @@
 			<p>In certain cases, it is beneficial for web authors to be aware of the assistive technology in use. This section defines a collection of attributes that can be used to determine, from script, the kind of assistive technology in use, in order to be aware of considerations for a particular assistive technology, including the need to support the <a href="#RequestEvents">UI Change Request Events</a> or <a href="#AXevents">Accessibility Events</a> defined in previous sections. Web authors <strong class="rfc2119">should</strong> always limit client detection to detecting known versions. Web authors <strong class="rfc2119">should</strong> always assume future versions and unknown versions to be fully compliant.</p>
 			<p>The <code>accessibility</code> attribute of the Navigator interface <strong class="rfc2119">must</strong> return an instance of the Accessibility interface, which represents the identity and state of the assistive technology, and allows web pages to optionally notify assistive technology of certain interface events that cannot be indicated through declarative markup such as WAI-ARIA roles, states, and properties.</p>
 			<h3><strong>Interface <em>Accessibility</em></strong></h3>
-			<div class="idl">
+			<div class="idlwrapper">
 				<pre><code>interface Accessibility {
   readonly attribute InterfaceObject accessibility; <em class="ednote">// Editorial Note: Is it necessary to define this attribute in the IDL?</em>
   <span class="comment">// objects implementing the Accessibility interface also implement the ScreenReader and AccessibilityNotifications interfaces</span>
@@ -138,7 +138,7 @@
 			
 			<h3><strong>Interface <em>ScreenReader</em></strong></h3>
 			<p>The <code>screenreader</code> attribute of the Accessibility interface <strong class="rfc2119">must</strong> return an instance of the ScreenReader interface:</p>
-			<div class="idl">
+			<div class="idlwrapper">
 				<pre><code>interface ScreenReader {
   readonly attribute InterfaceObject screenreader; <em class="ednote">// Editorial Note: Is it necessary to define this attribute in the IDL?</em>
   <span class="comment">// objects implementing the ScreenReader interface also implement the interfaces given below</span>
@@ -175,7 +175,7 @@
 			
 			<h3><strong>Interface <em>Magnifier</em></strong></h3>
 			<p>The <code>magnifier</code> attribute of the Accessibility interface <strong class="rfc2119">must</strong> return an instance of the Magnifier interface:</p>
-			<div class="idl">
+			<div class="idlwrapper">
 				<pre><code>interface Magnifier {
   readonly attribute InterfaceObject magnifier; <em class="ednote">// Editorial Note: Is it necessary to define this attribute in the IDL?</em>
   <span class="comment">// objects implementing the Magnifier interface also implement the interfaces given below</span>
@@ -246,7 +246,7 @@
 			<!--
 			<h3><strong>Interface <em>Speech</em></strong></h3>
 			<p>The <code>speech</code> attribute of the Accessibility interface <strong class="rfc2119">must</strong> return an instance of the Speech interface:</p>
-			<div class="idl">
+			<div class="idlwrapper">
 				<pre><code>interface Speech {
   <span class="comment">// TBD, placeholder for speech-controlled user agents or assistive technology</span>
   <span class="comment">// may need speech.synthesis and speech.recognition; each could have name/version/engine, etc. </span>
--- a/src/indie-ui-events.html	Sun Nov 11 23:16:04 2012 -0800
+++ b/src/indie-ui-events.html	Mon Nov 12 11:11:19 2012 -0800
@@ -21,7 +21,7 @@
 
           // if your specification has a subtitle that goes below the main
           // formal title, define it here
-          // subtitle   :  "an excellent document",
+          subtitle   :  "Events for User Interface Independence",
 
           // if you wish the publication date to be other than today, set this
           // publishDate:  "2009-08-06",
@@ -115,10 +115,10 @@
 
 			<!-- :::::::::::::::::::: UIRequestEvent :::::::::::::::::::: -->
 			<section id="UIRequestEvent">
-				<h3><strong>Interface <em>UIRequestEvent</em></strong></h3>
+				<h3>Interface UIRequestEvent</h3>
 
 				<div class="idlwrapper">
-					<pre class="idl">interface UIRequestEvent : UIEvent {
+					<pre>interface UIRequestEvent : UIEvent {
   void initUIRequestEvent(
     in DOMString typeArg,
     in boolean canBubbleArg,
@@ -129,7 +129,8 @@
 };</pre>
 				</div>
 				<section id="UIRequestEvents">
-					<h4>The different types of UIRequestEvents that can occur are:</h4>
+					<h4>UIRequestEvent Types</h4>
+					<p>The different types of UIRequestEvents that can occur are:</p>
 					<dl>
 						<dt id="undorequest">Undo Request <code class="event">undorequest</code></dt>
 						<dd>
@@ -195,9 +196,9 @@
 
 			<!-- :::::::::::::::::::: UIPanRequestEvent :::::::::::::::::::: -->
 			<section id="UIPanRequestEvent">
-				<h3><strong>Interface <em>UIPanRequestEvent</em></strong></h3>
+				<h3>Interface UIPanRequestEvent</h3>
 				<div class="idlwrapper">
-					<pre class="idl">interface UIPanRequestEvent : UIRequestEvent {
+					<pre>interface UIPanRequestEvent : UIRequestEvent {
 
   <span class="comment">// for panning views (e.g. maps or zoomed graphical views... not intended for standard scroll views)</span>
 
@@ -216,7 +217,8 @@
 };</pre>
 				</div>
 				<section id="UIPanRequestEvents">
-					<h4>The single type of UIPanRequestEvent that can occur is:</h4>
+					<h4>UIPanRequestEvent Types</h4>
+					<p>The single type of UIPanRequestEvent that can occur is:</p>
 					<dl>
 						<dt id="panrequest">Pan Request <code class="event">panrequest</code></dt>
 						<dd>
@@ -235,10 +237,10 @@
 
 			<!-- :::::::::::::::::::: UIScrollRequestEvent :::::::::::::::::::: -->
 			<section id="UIScrollRequestEvent">
-				<h3><strong>Interface <em>UIScrollRequestEvent</em></strong></h3>
+				<h3>Interface UIScrollRequestEvent</h3>
 				<div class="ednote">Editorial Note: these constants will likely change dramatically based on discussion from the IndieUI Face-to-Face.</div>
 				<div class="idlwrapper">
-					<pre class="idl">interface UIScrollRequestEvent : UIRequestEvent {
+					<pre>interface UIScrollRequestEvent : UIRequestEvent {
   
   <span class="comment">// for custom scroll views or widgets (e.g. carousels, lists, grids)</span>
   const unsigned short    LEFT          =  TBD;
@@ -263,7 +265,8 @@
 };</pre>
 				</div>
 				<section id="UIScrollRequestEvents">
-					<h4>The single type of UIScrollRequestEvent that can occur is:</h4>
+					<h4>UIScrollRequestEvent Types</h4>
+					<p>The single type of UIScrollRequestEvent that can occur is:</p>
 					<dl>
 						<dt id="scrollrequest">Scroll Request <code class="event">scrollrequest</code></dt>
 						<dd>
@@ -282,10 +285,10 @@
 
 			<!-- :::::::::::::::::::: UIValueChangeRequestEvent :::::::::::::::::::: -->
 			<section id="UIValueChangeRequestEvent">
-				<h3><strong>Interface <em>UIValueChangeRequestEvent</em></strong></h3>
+				<h3>Interface UIValueChangeRequestEvent</h3>
 				<div class="ednote">Editorial Note: these constants will likely change dramatically based on discussion from the IndieUI Face-to-Face.</div>
 				<div class="idlwrapper">
-					<pre class="idl">interface UIValueChangeRequestEvent : UIRequestEvent {
+					<pre>interface UIValueChangeRequestEvent : UIRequestEvent {
   
   <span class="comment">// value changes (e.g. ranges)</span>
   const unsigned short    INCREMENT        =  TBD;
@@ -310,7 +313,8 @@
 };</pre>
 				</div>
 				<section id="UIValueChangeRequestEvents">
-					<h4>The single type of UIValueChangeRequestEvent that can occur is:</h4>
+					<h4>UIValueChangeRequestEvent Types</h4>
+					<p>The single type of UIValueChangeRequestEvent that can occur is:</p>
 					<dl>
 						<dt id="valuechangerequest">Value Change Request <code class="event">valuechangerequest</code></dt>
 						<dd>
@@ -332,10 +336,10 @@
 
 			<!-- :::::::::::::::::::: UIZoomRequestEvent :::::::::::::::::::: -->
 			<section id="UIZoomRequestEvent">
-				<h3><strong>Interface <em>UIZoomRequestEvent</em></strong></h3>
+				<h3>Interface UIZoomRequestEvent</h3>
 
 				<div class="idlwrapper">
-					<pre class="idl">interface UIZoomRequestEvent : UIRequestEvent {
+					<pre>interface UIZoomRequestEvent : UIRequestEvent {
   
   <span class="comment">// zoom changes (e.g. maps or custom layout views)</span>
   const unsigned short    IN   =  TBD;
@@ -362,7 +366,8 @@
 };</pre>
 				</div>
 				<section id="UIZoomRequestEvents">
-					<h4>The single type of UIZoomRequestEvent that can occur is:</h4>
+					<h4>UIZoomRequestEvent Types</h4>
+					<p>The single type of UIZoomRequestEvent that can occur is:</p>
 					<dl>
 						<dt id="zoomrequest">Zoom Request <code class="event">zoomrequest</code></dt>
 						<dd>
@@ -389,9 +394,9 @@
 			
 			<!-- :::::::::::::::::::: AccessibilityEvent :::::::::::::::::::: -->
 			<section id="AccessibilityEvent">
-				<h3><strong>Interface <em>AccessibilityEvent</em></strong></h3>
+				<h3>Interface AccessibilityEvent</h3>
 				<div class="idlwrapper">
-					<pre class="idl">interface AccessibilityEvent : UIEvent {
+					<pre>interface AccessibilityEvent : UIEvent {
   void initAccessibilityEvent(
     in DOMString typeArg,
     in boolean canBubbleArg,
@@ -402,7 +407,8 @@
 };</pre>
 				</div>
 				<section id="AccessibilityEvents">
-					<h4>The different types of AccessibilityEvents that can occur are:</h4>
+					<h4>AccessibilityEvent Types</h4>
+					<p>The different types of AccessibilityEvents that can occur are:</p>
 					<dl>
 						<dt>Assistive Technology Focus <code class="event">ATFocus</code></dt>
 						<dd>