416391 - (avmspec) Tracking bug for Doxygen AVM2 Spec

Status: RESOLVED WONTFIX

(Tamarin Graveyard :: Documentation, defect)

Description

[Lars T Hansen]

Right now the AVM2 spec (defining the instruction set and the ABC format) lives in a source repository at Adobe.  In addition, is a MS Word document.  As if that weren't enough, Edwin says there's a text file elsewhere that is really the canonical definition of the ABC format.

Obviously this situation is untenable.

When we have time we should merge the docs into an single doc in an open format and store it in the TC/TT repositories.

Comment 1

[Lars T Hansen]

Note, The AVM2 spec in the Adobe perforce repository is clearly not complete, because there are attribute bits (like METHOD_Native) in the ABC format that are crucial to its operation that are not described in that document.

Edwin, where is the canonical ABC documentation?

Comment 2

[Edwin Smith]

core/abcFormat.txt

Comment 3

[Lars T Hansen]

BTW discussed this a bit with Jeff on Friday and agreed that what the AVM needs is a proper language spec, seeing that ABC is a language.  This particularly interesting in the context of the latest (Adobe-internal) discussions on overload/inheritance conflict resolution.

Comment 4

[Edwin Smith]

agree, and this is consistent with the worldview that abc == source 

Comment 5

[Lars T Hansen]

I am told that we need management approval to move the avm2overview.doc sources into Tamarin (I would prefer HTML or similar, not doc, but the point stands).  Assigning to Dan in the hope that approval will be granted.

Comment 6

[Andre Kruetzfeldt]

moving bug to Ed