29513 2016-03-02 11:26:19 +0000 [XSL30] Definition of "potentially consuming" in Glossary not complete 2016-07-21 16:33:23 +0000 1 1 1 Unclassified XPath / XQuery / XSLT XSLT 3.0 Candidate Recommendation PC Windows NT CLOSED FIXED P2 editorial --- 29516 1 abel.braaksma mike public-qt-comments oldest_to_newest 125320 0 abel.braaksma 2016-03-02 11:26:19 +0000 The definition of "potentially consuming" in section C Glossary reads: <quote> potentially consuming An operand is potentially consuming if either or both of the following conditions applies: </quote> In other words, the important part of the definition, after the colon, has disappeared. 125321 1 abel.braaksma 2016-03-02 11:27:13 +0000 (and shouldn't it be "apply" instead of "applies"?) 125322 2 mike 2016-03-02 12:36:05 +0000 Yes I've been frustrated by this limitation in the markup design for a long time: we don't have the ability for a definition to span multiple paragraphs. I have a feeling some of the other specs have solved the issue, I need to find out how. 125323 3 mike 2016-03-02 12:42:23 +0000 The serialization spec has many definitions that end in mid-sentence like this, but I noticed that they've solved the problem in section 9 for the definition of serializing "to a JSON string" which is a multi-paragraph definition. So we should find out how they did it. 125347 4 mike 2016-03-04 00:03:00 +0000 In the latest editor's draft I have fixed this using the markup suggested in bug #29516. I haven't yet committed the DTD changes needed to validate this markup; the DTDs are shared documents and consensus is needed to change them. For some reason I don't like "either or both of these conditions apply" (it just sounds wrong although the text books say it's right), so I changed it to "at least one of these conditions applies". 125678 5 abel.braaksma 2016-03-31 21:32:35 +0000 I can see the fix in the current internal draft and it looks correct, should we close this bug report? 125679 6 mike 2016-03-31 21:58:06 +0000 I'll close it when I have done a few more tests to ensure that the stylesheet changes have no adverse effects on other specs, and when I have committed all the changes. 126955 7 mike 2016-07-14 22:13:59 +0000 The DTD and stylesheet extensions to handle multi-paragraph glossary definitions have now been committed. 127008 8 abel.braaksma 2016-07-20 14:11:02 +0000 I checked the diff version and the normal version of the internal WD's, they both look good and I didn't see other definitions in this section being disrupted (some got better though). I think this can be closed now. Note: this change influenced the definition of "combined posture", "tail position" and "non-positional predicate", which previously all ended with a colon (:) and a missing list paragraph, but are now complete with the full definition of the text.