Re: Comments on MathML Last Call Draft

"What a firestorm! ... If I am missing anything major, maybe someone could 
post that."

Here is more (fire). Hope it helps.

Pankaj Kamthan
--
GENERAL

1. MathML Specification refers to both CSS1 (for example, 2.3.4.3) and CSS2 
(for example, 3.5.1.2). Shouldn't the reference be to CSS2  (which 
supersedes CSS1) throughout the MathML Specification?

2. Suggestion to change the name of definitionURL to definitionURI. Rationale: 
(1)  URIs are in the works to, among other things, extend the mechanism of 
URLs (which lack persistence). (2) It will include use of URLs, as well as, 
URNs (persistent). (3) XML Namespaces Recommendation uses URIs. 

SPECIFIC

Notation
In the foregoing, I'm using:
[prose with problems] -> [prose with suggested corrections]

Chapter 1

1.2.5
Extensible Style Language (XSL) -> Extensible Stylesheet Language (XSL) 

Chapter 2 

2.2.1 Presentation Examples, 2.2.2 Content Examples but 2.2.3 Mixed 
Markup Examples 

2.2.1
is explcitly ... -> is explicitly ...

2.3.4
references for most synbols is ... -> references for most symbols is 

2.3.4.1
on a scale of x00 through xFF, ... -> on a scale of x00 through xff, ... 
(as #rrggbb and #5599dd use lowercase)
The phrase "explained in CSS subsection, below" at two places could 
provide a link to 2.3.4.3, and then one would not need to include ", below".

2.3.4.3
Several MathML attributes, ... defined by Cascading Style Sheets, Level 1 
(CSS1).
Expanded form for CSS1 is not needed here. (The same for 2.3.5 and 
4.3.3.2.) It should be placed at the first appearance with a link to the 
W3C Recommendation, and the acronym could be used thereafter.

2.3.4.4
This point of view is carried through to the MathML schema -> This point 
of view is carried through to the MathML schema.

2.3.4.5
... for all MathML attributqes, including ... -> ... for all MathML 
attributes, including ...

Chapter 3

3.2.1
"MathML expressions are often embedded in a textual data format such as 
HTML, ..."
May be XHTML 1.0 instead of HTML.

3.5.3.3
is intended to facilitate XSL processing -> is intended to facilitate 
XSLT processing

Chapter 4

4.2.1.3
definitionURL="www.vnbooks.com/VectorCalculus.htm" -> 
definitionURL="http://www.vnbooks.com/VectorCalculus.htm"

definitionURL="www.mathslib.com/vectorfuncs/plus.htm" -> 
definitionURL="http://www.mathslib.com/vectorfuncs/plus.htm"

4.2.2.1
definitionURL="www.vnbooks.com/ContDiffFuncs.htm" -> 
definitionURL="http://www.vnbooks.com/ContDiffFuncs.htm"

4.2.3.2
The expression
<fn>
  <apply>
    <int/>
    <bvar><ci>x</ci></bvar>
    <lowlimit><cn>0</cn></lowlimit>
    <uplimit><cn>1</cn></uplimit>
  </apply>
</fn>
without the <fn>, as it is deprecated.

4.2.5
definitionURL="www.naturalnums.htm" -> 
definitionURL="http://www.naturalnums.htm"

definitionURL="www.primes.htm" -> 
definitionURL="http://www.primes.htm" 

4.4.1.3
definitionURL="www.openmath.org/cds/BesselFunctions.ocd"> -> 
definitionURL="http://www.openmath.org/cds/BesselFunctions.ocd">

definitionURL="www.uni.edu/universalconstants/Boltzmann.htm"> -> 
definitionURL="http://www.uni.edu/universalconstants/Boltzmann.htm">

4.4.6.9
The default rendering (the image) of the Example in 4.4.6.9 should be 
interchanged with that of the Example in 4.4.6.10.

4.4.10.7
The default rendering is incomplete (it does not have any equality or 
"sine" term thereafter).

4.4.10.8
The default rendering is incomplete (it does not have any equality or 
"cosine" term thereafter). 

The "dot" between A and B in the default rendering should be in the 
middle.

4.4.10.9
The "dot" between A and B in the default rendering should be in the 
middle.

4.4.12.7
"ln" should be upright (and not slanted). Probably, the same in 4.4.12.10 
and 4.4.12.11.

Chapter 5 

5.4 and other sections mention XSLT but there is no reference to what the 
acronym stands for (XSL Transformations) or what it means (reference to 
the XSLT Recommendation). 

5.4 
In general, the interaction of content an presentation ... -> In general, 
the interaction of content and presentation ... 

5.4.3
It should be mentioned that "mx" is a non-MathML namespace prefix (and 
that a-factorial, rank, etc. are from that namespace).

Chapter 7

7.1
"Indeed, XHTML already renders properly in HTML 4 user agents."

Yes, but only when the Appendix C. HTML Compatibility Guidelines are 
followed.

7.1.3
"This is primarily useful when referencing separate files containing MathML 
markup from an EMBED or OBJECT element."
 
EMBED element is not part of standard HTML 4.01. 

Appendix A

Normally. however, a MathML ... -> 
Normally, however, a MathML ...

... treat the whitespace whitespace characters ... -> 
... treat the whitespace characters ... 

A.1
MathML2 DTD SYSTEM identifier is given to be SYSTEM "mathml2.dtd".
Is that canonical?

A.1 mentions "A zip file of the full DTD including entity declarations 
is provided for reference." It is unclear where, as the downloadable 
version of MathML 2.0 doesn't include it nor does it provide a pointer.

Appendix G

Roger Hunter is not mentioned here but is in the list of authors 
(overview.html) and E.1. 

Appendix H

It is incomplete. It does not mention: The addition of 5.3 Parallel 
Markup. The addition of 5.4 (which is a sort of renaming 5.3 from MathML 
1.01). Reordering of sections in Chapter 6 (6.2 became 6.1.3). Unavailability 
of (and removal of links for) Basic and Extended glyphs.

Received on Monday, 1 May 2000 23:04:53 UTC