Skip to content

Commit

Permalink
[e] (0) Try to be a little more consistent about typographical use. (…
Browse files Browse the repository at this point in the history 
…bug 6770)

git-svn-id: http://svn.whatwg.org/webapps@3161 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Jun 1, 2009
1 parent 74911d9 commit 40a6055
Show file tree
Hide file tree
Showing 2 changed files with 42 additions and 38 deletions.
39 changes: 20 additions & 19 deletions index
View file
Expand Up @@ -1477,12 +1477,12 @@

<p>This specification refers to both HTML and XML attributes and DOM
attributes, often in the same context. When it is not clear which is
being referred to, they are referred to as <dfn id=content-attributes>content
attributes</dfn> for HTML and XML attributes, and <dfn id=dom-attributes>DOM
being referred to, they are referred to as <dfn title="">content
attributes</dfn> for HTML and XML attributes, and <dfn title="">DOM
attributes</dfn> for those from the DOM. Similarly, the term
"properties" is used for both JavaScript object properties and CSS
properties. When these are ambiguous they are qualified as object
properties and CSS properties respectively.</p>
properties. When these are ambiguous they are qualified as <dfn title="">object properties</dfn> and <dfn title="">CSS properties
respectively</dfn>.</p>

<p>The term <a href=#html-documents>HTML documents</a> is sometimes used in
contrast with <a href=#xml-documents>XML documents</a> to specifically mean
Expand All @@ -1496,16 +1496,16 @@
out by explicitly stating that it does not apply to the other
format, as in "for HTML, ... (this does not apply to XHTML)".</p>

<p>This specification uses the term <i>document</i> to
<p>This specification uses the term <dfn title="">document</dfn> to
refer to any use of HTML, ranging from short static documents to
long essays or reports with rich multimedia, as well as to
fully-fledged interactive applications.</p>

<p>For simplicity, terms such as <i>shown</i>, <i>displayed</i>,
and <i>visible</i> might sometimes be used when referring to the
way a document is rendered to the user. These terms are not meant to
imply a visual medium; they must be considered to apply to other
media in equivalent ways.</p>
<p>For simplicity, terms such as <dfn title="">shown</dfn>, <dfn title="">displayed</dfn>, and <dfn title="">visible</dfn> might
sometimes be used when referring to the way a document is rendered
to the user. These terms are not meant to imply a visual medium;
they must be considered to apply to other media in equivalent
ways.</p>

<p>When an algorithm B says to return to another algorithm A, it
implies that A called B. Upon returning to A, the implementation
Expand Down Expand Up @@ -1593,17 +1593,17 @@
of the more accurate "an object implementing the interface
<code>Foo</code>".</p>

<p>A DOM attribute is said to be <i>getting</i> when its value is
<p>A DOM attribute is said to be <dfn title="">getting</dfn> when its value is
being retrieved (e.g. by author script), and is said to be
<i>setting</i> when a new value is assigned to it.</p>
<dfn title="">setting</dfn> when a new value is assigned to it.</p>

<p>If a DOM object is said to be <dfn id=live>live</dfn>, then that means
that any attributes returning that object <span class=impl>must</span> always return the same object (not a new
object each time), and the attributes and methods on that object
<span class=impl>must</span> operate on the actual underlying
data, not a snapshot of the data.</p>

<p>The terms <i>fire</i> and <i>dispatch</i> are used
<p>The terms <dfn title="">fire</dfn> and <dfn title="">dispatch</dfn> are used
interchangeably in the context of events, as in the DOM Events
specifications. <a href=#refsDOM3EVENTS>[DOM3EVENTS]</a></p>

Expand Down Expand Up @@ -1650,7 +1650,7 @@

<h4 id=resources><span class=secno>2.1.6 </span>Resources</h4>

<p>The specification uses the term <i>supported</i> when referring
<p>The specification uses the term <dfn title="">supported</dfn> when referring
to whether a user agent has an implementation capable of decoding
the semantics of an external resource. A format or type is said to
be <i>supported</i> if the implementation can process an external
Expand Down Expand Up @@ -56605,12 +56605,12 @@ http://developer.apple.com/documentation/AppleApplications/Conceptual/SafariJSPr
history</a> consists of batches of one or more of the
following:</p>

<ul><li>Changes to the <a href=#content-attributes>content attributes</a> of an
<code>Element</code> node.</li>
<ul><li>Changes to the content attributes of an <code>Element</code>
node.</li>

<li>Changes to the <a href=#dom-attributes>DOM attributes</a> of a
<code>Node</code>.</li> <!-- XXX uh, these change on their own, so
clearly this isn't going to fly. Which DOM attributes, exactly? -->
<li>Changes to the DOM attributes of a <code>Node</code>.</li> <!--
XXX uh, these change on their own, so clearly this isn't going to
fly. Which DOM attributes, exactly? -->

<li>Changes to the DOM hierarchy of nodes that are descendants of
the <code><a href=#htmldocument>HTMLDocument</a></code> object (<code>parentNode</code>,
Expand Down Expand Up @@ -70910,6 +70910,7 @@ S SPACER STRIKE TT U -->
Martin Kutschker,
Masataka Yakura,
Mathieu Henri,
Matt Schmidt,
Matt Wright,
Matthew Gregan,
Matthew Mastracci,
Expand Down
41 changes: 22 additions & 19 deletions source
View file
Expand Up @@ -429,12 +429,13 @@

<p>This specification refers to both HTML and XML attributes and DOM
attributes, often in the same context. When it is not clear which is
being referred to, they are referred to as <dfn>content
attributes</dfn> for HTML and XML attributes, and <dfn>DOM
being referred to, they are referred to as <dfn title="">content
attributes</dfn> for HTML and XML attributes, and <dfn title="">DOM
attributes</dfn> for those from the DOM. Similarly, the term
"properties" is used for both JavaScript object properties and CSS
properties. When these are ambiguous they are qualified as object
properties and CSS properties respectively.</p>
properties. When these are ambiguous they are qualified as <dfn
title="">object properties</dfn> and <dfn title="">CSS properties
respectively</dfn>.</p>

<p>The term <span>HTML documents</span> is sometimes used in
contrast with <span>XML documents</span> to specifically mean
Expand All @@ -448,16 +449,17 @@
out by explicitly stating that it does not apply to the other
format, as in "for HTML, ... (this does not apply to XHTML)".</p>

<p>This specification uses the term <i>document</i> to
<p>This specification uses the term <dfn title="">document</dfn> to
refer to any use of HTML, ranging from short static documents to
long essays or reports with rich multimedia, as well as to
fully-fledged interactive applications.</p>

<p>For simplicity, terms such as <i>shown</i>, <i>displayed</i>,
and <i>visible</i> might sometimes be used when referring to the
way a document is rendered to the user. These terms are not meant to
imply a visual medium; they must be considered to apply to other
media in equivalent ways.</p>
<p>For simplicity, terms such as <dfn title="">shown</dfn>, <dfn
title="">displayed</dfn>, and <dfn title="">visible</dfn> might
sometimes be used when referring to the way a document is rendered
to the user. These terms are not meant to imply a visual medium;
they must be considered to apply to other media in equivalent
ways.</p>

<p>When an algorithm B says to return to another algorithm A, it
implies that A called B. Upon returning to A, the implementation
Expand Down Expand Up @@ -555,9 +557,9 @@
of the more accurate "an object implementing the interface
<code>Foo</code>".</p>

<p>A DOM attribute is said to be <i>getting</i> when its value is
<p>A DOM attribute is said to be <dfn title="">getting</dfn> when its value is
being retrieved (e.g. by author script), and is said to be
<i>setting</i> when a new value is assigned to it.</p>
<dfn title="">setting</dfn> when a new value is assigned to it.</p>

<p>If a DOM object is said to be <dfn>live</dfn>, then that means
that any attributes returning that object <span
Expand All @@ -566,7 +568,7 @@
<span class="impl">must</span> operate on the actual underlying
data, not a snapshot of the data.</p>

<p>The terms <i>fire</i> and <i>dispatch</i> are used
<p>The terms <dfn title="">fire</dfn> and <dfn title="">dispatch</dfn> are used
interchangeably in the context of events, as in the DOM Events
specifications. <a href="#refsDOM3EVENTS">[DOM3EVENTS]</a></p>

Expand Down Expand Up @@ -615,7 +617,7 @@

<h4>Resources</h4>

<p>The specification uses the term <i>supported</i> when referring
<p>The specification uses the term <dfn title="">supported</dfn> when referring
to whether a user agent has an implementation capable of decoding
the semantics of an external resource. A format or type is said to
be <i>supported</i> if the implementation can process an external
Expand Down Expand Up @@ -66379,12 +66381,12 @@ http://developer.apple.com/documentation/AppleApplications/Conceptual/SafariJSPr

<ul>

<li>Changes to the <span>content attributes</span> of an
<code>Element</code> node.</li>
<li>Changes to the content attributes of an <code>Element</code>
node.</li>

<li>Changes to the <span>DOM attributes</span> of a
<code>Node</code>.</li> <!-- XXX uh, these change on their own, so
clearly this isn't going to fly. Which DOM attributes, exactly? -->
<li>Changes to the DOM attributes of a <code>Node</code>.</li> <!--
XXX uh, these change on their own, so clearly this isn't going to
fly. Which DOM attributes, exactly? -->

<li>Changes to the DOM hierarchy of nodes that are descendants of
the <code>HTMLDocument</code> object (<code>parentNode</code>,
Expand Down Expand Up @@ -83570,6 +83572,7 @@ S SPACER STRIKE TT U -->
Martin Kutschker,
Masataka Yakura,
Mathieu Henri,
Matt Schmidt,
Matt Wright,
Matthew Gregan,
Matthew Mastracci,
Expand Down

0 comments on commit 40a6055

Please sign in to comment.