Backup of today's work. Still awaiting a couple more editorial inputs.
[dwarf-doc.git] / dwarf5 / latexdoc / foreword.tex
index 5e4766b..f5d579f 100644 (file)
@@ -41,13 +41,14 @@ 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 constructs from
-\addtoindex{DWARF Version 2} onward 
-\addtoindexx{DWARF Version 3}
-\addtoindexx{DWARF Version 4}
-have been retained unchanged in DWARF Version 5, although a few
-\addtoindexx{DWARF Version 5}
+\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}
@@ -65,22 +66,22 @@ David Anderson, Associate Editor\\
 John Bishop             & Intel\\
 Ron Brender, Editor\\
 Andrew Cagney\\
-Soumitra Chatterjee     & H\\
+Soumitra Chatterjee     & Hewlett-Packard Enterprise\\
 Eric Christopher        & Google\\
 Cary Coutant            & Google\\
 John DelSignore         & Rogue Wave\\
 Michael Eager, Chair    & Eager Consulting\\
-Jini Susan George       & H\\
+Jini Susan George       & Hewlett-Packard\\
 Mathhew Gretton-Dan     & ARM\\
 Tommy Hoffner           & Altera\\
-Jakub Jelinek           & RedHat\\
+Jakub Jel\'{i}nek       & Red Hat\\
 Andrew Johnson          & Linaro\\
-Jason Merrill           & RedHat\\
+Jason Merrill           & Red Hat\\
 Jason Molenda           & Apple\\
 Adrian Prantl           & Apple\\
 Hafiz Abid Qadeer       & Mentor Graphics\\
 Paul Robinson           & Sony\\
-Syamala Sarma           & HP\\
+Syamala Sarma           & Hewlett-Packard\\
 Keith Walker            & ARM\\
 Kendrick Wong           & IBM\\
 Brock Wyma              & Intel\\
@@ -108,9 +109,15 @@ 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, blue text is used to indicate hyperlinks.
+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
@@ -121,12 +128,12 @@ 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{color}. Other
-occurrences of the same name in the same or possibly following
+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.
+The Table of Contents, List of Figures, List of Tables and Index 
+provide hyperlinks to the respective items and places.
 
 \textit{Paper Form}