W3C home > Mailing lists > Public > www-svg@w3.org > May 2005

[SVGMobile12] Comments: Document Structure (partial comments)

From: Boris Zbarsky <bzbarsky@mit.edu>
Date: Tue, 17 May 2005 15:57:28 -0500
Message-ID: <428A5AB8.4050705@mit.edu>
To: www-svg@w3.org

5.1.1

What happens if an <svg> element contains both SVG and non-SVG elements?  Do we 
still have an "SVG document fragment"?  If so, which nodes does it contain?  All 
SVG nodes which have the <svg> as ancestor?  Or only those nodes that are in a 
maximal SVG-node-only subtree?

I think using "stand-alone" to describe an XML document that has 
|standalone="no"| (second example in this section) is somewhat confusing.

"An SVG document fragment can only contain one single 'svg' element, this means 
that 'svg' elements cannot appear in the middle of SVG content." -- what happens 
if they do?  Link to that here, please.

5.1.2

   For SVG 1.2, the attribute should have the value "1.2".

That implies that this is optional.  What if it doesn't?

The <meet> part of the preserveAspectRatio attribute is called <meetOrSlice> 
elsewhere in this specification.

"Indicates if the content can be seeked backwards or not." -- there is no past 
participle "seeked" in the English language and the general grammar of this 
sentence should be fixed (for example, "if" is being used where "whether" should 
be used).

Why is the string "playbackOrder", used three times in this paragraph, linked 
once, and in blue twice (including the time it's linked)?  Please be consistent 
with this!

The acronym "UI" which is used here is not defined anywhere.

"An SVG document should include a viewBox attribute on the 'svg' element of the 
referenced document." -- which referenced document?  What if it doesn't?  It's 
not clear to me what this sentence means.

The phrase "world coordinate space" is not defined anywhere that I can see.

The examples "width-height.svg" and "viewBox.svg" tell me absolutely nothing 
about what specifying the viewBox actually does.  The correct behavior for these 
examples should probably be described.

5.2.1

It's not clear whether the <g> element itself is painted, and if so how.

5.4

The terms "simple duration" and "active duration" are used in this section 
without having been defined anywhere.  Please link to their definitions.

What does "The removal operation acts as if the method removeChild was called on 
the parent of the target element" mean?  Note that it's not clear whether this 
means |parent.removeChild()|, |parent.removeChild(child)|, or 
|removeChild(parent)|.  Also, should the relevant DOM events fire?  Should it be 
possible, via DOM, to reinsert the discarded content elsewhere in the document 
tree?  If so, what should happen?

5.5

"where the description is text-only" -- what if it's not?

What is the difference between <desc> and <title>?  Why are both present here?

"If user agents need to choose among multiple 'desc' or 'title' elements for 
processing (e.g., to decide which string to use for a tooltip), the user agent 
shall choose the first one."  This should probably be a "must", not a "shall".

5.6

What does "contents of the referenced element" mean?  Does it include the 
referenced element itself?  Example 05_13.svg seems to imply that it does, but 
this is not clearly stated anywhere.

The term "deeply cloned child of the 'use' element" is used repeatedely without 
being defined.  I'm not quite sure what it means.

The term "instance tree" is used without being defined.  I'm not quite sure what 
it means.

The example using "visibility" should probably talk about computed values, not 
specified values.

What happens if the <use> references an element that is not an SVG element?  Is 
the same procedure applied?

-Boris
Received on Tuesday, 17 May 2005 20:57:45 GMT

This archive was generated by hypermail 2.3.1 : Friday, 8 March 2013 15:54:30 GMT