This version *almost* corresponds to the dwarf5.20150613.pdf
[dwarf-doc.git] / dwarf5 / latexdoc / foreword.tex
index 6cfd6ae..5e4766b 100644 (file)
@@ -50,7 +50,9 @@ have been compatibly superseded by improved constructs which are
 more compact and/or more expressive.
 \clearpage
 
-The \dwf\ Committee is open to compiler and debugger
+{\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.
@@ -98,30 +100,42 @@ 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. 
+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.
+
+\textit{Online Form}
 
 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.
 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{color}. 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.) 
 
-Both online and paper forms include 
-page numbers, a Table of Contents, a List of Figures and an Index.
 
 \end{abstract}