W3C home > Mailing lists > Public > www-math@w3.org > October 2012

Re: mglyph, semantics, Content Markup missing in navigation

From: David Carlisle <davidc@nag.co.uk>
Date: Mon, 01 Oct 2012 09:26:32 +0100
Message-ID: <506953B8.3030407@nag.co.uk>
To: Jim Michaels <jmichae3@yahoo.com>
Cc: "www-math@w3.org" <www-math@w3.org>
On 01/10/2012 08:43, Jim Michaels wrote:
> MathML 3.0 current TR http://www.w3.org/TR/MathML3/
>
> the section title Attribution via semantics could perhaps have been
> called Attribution via <semantics>
>
> most of Content Markup elements are missing in navigation, if indeed
>  they belong there at all: MathML 3.0 contains *parts* (but not all)
> of Content Markup in the TR's navigation, however, in the
> documenation, it lists quite a few more elements for Content Markup
> than are in the navigation. Part of the problem is, there are SOME
> Content Markup elements in the navigation, but not ALL. putting all
> of them in would make the navigation consistent with the formatting
> of the previous half of the document.
>
> if this is a living standard type of document, then OK. I can accept
> that it is still "in process".  but if this is not,then please fix.
> it is confusing browser developers.
>
> <mglyph/> is not listed in the navigation, but is listed in the
> documentation. ------------- Jim Michaels

Thank you for you message but as I mentioned when you sent the same
wording to the HTML WG bugzilla, your comments are not at all clear, I'm
not sure what changes you would like us to make.

Taking them out of order.

The subject line refers to Content MathML but you comment that
mglyph (which is not a content mathml element) is not in "the
navigation" by which I assume you mean the table of contnts?
mglyph is in the table of contents for presentation mathml,

http://www.w3.org/Math/draft-spec/chapter3.html

linking to

http://www.w3.org/Math/draft-spec/chapter3.html#presm.mglyph



As to your main point about content elements not being in the table of
contents, the main set that do not have their own section are the
trigonometric functions which are all listed under

4.4.7.1 Common trigonometric functions
http://www.w3.org/Math/draft-spec/chapter4.html#contm.sin

All these elements operate in exactly the same way and it would serve no
purpose to make the chapter significantly longer duplicating the
description for each one under a separate heading.


If however you want to mechanically generate links back from an instance
of a particular function to the description of the element in the spec,
the anchors are all there, so for example for <sin/> you can link to

http://www.w3.org/Math/draft-spec/chapter4.html#contm.sin



I hope that clarifies thing, if there are any specific changes that you
think we should make, please do post again.

David

________________________________________________________________________
The Numerical Algorithms Group Ltd is a company registered in England
and Wales with company number 1249803. The registered office is:
Wilkinson House, Jordan Hill Road, Oxford OX2 8DR, United Kingdom.

This e-mail has been scanned for all viruses by Star. The service is
powered by MessageLabs. 
________________________________________________________________________
Received on Monday, 1 October 2012 08:27:00 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 1 October 2012 08:27:00 GMT