Misc corrections up thru Chpt 5
[dwarf-doc.git] / dwarf5 / latexdoc / introduction.tex
index 9a2fba2..70512c0 100644 (file)
@@ -30,7 +30,7 @@ of individual languages, such as \addtoindex{C++} virtual functions or
 that are used only for those languages. 
 This document is
 believed to cover most debugging information needs of 
-addtoindex{Ada},
+\addtoindex{Ada},
 \addtoindex{C}, \addtoindex{C++}, \addtoindex{COBOL}, 
 and \addtoindex{Fortran}; it also covers the basic needs
 of various other languages.
@@ -46,8 +46,8 @@ of both producers and consumers of debugging information,
 typically compilers, debuggers and other tools that need to
 interpret a binary program in terms of its original source.
 
-\section{Overview}
 
+\section{Overview}
 
 There are two major pieces to the description of the DWARF
 format in this document. The first piece is the informational
@@ -109,7 +109,7 @@ All
 names and values not reserved for vendor additions, however,
 are reserved for future versions of this document.
 
-\addtoindex{DWARF Version 5} is intended to be permissive rather than
+\addtoindex{DWARF Version 4} is intended to be permissive rather than
 prescriptive. 
 Where this specification provides a means for
 describing the source language, implementors are expected
@@ -130,8 +130,6 @@ version of this standard or which contain vendor extensions,
 albeit possibly in a degraded manner.
 
 
-\section[Changes Version 4 to 5]{Changes from Version 4 to Version 5}
-TBD
 \section[Changes Version 3 to 4]{Changes from Version 3 to Version 4}
 The following is a list of the major changes made to the DWARF Debugging Information
 Format since Version 3 was published. The list is not meant to be exhaustive.
@@ -163,8 +161,10 @@ constant expressions, Unicode character types and template aliases.
 \item Add additional support for template parameters in instantiations.
 \item Add support for strongly typed enumerations in languages (such as C++) that have two
 kinds of enumeration declarations.
+\end{itemize}
 \addtoindex{DWARF Version 4} is compatible with 
 \addtoindex{DWARF Version 3} except as follows:
+\begin{itemize}
 \item DWARF attributes that use any of the new forms of attribute value representation (for
 section offsets, flag compression, type signature references, and so on) cannot be read by
 \addtoindex{DWARF Version 3}
@@ -174,8 +174,6 @@ unexpected form of data.
 and interpretation of other data in the section.
 \end{itemize}
 
-
-Contents needed.
 \section{Changes from Version 2 to Version 3}
 The following is a list of the major differences between
 Version 2 and Version 3 of the DWARF Debugging Information
@@ -208,7 +206,7 @@ Add an optional section for global type names (similar to
 the global section for objects and functions).
 
 \item
-Adopt UTF-8 as the preferred representation of program name strings.
+Adopt \addtoindex{UTF-8} as the preferred representation of program name strings.
 \item
 Add improved support for optimized code (discontiguous
 scopes, end of prologue determination, multiple section
@@ -276,12 +274,10 @@ Version 2 information has been moved to a different object
 file section, \addtoindex{.debug\_info}.  
 
 \textit{
-A summary of the major changes
-made in 
+A summary of the major changes made in 
 \addtoindex{DWARF Version 2}
-compared to the DWARF Version 1 may
-be found in the 
+compared to the DWARF Version 1 may be found in the 
 \addtoindex{DWARF Version 2}
-document
+document.
 }