Document @title on @class=example

[azaroth42]

Not sure if this belongs here, but it would be great if the use of a title attribute on a section with class="example" to generate a title could be documented.

For example here: http://www.w3.org/respec/guide.html#examples-syntax-highlighting

[halindrome]

According to the code, if you have an 'example' then a div is created with the class 'example-title'. That div will contain a 'span' with the text "Example N" where N is the example number that is automatically generated. If there is a title attribute on the element, then a colon and the text of the title attribute are appended to the contents of the span. E.g., <pre class='example' title='My Important Example'>some example</pre> will be prepended with <div class='example-title'><span>Example N</span>: My Important Example</div>

Is that the behavior you are seeing? And is that what you would like documented?

[azaroth42]

Yes, that's exactly what I'm seeing, expecting and would like to be documented in the reference and/or user guide :)

[halindrome]

This issue was moved to w3c/respec-docs#17