New ES6 draft (Rev23) now available
This version has undergone major internal restyling and seems to be in good shape for driving to ES6 completion.
All of the algorithms lists have new internal styling. However, because of the nature of MS Word numbered lists, it is quite likely some some slipped past me where the algorithm steps don't start at 1. If you see any please report them as a new bug at bugs.ecmascript.org.
On Sun, Apr 6, 2014 at 1:41 PM, Allen Wirfs-Brock <allen at wirfs-brock.com> wrote:
The April 5, 2014 ECMAScript 6 Draft Specification (Rev23) is now available at harmony:specification_drafts#april_5_2014_draft_rev_23
The HTML version is up at: people.mozilla.org/~jorendorff/es6-draft.html
As always, this is generated by the script at jorendorff/es-spec-html and you could totally knock out some of those issues and make it better.
Thanks a lot Jason, would you mind double check after latest TC39 meeting no major changes has been left out these version?
Andrea, that was published before the meeting, so it's actually missing everything from the meeting. Allen will be publishing drafts more frequently from here on.
On 14-04-06 11:41 AM, Allen Wirfs-Brock wrote:
The April 5, 2014 ECMAScript 6 Draft Specification (Rev23) is now available at harmony:specification_drafts#april_5_2014_draft_rev_23
I just noticed something odd.
If you open up the PDFs for rev22 and rev23, and compare section 7.3.16 "GetPrototypeFromConstructor", you'll see that the sub-steps that used to be 5.{a,b,c} are now top-level steps {6,7,8}. It's pretty clear that this wasn't an intentional change, because now step 5 is an if-then with no consequent. To make matters worse, if you open up the PDF with change markup, you'll see that this change isn't called out at all. (The only marked change in the whole algorithm is a minor deletion in step 3.)
Also, the Note that used to follow the algorithm is now step 10 of the algorithm. I'm guessing this is also unintentional, though it's less obviously so. But it too has no change markup.
(I don't have MS Word, but if LibreOffice is anything to go by, these changes aren't marked in the Word document either.)
It's odd and somewhat worrying that algorithm steps can change their level seemingly spontaneously, and without any resultant change markup.
Allen, you did say that all the algorithms have new internal styling, but the only side-effect you mentioned was that some might not start at step 1.
Of course, I'll file a bug for this case, and any other I see, but (a) I'll probably miss some, and (b) this seems like something that I (or any other reviewer) shouldn't have to be doing -- shouldn't the spec-production process be more resistant to silent unintended changes?
On Thu, Apr 10, 2014 at 11:45 PM, Michael Dyck <jmdyck at ibiblio.org> wrote:
I just noticed something odd.
If you open up the PDFs for rev22 and rev23, and compare section 7.3.16 "GetPrototypeFromConstructor", you'll see that the sub-steps that used to be 5.{a,b,c} are now top-level steps {6,7,8}.
I found a similar case earlier today—only the opposite direction, a step was indented more than before—and filed the bug: ecmascript#2633
It's pretty clear that this wasn't an intentional change, because now step 5 is an if-then with no consequent.
The sequence 'then</li>' appears five times in es6-draft.html. All are
bugs. I filed: ecmascript#2634
Maybe others can think of quick ways to hunt for similar issues.
rev22 - people.mozilla.org/~jorendorff/es6-draft-rev-22.html
You can/should file this but Allen and I discusses the issue at the face to face and Allen assured me a new draft, hopefully fixed, will be published sooner.
On Apr 10, 2014, at 9:45 PM, Michael Dyck wrote:
On 14-04-06 11:41 AM, Allen Wirfs-Brock wrote:
The April 5, 2014 ECMAScript 6 Draft Specification (Rev23) is now available at harmony:specification_drafts#april_5_2014_draft_rev_23
I just noticed something odd.
If you open up the PDFs for rev22 and rev23, and compare section 7.3.16 "GetPrototypeFromConstructor", you'll see that the sub-steps that used to be 5.{a,b,c} are now top-level steps {6,7,8}. It's pretty clear that this wasn't an intentional change, because now step 5 is an if-then with no consequent. To make matters worse, if you open up the PDF with change markup, you'll see that this change isn't called out at all. (The only marked change in the whole algorithm is a minor deletion in step 3.)
Also, the Note that used to follow the algorithm is now step 10 of the algorithm. I'm guessing this is also unintentional, though it's less obviously so. But it too has no change markup.
(I don't have MS Word, but if LibreOffice is anything to go by, these changes aren't marked in the Word document either.)
The markup was generated after the fact by having Word compare clean copies of rev22 and rev23. Formatting change (which including numbering level changes) were intentionally not included in the markup as they are so numerous (and mostly reflect no meaning change) as to be useless.
In order to get with an internal Word limit relating to lists I had to reapply the list style of essentially all algorithms and there are no doubt a few bugs in the processes. The internal limit is on what Word calls a "numId". The limit is 2047 and we had been bumping against it for several editions. Rev23 uses about 1500 numIds (ie 75% of the limit) so we appear to be in pretty good shape through the completion of ES6. I don't foresee the need for another round of changes of this sort before final publication.
It's odd and somewhat worrying that algorithm steps can change their level seemingly spontaneously, and without any resultant change markup.
It's not really spontaneous and the exclusion from the markup is intentional. It is possible to generate markup that includes such formatting changes is anyone really things they can extract useful information form it.
Allen, you did say that all the algorithms have new internal styling, but the only side-effect you mentioned was that some might not start at step 1.
The starting number issue is the closest to being "spontaneous" (they really aren't, but sometimes it feels that way). Things like 7.3.16 is just an error on may part and are easily fixed when they are identified.
Of course, I'll file a bug for this case, and any other I see, but (a) I'll probably miss some, and (b) this seems like something that I (or any other reviewer) shouldn't have to be doing -- shouldn't the spec-production process be more resistant to silent unintended changes?
These are the result of the normal production process, but of one-time (hopefully) massive manual edits.
4.3.25 doesn't seem to have a title name in the HTML export. I'm assuming some sort of Word black magic is to blame?
wrong styling in the source document...fixed
The April 5, 2014 ECMAScript 6 Draft Specification (Rev23) is now available at harmony:specification_drafts#april_5_2014_draft_rev_23
Changes include: