- From: Lachlan Hunt via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 06 Mar 2009 12:46:25 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/html-author
In directory hutz:/tmp/cvs-serv27697
Modified Files:
Overview.html Overview.src.html
Log Message:
Described the html element
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/html-author/Overview.html,v
retrieving revision 1.45
retrieving revision 1.46
diff -u -d -r1.45 -r1.46
--- Overview.html 6 Mar 2009 11:46:04 -0000 1.45
+++ Overview.html 6 Mar 2009 12:46:17 -0000 1.46
@@ -44,7 +44,7 @@
code { color:orangered }
code :link, code :visited { color:inherit }
pre code { color:inherit }
- pre strong { background: yellow; }
+ pre mark, pre strong { background: yellow; }
</style>
<link href=http://www.w3.org/StyleSheets/TR/W3C-ED rel=stylesheet type=text/css>
</head>
@@ -338,7 +338,7 @@
<section>
<h3 id=a-basic-document><span class=secno>2.1 </span>A Basic Document</h3>
- <p class=big-issue>The goal of this section is to walk people though creating
+ <p class=XXX>The goal of this section is to walk people though creating
<a href=examples/example01.html>example01.html</a></p>
<p>To begin, we’re going to create a very basic HTML document, which
@@ -703,7 +703,7 @@
<div class="example error">
<p>Erroneous Example:</p>
- <pre><code><section id="example">...</section <strong>id="example"</strong>></code></pre>
+ <pre><code><section id="example">...</section <mark>id="example"</mark>></code></pre>
</div>
<p>In XHTML, attribute names are case sensitive and most are defined to be
@@ -897,13 +897,6 @@
<!-- The HTML Vocabulary and APIs -->
<section>
<h2 id=the-html-vocabulary-and-apis><span class=secno>4 </span>The HTML Vocabulary and APIs</h2>
- <p class=big-issue>Expect major changes to this section. Each of these
- needs longer descriptions and the elements should be divided into
- categories. The IDL for the DOM Interfaces is likely to be replaced by something
- a lot more reader-friendly in the future; consider it a placeholder
- for now. Attributes will likely be accompanied by brief descriptions
- within the summary box, in addition to fuller descriptions and examples
- afterwards.</p>
<section>
<h3 id=categories><span class=secno>4.1 </span>Categories</h3>
@@ -1035,8 +1028,19 @@
<a href=#flow-content>flow content</a>.
+ <!-- The Elements -->
<section>
</section></p><h3 id=the-elements><span class=secno>4.2 </span>The Elements</h3>
+
+ <p class=XXX>Expect major changes to this section. Each of these
+ needs longer descriptions and the elements should be divided into
+ categories. The IDL for the DOM Interfaces is likely to be replaced by something
+ a lot more reader-friendly in the future; consider it a placeholder
+ for now. Attributes will likely be accompanied by brief descriptions
+ within the summary box, in addition to fuller descriptions and examples
+ afterwards.</p>
+
+ <!-- The html Element -->
<div class=element>
<h4 id=the-html-element><span class=secno>4.2.1 </span>The <dfn><code>html</code></dfn> element</h4>
<div class=summary>
@@ -1065,13 +1069,77 @@
<div class=properties>
<div class=attributes>
<h5 class="no-num no-toc" id=attributes-0>Attributes</h5>
- <ul><li><span>Global attributes</span></li><li><code title=attr-html-manifest>manifest</code></li></ul></div>
+ <ul><li><span>Global attributes</span></li><li><code title=attr-html-manifest><a href=#attr-html-manifest>manifest</a></code></li></ul></div>
<div class=dom>
<h5 class="no-num no-toc" id=dom-interface>DOM Interface</h5>
<ul><li>Uses <code>HTMLElement</code>.</li></ul></div>
</div>
</div>
- </div><div class=element>
+ </div>
+
+ <p>The <code><a href=#the-html-element>html</a></code> element is the root element of a document.
+ Every document must begin with this element, and it must contain
+ both the <code><a href=#the-head-element>head</a></code> and <code><a href=#the-body-element>body</a></code> elements.</p>
+
+ <p>It is considered good practice to specify the primary language of the
+ document on this element using the <code>lang</code> attribute.</p>
+
+ <div class=example>
+ <p>Example:</p>
+ <pre><code><!DOCTYPE html>
+<mark><html lang="en"></mark>
+ <head>
+ ...
+ </head>
+ <body>
+ ...
+ </body>
+<mark></html></mark></code></pre>
+ </div>
+
+ <p>In the HTML syntax only, both the start and end tags are optional,
+ and so for convenience either may be omitted, unless you wish to
+ specify attributes on this element, in which case, at least the start
+ tag needs to be included.</p>
+ <div class="html example">
+ <p>HTML Example:</p>
+ <pre><code><!DOCTYPE html>
+<head>
+ ...
+</head>
+<body>
+ ...
+</body>
+</code></pre>
+ </div>
+
+ <p>In the XHTML syntax, the <code>xmlns</code> attribute needs to be
+ specified on this element to declare that it is in the HTML
+ namespace. You may use either the <code>lang</code> or
+ <code>xml:lang</code> attribute to specify the langauge.</p>
+
+ <div class="xhtml example">
+ <p>XHTML Example:</p>
+ <pre><code><html <mark>xmlns="http://www.w3.org/1999/xhtml"</mark> <mark>xml:lang="en"</mark>>
+ <head>
+ ...
+ </head>
+ <body>
+ ...
+ </body>
+</html></code></pre>
+ </div>
+
+ <dl class=attributes>
+ <dt><dfn id=attr-html-manifest title=attr-html-manifest><code>manifest</code></dfn></dt>
+ <dd>The manifest attribute gives the address of the document’s
+ application cache manifest, if there is one. If the attribute is
+ present, the attribute’s value must be a valid URL.</dd>
+ </dl>
+
+ <p class=XXX>Need to describe application cache manifests.</p>
+
+ <div class=element>
<h4 id=the-head-element><span class=secno>4.2.2 </span>The <dfn><code>head</code></dfn> element</h4>
<div class=summary>
<p class=desc>The <code><a href=#the-head-element>head</a></code> element collects the document's metadata.</p>
@@ -5588,7 +5656,7 @@
they are documented here because they are supported by browsers, along with
notes about conforming alternatives that may be used instead.
- </p><p class=big-issue>This list is very incomplete. Expect more elements to be added later.</p>
+ </p><p class=XXX>This list is very incomplete. Expect more elements to be added later.</p>
<table class=index>
<thead>
@@ -5835,7 +5903,7 @@
<div class="example error">
<p>Erroneous Example:</p>
- <pre><p>This markup contains a <strong><em><strong>mistake</em></strong></strong></p>
+ <pre><p>This markup contains a <mark><em><strong>mistake</em></strong></mark></p>
</pre>
</div>
@@ -5899,7 +5967,7 @@
<div class="example xhtml">
<p>XHTML Example:</p>
- <pre><html <strong>xml:lang="en"</strong>>
+ <pre><html <mark>xml:lang="en"</mark>>
...
</html>
</pre>
@@ -5908,7 +5976,7 @@
<div class="example xhtml">
<p>XHTML Example:</p>
<pre><div>
-<<strong>svg:svg</strong>><<strong>svg:circle</strong> r="50" cx="50" cy="50" fill="green"/></svg:svg>
+<<mark>svg:svg</mark>><<mark>svg:circle</mark> r="50" cx="50" cy="50" fill="green"/></svg:svg>
</div>
</pre>
</div>
Index: Overview.src.html
===================================================================
RCS file: /sources/public/html5/html-author/Overview.src.html,v
retrieving revision 1.46
retrieving revision 1.47
diff -u -d -r1.46 -r1.47
--- Overview.src.html 6 Mar 2009 11:46:04 -0000 1.46
+++ Overview.src.html 6 Mar 2009 12:46:22 -0000 1.47
@@ -46,7 +46,7 @@
code { color:orangered }
code :link, code :visited { color:inherit }
pre code { color:inherit }
- pre strong { background: yellow; }
+ pre mark, pre strong { background: yellow; }
</style>
<link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/W3C-ED">
</head>
@@ -184,7 +184,7 @@
<section>
<h1>A Basic Document</h1>
- <p class="big-issue">The goal of this section is to walk people though creating
+ <p class="XXX">The goal of this section is to walk people though creating
<a href="examples/example01.html">example01.html</a></p>
<p>To begin, we’re going to create a very basic HTML document, which
@@ -550,7 +550,7 @@
<div class="example error">
<p>Erroneous Example:</p>
- <pre><code><section id="example">...</section <strong>id="example"</strong>></code></pre>
+ <pre><code><section id="example">...</section <mark>id="example"</mark>></code></pre>
</div>
<p>In XHTML, attribute names are case sensitive and most are defined to be
@@ -744,13 +744,6 @@
<!-- The HTML Vocabulary and APIs -->
<section>
<h1>The HTML Vocabulary and APIs</h1>
- <p class="big-issue">Expect major changes to this section. Each of these
- needs longer descriptions and the elements should be divided into
- categories. The IDL for the DOM Interfaces is likely to be replaced by something
- a lot more reader-friendly in the future; consider it a placeholder
- for now. Attributes will likely be accompanied by brief descriptions
- within the summary box, in addition to fuller descriptions and examples
- afterwards.</p>
<section>
<h1>Categories</h1>
@@ -882,8 +875,19 @@
<span>flow content</span>.
</section>
+ <!-- The Elements -->
<section>
<h1>The Elements</h1>
+
+ <p class="XXX">Expect major changes to this section. Each of these
+ needs longer descriptions and the elements should be divided into
+ categories. The IDL for the DOM Interfaces is likely to be replaced by something
+ a lot more reader-friendly in the future; consider it a placeholder
+ for now. Attributes will likely be accompanied by brief descriptions
+ within the summary box, in addition to fuller descriptions and examples
+ afterwards.</p>
+
+ <!-- The html Element -->
<div class=element>
<h2>The <dfn><code>html</code></dfn> element</h2>
<div class=summary>
@@ -918,7 +922,71 @@
<ul><li>Uses <code>HTMLElement</code>.</li></ul></div>
</div>
</div>
- </div><div class=element>
+ </div>
+
+ <p>The <code>html</code> element is the root element of a document.
+ Every document must begin with this element, and it must contain
+ both the <code>head</code> and <code>body</code> elements.</p>
+
+ <p>It is considered good practice to specify the primary language of the
+ document on this element using the <code>lang</code> attribute.</p>
+
+ <div class="example">
+ <p>Example:</p>
+ <pre><code><!DOCTYPE html>
+<mark><html lang="en"></mark>
+ <head>
+ ...
+ </head>
+ <body>
+ ...
+ </body>
+<mark></html></mark></code></pre>
+ </div>
+
+ <p>In the HTML syntax only, both the start and end tags are optional,
+ and so for convenience either may be omitted, unless you wish to
+ specify attributes on this element, in which case, at least the start
+ tag needs to be included.</p>
+ <div class="html example">
+ <p>HTML Example:</p>
+ <pre><code><!DOCTYPE html>
+<head>
+ ...
+</head>
+<body>
+ ...
+</body>
+</code></pre>
+ </div>
+
+ <p>In the XHTML syntax, the <code>xmlns</code> attribute needs to be
+ specified on this element to declare that it is in the HTML
+ namespace. You may use either the <code>lang</code> or
+ <code>xml:lang</code> attribute to specify the langauge.</p>
+
+ <div class="xhtml example">
+ <p>XHTML Example:</p>
+ <pre><code><html <mark>xmlns="http://www.w3.org/1999/xhtml"</mark> <mark>xml:lang="en"</mark>>
+ <head>
+ ...
+ </head>
+ <body>
+ ...
+ </body>
+</html></code></pre>
+ </div>
+
+ <dl class="attributes">
+ <dt><dfn title="attr-html-manifest"><code>manifest</code></dfn></dt>
+ <dd>The manifest attribute gives the address of the document’s
+ application cache manifest, if there is one. If the attribute is
+ present, the attribute’s value must be a valid URL.</dd>
+ </dl>
+
+ <p class="XXX">Need to describe application cache manifests.</p>
+
+ <div class=element>
<h2>The <dfn><code>head</code></dfn> element</h2>
<div class=summary>
<p class=desc>The <code>head</code> element collects the document's metadata.</p>
@@ -5435,7 +5503,7 @@
they are documented here because they are supported by browsers, along with
notes about conforming alternatives that may be used instead.
- <p class="big-issue">This list is very incomplete. Expect more elements to be added later.</p>
+ <p class="XXX">This list is very incomplete. Expect more elements to be added later.</p>
<table class="index">
<thead>
@@ -5685,7 +5753,7 @@
<div class="example error">
<p>Erroneous Example:</p>
<pre>
-<p>This markup contains a <strong><em><strong>mistake</em></strong></strong></p>
+<p>This markup contains a <mark><em><strong>mistake</em></strong></mark></p>
</pre>
</div>
@@ -5754,7 +5822,7 @@
<div class="example xhtml">
<p>XHTML Example:</p>
<pre>
-<html <strong>xml:lang="en"</strong>>
+<html <mark>xml:lang="en"</mark>>
...
</html>
</pre>
@@ -5764,7 +5832,7 @@
<p>XHTML Example:</p>
<pre>
<div>
-<<strong>svg:svg</strong>><<strong>svg:circle</strong> r="50" cx="50" cy="50" fill="green"/></svg:svg>
+<<mark>svg:svg</mark>><<mark>svg:circle</mark> r="50" cx="50" cy="50" fill="green"/></svg:svg>
</div>
</pre>
</div>
Received on Friday, 6 March 2009 12:46:35 UTC