Misc corrections up thru Chpt 5
[dwarf-doc.git] / dwarf5 / latexdoc / introduction.tex
index 8758576..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.
@@ -146,7 +144,10 @@ compute the location where a value is found (such as an address in memory or a r
 name) from DWARF expressions, which compute a final value (such as an array bound).
 \item Add support for bundled instructions on machine architectures where instructions do not
 occupy a whole number of bytes.
-\item Add a new attribute form for section offsets, \livelink{chap:DWFORMsecoffset}{DW\-\_FORM\-\_sec\-\_offset}, to replace the use
+\item Add a new attribute form for 
+section offsets, \livelink{chap:DWFORMsecoffset}{DW\-\_FORM\-\_sec\-\_offset}, 
+\addtoindexx{section offset}
+to replace the use
 of \livelink{chap:DWFORMdata4}{DW\-\_FORM\-\_data4} and \livelink{chap:DWFORMdata8}{DW\-\_FORM\-\_data8} for section offsets.
 \item Add an attribute, \livelink{chap:DWATmainsubprogram}{DW\-\_AT\-\_main\-\_subprogram}, to identify the main subprogram of a
 program.
@@ -160,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}
@@ -171,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
@@ -205,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
@@ -273,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.
 }