Incorporate changes as of the May 17 meeting. The corresponding
[dwarf-doc.git] / dwarf5 / latexdoc / foreword.tex
index 0a91b74..3cf6959 100644 (file)
@@ -1,7 +1,7 @@
-\renewcommand{\abstractname}{Foreword}
+\renewcommand{\abstractname}{\Large Foreword}
 \begin{abstract}
-\nonzeroparskip
 \setlength{\parindent}{0pt}
+\nonzeroparskip
 \ \break
 The \dwf\ Committee was originally organized in 1988 as the
 Programming Languages Special Interest Group (PLSIG) of Unix
@@ -27,7 +27,7 @@ The Committee reorganized in October, 1999, and met for the
 next several years to address issues that had been noted with
 \addtoindex{DWARF Version 2} as well as to add a number of new features.
 In mid-2003, the Committee became a workgroup under the Free
-Standards Group (FSG), a industry consortium chartered to
+Standards Group (FSG), an industry consortium chartered to
 promote open standards. \addtoindex{DWARF Version 3} was published on
 December 20, 2005, following industry review and comment.
 
@@ -40,44 +40,52 @@ independent since that time.
 It is the intention of the DWARF Committee that migrating from
 an earlier version of the DWARF standard to the current version
 should be straightforward and easily accomplished. 
-Almost all 
-\addtoindex{DWARF Version 2} 
-and Version 3 
-\addtoindexx{DWARF Version 3}
-constructs have been retained unchanged
-\addtoindexx{DWARF Version 4}
-in DWARF Version 4.
-
-The \dwf\ Committee is open to compiler and debugger
+Almost all constructs from
+\DWARFVersionII\addtoindexx{DWARF Version 3}\addtoindexx{DWARF Version 4}
+onward have been retained unchanged in \DWARFVersionV, although a few
+have been compatibly superseded by improved constructs which are
+more compact and/or more expressive.
+
+This document was created using the \LaTeX{} document preparation
+system.
+
+\clearpage
+
+{\bfseries The \dwf{} Committee}
+
+The \dwf{} Committee is open to compiler and debugger
 developers who have experience with source language debugging
 and debugging formats, and have an interest in promoting or
 extending the DWARF debugging format.
-\clearpage
-DWARF Committee members contributing to Version 4 are:
+
+DWARF Committee members contributing to Version 5 are:
 \begin{center}
 \begin{tabular}{ll}
-Todd Allen&Concurrent Computer\\
+Todd Allen              & Concurrent Computer\\
 David Anderson, Associate Editor\\
-John Bishop&Intel\\
-Jim Blandy&CodeSourcery\\
+John Bishop             & Intel\\
 Ron Brender, Editor\\
 Andrew Cagney\\
-Siu Chi Chan&IBM\\
-Cary Coutant&Google\\
-John DelSignore&TotalView\\
-Michael Eager, Chair&Eager Consulting\\
-Ben Elliston&IBM\\
-Mike Gleeson&Hewlett-Packard\\
-Mathhew Gretton-Dan&ARM\\
-David Gross&Hewlett-Packard\\
-Tommy Hoffner&IBM\\
-Jason Molenda&Apple\\
-David Moore&Intel\\
-Jeff Nelson&Hewlett-Packard\\
-Chris Quenelle&Sun Microsystems\\
-Paul Robinson&Hewlett-Packard\\
-Bill White&TotalView\\
-Kendrick Wong&IBM\\
+Soumitra Chatterjee     & Hewlett-Packard Enterprise\\
+Eric Christopher        & Google\\
+Cary Coutant            & Google\\
+John DelSignore         & Rogue Wave\\
+Michael Eager, Chair    & Eager Consulting\\
+Jini Susan George       & Hewlett-Packard\\
+Mathhew Gretton-Dan     & ARM\\
+Tommy Hoffner           & Altera\\
+Jakub Jelinek           & Red Hat\\
+Andrew Johnson          & Linaro\\
+Jason Merrill           & Red Hat\\
+Jason Molenda           & Apple\\
+Adrian Prantl           & Apple\\
+Hafiz Abid Qadeer       & Mentor Graphics\\
+Paul Robinson           & Sony\\
+Syamala Sarma           & Hewlett-Packard\\
+Keith Walker            & ARM\\
+Kendrick Wong           & IBM\\
+Brock Wyma              & Intel\\
+Jian Xu                 & IBM\\
 \end{tabular}
 \end{center}
 
@@ -93,30 +101,48 @@ see:
 \url{http://www.dwarfstd.org} 
 \end{myindentpara}
 
+\clearpage
+{\bfseries How to Use This Document}
+
 This document is intended to be usable in online as well as
-traditional paper forms. 
-In the online form, blue text is
-used to indicate hyperlinks which facilitate moving around
-in the document in a manner like that typically found in web
-browsers.
+traditional paper forms. Both online and paper forms include 
+page numbers, a Table of Contents, a List of Figures,
+a List of Tables and an Index.
+
+Text in normal font describes
+required aspects of the DWARF format.  Text in \textit{italics} is
+explanatory or supplementary material, and not part of the
+format definition itself.
+
+\textit{Online Form}
+
+In the online form, \textcolor{blue}{blue text} 
+is used to indicate hyperlinks.
 Most hyperlinks link to the definition of a term or
 construct, or to a cited Section or Figure.
 However, attributes
 in particular are often used in more than one way or context so
 that there is no single definition; for attributes, hyperlinks
-link to the introductory list of all attributes which in turn
-contains hyperlinks for the multiple usages.
-The Table of
-Contents also provides hyperlinks to the respective sections.
+link to the introductory table of all attributes which in turn
+contains hyperlinks for the multiple usages. 
+
+The occurrence of
+a DWARF name in its definition (or one of its definitions in the
+case of some attributes) is shown in \definition{red text}. 
+Other occurrences of the same name in the same or possibly following
+paragraphs are generally in normal text color.)
+
+The Table of Contents, List of Figures, List of Tables and Index 
+provide hyperlinks to the respective items and places.
+
+\textit{Paper Form}
 
 In the traditional paper form, the appearance of the hyperlinks
-on a page of paper does not distract the eye because the blue
-hyperlinks are typically imaged by black and white printers in
+and definitions on a page of paper does not distract the eye 
+because the blue hyperlinks and the color used for definitions
+are typically imaged by black and white printers in
 a manner nearly indistinguishable from other text. 
-(Hyperlinks
-are not underlined for this same reason.) 
-Page numbers,
-a Table of Contents, a List of Figures and an Index are
-included in both online and paper forms.
+(Hyperlinks are not underlined for this same reason.) 
+
 
 \end{abstract}