This is the first pass of incorporating review commments from the
[dwarf-doc.git] / dwarf5 / latexdoc / introduction.tex
index 194f47c..5f53c43 100644 (file)
@@ -58,24 +58,24 @@ way the debugging information is encoded and represented in
 an object file.
 
 The informational content is described in 
-Sections \refersec{chap:generaldescription} 
+Sections \ref{chap:generaldescription} 
 through
-\refersec{chap:otherdebugginginformation}. 
-Section  \refersec{chap:generaldescription}
+\ref{chap:otherdebugginginformation}. 
+Section  \ref{chap:generaldescription}
 describes the overall structure of the information
 and attributes that is common to many or all of the different
 debugging information entries. 
-Sections \refersec{chap:programscopeentries}, 
-\refersec{chap:dataobjectandobjectlistentries} and 
-\refersec{chap:typeentries} describe
+Sections \ref{chap:programscopeentries}, 
+\ref{chap:dataobjectandobjectlistentries} and 
+\ref{chap:typeentries} describe
 the specific debugging information entries and how they
 communicate the necessary information about the source program
 to a debugger. 
-Section \refersec{chap:otherdebugginginformation} 
+Section \ref{chap:otherdebugginginformation} 
 describes debugging information
 contained outside of the debugging information entries. The
 encoding of the DWARF information is presented in 
-Section \refersec{datarep:datarepresentation}.
+Section \ref{datarep:datarepresentation}.
 
 This organization closely follows that used in the DWARF
 Version 3 document. Except where needed to incorporate
@@ -85,7 +85,7 @@ text is generally reused in this document with little or
 no modification.
 
 In the following sections, text in normal font describes
-required aspects of the DWARF format.  Text in italics is
+required aspects of the DWARF format.  Text in \textit{italics} is
 explanatory or supplementary material, and not part of the
 format definition itself. The several appendices consist only
 of explanatory or supplementary material, and are not part
@@ -229,20 +229,24 @@ Certain very large values of the initial length fields that
 begin DWARF sections as well as certain structures are reserved
 to act as escape codes for future extension; one such extension
 is defined to increase the possible size of DWARF descriptions
-(see Section 7.4).
+(see Section \refersec{datarep:32bitand64bitdwarfformats}).
 
 \item
-References that use the attribute form \livelink{chap:DWFORMrefaddr}{DW\-\_FORM\-\_ref\-\_addr}
+References that use the attribute form 
+\livelink{chap:DWFORMrefaddr}{DW\-\_FORM\-\_ref\-\_addr}
 are specified to be four bytes in the DWARF 32-bit format and
 eight bytes in the DWARF 64-bit format, while 
 \addtoindex{DWARF Version 2} 
 specifies that such references have the same size as an
-address on the target system (see Sections 7.4 and 7.5.4).
+address on the target system (see Sections 
+\refersec{datarep:32bitand64bitdwarfformats} and 
+\refersec{datarep:attributeencodings}).
 
 \item
 The return\_address\_register field in a Common Information
 Entry record for call frame information is changed to unsigned
-LEB representation (see Section 6.4.1).
+LEB representation (see Section 
+\refersec{chap:structureofcallframeinformation}).
 
 \end{itemize}