DWARF 2 V2.1 Draft 1

[brender at gemevn dot zko dot dec dot com (Ron 603-884-2088)]

Gentleman,

The promised Draft 1 of the DWARF V2.1 spec has been sent to Michael and
Jim for posting on their respective sites. They should be posting it (them)
soon.

Actually, there are two versions.

 1) The "differences" document, which shows new text in red
    with distinctive underlining (so you can see it on a normal B&W printer),
    and includes change bars in the margin for both additions and deletions.

    The problem with this document is that Word 97 does such a stellar
    job of differences for tables that some of them are pretty hard to
    understand what is what. So...

 2) The "plain" document (just the lastest and greatest stuff,
    and one of the two files used to create the differences version).
    You may want to refer to this version when examining some of the big
    tables with many changes (especially, Figures 1, 2 and Appendix 1).

Notes:

  - Both documents are .pdf files. They were created with Acrobat Distiller
    V4, but supposedly are completely compatible with the many Acrobat V3
    Readers that are out there. (I did try the V3 acroread on my Tru64 UNIX
    system and all seemed to go fine.)

  - Draft 1 is intended to incorporate *all* items that have been approved
    as of 4 April (yesterday). If it should be there and ain't, holler.

  - New text is in red and distinctively underlined (as mentioned).
    Deleted text is not shown (but Word claims it could be if desired).

  - Hyperlinks are in blue. The hyperlinks for DW_TAG_* names are in
    pretty good shape. Those for DW_AT_* names are rather confused.
    And the rest have not been checked yet. So, you can probably see where
    I am going but probably can't depend on them much for navigation yet.
    (Only the two on the title page go "off document".)

    Notice that hyperlinks do not have the "traditional" HTML underline.
    This allows the same document to have usable hotlinks online, but
    result in a clean paper document when printed.

  - Section 1 is mostly unchanged and needs some work, esp wrt Version 2
    vs Version 2.1 matters -- maybe next draft...

  - There are few changes in the outline (2.4 split into 2.4 & 2.5, some
    additions at the end of Section 5) so that is easy wrt comparisons
    with the original spec. But be careful about Figure numbering --
    three pairs of Figures were combined into three single Figures,
    and one uncaptioned Figure was given a caption; so Figure numbers
    have changed around a bit.

  - Figure 2 is a work in progress. The first column corresponds to the
    original manual. The intent is that hot links will come to here.
    The second column will have links to each of the potentially several
    places where that attribute can be used, in a manner that suggests
    the purpose of the attribute. The third colum will indicate the
    semantic kind of values it can have.

  - I wasn't sure how to list and/or credit the working group on the title
    page; suggestions are welcome.

Happy reviewing!

Ron