This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 24270 - Make MediaKeySession State Definitions and Event Summary sections non-normative
Summary: Make MediaKeySession State Definitions and Event Summary sections non-normative
Status: VERIFIED FIXED
Alias: None
Product: HTML WG
Classification: Unclassified
Component: Encrypted Media Extensions (show other bugs)
Version: unspecified
Hardware: All All
: P4 normal
Target Milestone: ---
Assignee: Adrian Bateman [MSFT]
QA Contact: HTML WG Bugzilla archive list
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2014-01-10 23:31 UTC by David Dorwin
Modified: 2014-03-18 15:44 UTC (History)
2 users (show)

See Also:


Attachments

Description David Dorwin 2014-01-10 23:31:52 UTC
The MediaKeySession States section [1], which includes the MediaKeySession State Definitions [2], is non-normative. Since the states are used in normative algorithms, the definitions table should probably be normative like the Event Summary table [3].

[1] https://dvcs.w3.org/hg/html-media/raw-file/default/encrypted-media/encrypted-media.html#session-state
[2] https://dvcs.w3.org/hg/html-media/raw-file/default/encrypted-media/encrypted-media.html#session-state-list
[3] https://dvcs.w3.org/hg/html-media/raw-file/default/encrypted-media/encrypted-media.html#event-summary
Comment 1 Adrian Bateman [MSFT] 2014-01-21 15:52:21 UTC
Here's an example of a non-normative summary table:
http://www.w3.org/TR/html5/editing.html#dndevents
Comment 2 Adrian Bateman [MSFT] 2014-01-21 15:53:30 UTC
(In reply to Adrian Bateman [MSFT] from comment #1)
> Here's an example of a non-normative summary table:
> http://www.w3.org/TR/html5/editing.html#dndevents

And one for media:
http://www.w3.org/TR/html5/embedded-content-0.html#mediaevents
Comment 3 David Dorwin 2014-01-28 04:46:42 UTC
I updated the summary to reflect that these definitions should in fact be non-normative. The action for the MediaKeySession State Definitions is to change the text of its parent section to state "This section and its subsections are non-normative."

We should also make the Event Summary section non-normative.
Comment 4 Adrian Bateman [MSFT] 2014-02-21 22:44:09 UTC
(In reply to David Dorwin from comment #3)
> I updated the summary to reflect that these definitions should in fact be
> non-normative. The action for the MediaKeySession State Definitions is to
> change the text of its parent section to state "This section and its
> subsections are non-normative."

The current text says that section 2.2 is non-normative. We believe that this automatically means the subsections.

> We should also make the Event Summary section non-normative.
Fixed -> https://dvcs.w3.org/hg/html-media/rev/21cf5278e147
Comment 5 David Dorwin 2014-02-25 00:16:09 UTC
(In reply to Adrian Bateman [MSFT] from comment #4)
> (In reply to David Dorwin from comment #3)
> > I updated the summary to reflect that these definitions should in fact be
> > non-normative. The action for the MediaKeySession State Definitions is to
> > change the text of its parent section to state "This section and its
> > subsections are non-normative."
> 
> The current text says that section 2.2 is non-normative. We believe that
> this automatically means the subsections.

Section 9 currently says "This section and its subsections are non-normative." (It uses <non-normative-sections/>.) I think we should either say the same here or update section 9 and remove the template.
Comment 6 Adrian Bateman [MSFT] 2014-02-25 00:26:12 UTC
(In reply to David Dorwin from comment #5)
> Section 9 currently says "This section and its subsections are
> non-normative." (It uses <non-normative-sections/>.) I think we should
> either say the same here or update section 9 and remove the template.

Done.
https://dvcs.w3.org/hg/html-media/rev/4af01d086b6c