b702b75b41b4f9178575b608627b08bd84e54817
[dwarf-doc.git] / dwarf5 / latexdoc / foreword.tex
1 \renewcommand{\abstractname}{Foreword}
2 \setlength{\parindent}{0pt}
3 \begin{abstract}
4 \nonzeroparskip
5 \setlength{\parindent}{0pt}
6 The \dwf\ Committee was originally organized in 1988 as the
7 Programming Languages Special Interest Group (PLSIG) of Unix
8 International, Inc., a trade group organized to promote Unix
9 System V Release 4 (SVR4).
10
11 PLSIG drafted a standard for \addtoindex{DWARF Version 1}, compatible with
12 the DWARF debugging format used at the time by SVR4 compilers
13 and debuggers from AT\&T.  This was published as Revision 1.1.0
14 on October 6, 1992. PLSIG also designed the \addtoindex{DWARF Version 2}
15 format, which followed the same general philosophy as Version
16 1, but with significant new functionality and a more compact,
17 though incompatible, encoding.  An industry review draft
18 of \addtoindex{DWARF Version 2} was published as Revision 2.0.0 on July
19 27, 1993.
20
21 Unix International dissolved shortly after the draft of
22 Version 2 was released; no industry comments were received or
23 addressed, and no final standard was released. The committee
24 mailing list was hosted by OpenGroup (formerly XOpen).
25
26 The Committee reorganized in October, 1999, and met for the
27 next several years to address issues that had been noted with
28 \addtoindex{DWARF Version 2} as well as to add a number of new features.
29 In mid-2003, the Committee became a workgroup under the Free
30 Standards Group (FSG), a industry consortium chartered to
31 promote open standards. \addtoindex{DWARF Version 3} was published on
32 December 20, 2005, following industry review and comment.
33
34 The DWARF Committee withdrew from the Free Standards Group
35 in February, 2007, when FSG merged with the Open Source
36 Development Labs to form The Linux Foundation, more narrowly
37 focused on promoting Linux. The DWARF Committee has been
38 independent since that time.
39
40 It is the intention of the DWARF Committee that migrating
41 from \addtoindex{DWARF Version 2} or Version 3 
42 \addtoindexx{DWARF Version 3}
43 or Version 4 to later versions should
44 be straightforward and easily accomplished. 
45 Almost all 
46 \addtoindex{DWARF Version 2} 
47 and Version 3 
48 \addtoindexx{DWARF Version 3}
49 constructs have been retained unchanged
50 \addtoindexx{DWARF Version 4}
51 in DWARF Version 4.
52
53 The \dwf\ Committee is open to compiler and debugger
54 developers who have experience with source language debugging
55 and debugging formats, and have an interest in promoting or
56 extending the DWARF debugging format.
57 \clearpage
58 DWARF Committee members contributing to Version 4 are:
59 \begin{center}
60 \begin{tabular}{ll}
61 Todd Allen&Concurrent Computer\\
62 David Anderson\\
63 John Bishop&Intel\\
64 Jim Blandy&CodeSourcery\\
65 Ron Brender, Editor\\
66 Andrew Cagney\\
67 Siu Chi Chan&IBM\\
68 Cary Coutant&Google\\
69 John DelSignore&TotalView\\
70 Michael Eager, Chair&Eager Consulting\\
71 Ben Elliston&IBM\\
72 Mike Gleeson&Hewlett-Packard\\
73 Mathhew Gretton-Dan&ARM\\
74 David Gross&Hewlett-Packard\\
75 Tommy Hoffner&IBM\\
76 Jason Molenda&Apple\\
77 David Moore&Intel\\
78 Jeff Nelson&Hewlett-Packard\\
79 Chris Quenelle&Sun Microsystems\\
80 Paul Robinson&Hewlett-Packard\\
81 Bill White&TotalView\\
82 Kendrick Wong&IBM\\
83 \end{tabular}
84 \end{center}
85
86 For further information about 
87 DWARF or the DWARF Committee,
88 see:
89
90 % For unclear reasons, simply adding the url
91 % to the sentence here makes the url extend past the
92 % end of the line and generates a warning and
93 % ugly output.
94 \begin{myindentpara}{1cm}
95 \url{http://www.dwarfstd.org} 
96 \end{myindentpara}
97
98 This document is intended to be usable in online as well as
99 traditional paper forms. 
100 In the online form, blue text is
101 used to indicate hyperlinks which facilitate moving around
102 in the document in a manner like that typically found in web
103 browsers.
104 Most hyperlinks link to the definition of a term or
105 construct, or to a cited Section or Figure.
106 However, attributes
107 in particular are often used in more than one way or context so
108 that there is no single definition; for attributes, hyperlinks
109 link to the introductory list of all attributes which in turn
110 contains hyperlinks for the multiple usages.
111 The Table of
112 Contents also provides hyperlinks to the respective sections.
113
114 In the traditional paper form, the appearance of the hyperlinks
115 on a page of paper does not distract the eye because the blue
116 hyperlinks are typically imaged by black and white printers in
117 a manner nearly indistinguishable from other text. 
118 (Hyperlinks
119 are not underlined for this same reason.) 
120 Page numbers,
121 a Table of Contents, a List of Figures and an Index are
122 included in both online and paper forms.
123
124 \end{abstract}