Index entries for u (you) and other details
authorRon Brender <ron.brender@gmail.com>
Mon, 17 Dec 2012 21:42:06 +0000 (16:42 -0500)
committerRon Brender <ron.brender@gmail.com>
Mon, 17 Dec 2012 21:42:06 +0000 (16:42 -0500)
dwarf5/latexdoc/dataobject.tex
dwarf5/latexdoc/datarepresentation.tex
dwarf5/latexdoc/dwarf5.tex
dwarf5/latexdoc/examples.tex
dwarf5/latexdoc/foreword.tex
dwarf5/latexdoc/foreword4.1.tex [new file with mode: 0644]
dwarf5/latexdoc/generaldescription.tex
dwarf5/latexdoc/introduction.tex
dwarf5/latexdoc/otherdebugginginformation.tex
dwarf5/latexdoc/programscope.tex
dwarf5/latexdoc/typeentries.tex

index 15158bb..e46fb43 100644 (file)
@@ -55,15 +55,15 @@ declaration of an object.
 
 \item A \livelink{chap:DWATlocation}{DW\-\_AT\-\_location} attribute,
 \addtoindexx{location attribute}
 
 \item A \livelink{chap:DWATlocation}{DW\-\_AT\-\_location} attribute,
 \addtoindexx{location attribute}
-whose value describes the
-location of a variable or parameter at run-time.  In a variable
+whose value describes the location of a variable or parameter at run-time.
+If no location attribute is present in a variable 
 entry representing the definition of a variable (that is,
 \addtoindexx{declaration attribute}
 with no 
 entry representing the definition of a variable (that is,
 \addtoindexx{declaration attribute}
 with no 
-\livelink{chap:DWATdeclaration}{DW\-\_AT\-\_declaration} attribute) 
-if no location attribute
-is present, or if the location attribute is present but has
+\livelink{chap:DWATdeclaration}{DW\-\_AT\-\_declaration} attribute),
+or if the location attribute is present but has
 an empty location description (as described in Section 2.6),
 an empty location description (as described in Section 2.6),
+\addtoindexx{unallocated variable}
 the variable is assumed to exist in the source code but not
 in the executable program (but see number 10, below).
 
 the variable is assumed to exist in the source code but not
 in the executable program (but see number 10, below).
 
index aad6b3f..fbc9ce8 100644 (file)
@@ -322,6 +322,7 @@ units may share the same table.
 \begin{enumerate}[1.]
 
 \item unit\_length (initial length) \\
 \begin{enumerate}[1.]
 
 \item unit\_length (initial length) \\
+\addtoindexx{unit\_length}
 A 4\dash byte or 12\dash byte 
 \addtoindexx{initial length}
 unsigned integer representing the length
 A 4\dash byte or 12\dash byte 
 \addtoindexx{initial length}
 unsigned integer representing the length
@@ -334,7 +335,7 @@ of the 4\dash byte value 0xffffffff followed by an 8\dash byte unsigned
 integer that gives the actual length 
 (see Section \refersec{datarep:32bitand64bitdwarfformats}).
 
 integer that gives the actual length 
 (see Section \refersec{datarep:32bitand64bitdwarfformats}).
 
-\item  version (uhalf)
+\item  version (\addtoindex(uhalf))
 A 2\dash byte unsigned integer representing the version of the
 DWARF information for the compilation unit\addtoindexx{version number!compilation unit} 
 (see Appendix \refersec{app:dwarfsectionversionnumbersinformative}). 
 A 2\dash byte unsigned integer representing the version of the
 DWARF information for the compilation unit\addtoindexx{version number!compilation unit} 
 (see Appendix \refersec{app:dwarfsectionversionnumbersinformative}). 
@@ -351,7 +352,7 @@ the 32\dash bit DWARF format, this is a 4\dash byte unsigned length;
 in the 64\dash bit DWARF format, this is an 8\dash byte unsigned length
 (see Section \refersec{datarep:32bitand64bitdwarfformats}).
 
 in the 64\dash bit DWARF format, this is an 8\dash byte unsigned length
 (see Section \refersec{datarep:32bitand64bitdwarfformats}).
 
-\item address\_size (ubyte) \\
+\item address\_size (\addtoindex{ubyte}) \\
 A 1\dash byte unsigned integer representing the size in bytes of
 \addtoindexx{address\_size}
 an address on the target architecture. If the system uses
 A 1\dash byte unsigned integer representing the size in bytes of
 \addtoindexx{address\_size}
 an address on the target architecture. If the system uses
@@ -376,6 +377,7 @@ consists of the following information:
 \begin{enumerate}[1.]
 
 \item unit\_length (initial length) \\
 \begin{enumerate}[1.]
 
 \item unit\_length (initial length) \\
+\addtoindexx{unit\_length}
 A 4\dash byte or 12\dash byte unsigned integer 
 \addtoindexx{initial length}
 representing the length
 A 4\dash byte or 12\dash byte unsigned integer 
 \addtoindexx{initial length}
 representing the length
@@ -387,7 +389,7 @@ consists of the 4\dash byte value 0xffffffff followed by an
 8\dash byte unsigned integer that gives the actual length
 (see Section \refersec{datarep:32bitand64bitdwarfformats}).
 
 8\dash byte unsigned integer that gives the actual length
 (see Section \refersec{datarep:32bitand64bitdwarfformats}).
 
-\item  version (uhalf)
+\item  version (\addtoindex(uhalf))
 A 2\dash byte unsigned integer representing the version of the
 DWARF information for the 
 compilation unit\addtoindexx{version number!type unit} 
 A 2\dash byte unsigned integer representing the version of the
 DWARF information for the 
 compilation unit\addtoindexx{version number!type unit} 
@@ -858,13 +860,14 @@ value is a 4\dash byte unsigned offset; in the 64\dash bit DWARF format,
 it is an 8\dash byte unsigned offset 
 (see Section \refersec{datarep:32bitand64bitdwarfformats}).
 
 it is an 8\dash byte unsigned offset 
 (see Section \refersec{datarep:32bitand64bitdwarfformats}).
 
-If the \livelink{chap:DWATuseUTF8}{DW\-\_AT\-\_use\-\_UTF8} attribute is specified for the
+If the \livelink{chap:DWATuseUTF8}{DW\-\_AT\-\_use\-\_UTF8}
+\addtoindexx{use UTF8 attribute}\addtoindexx{UTF-8} attribute is specified for the
 compilation unit entry, string values are encoded using the
 compilation unit entry, string values are encoded using the
-UTF\dash 8 (Unicode Transformation Format\dash 8) from the Universal
+UTF\dash 8 (\addtoindex{Unicode} Transformation Format\dash 8) from the Universal
 Character Set standard (ISO/IEC 10646\dash 1:1993). Otherwise,
 the string representation is unspecified.
 
 Character Set standard (ISO/IEC 10646\dash 1:1993). Otherwise,
 the string representation is unspecified.
 
-The Unicode Standard Version 3 is fully compatible with
+The \addtoindex{Unicode} Standard Version 3 is fully compatible with
 ISO/IEC 10646\dash 1:1993. It contains all the same characters
 and encoding points as ISO/IEC 10646, as well as additional
 information about the characters and their use.
 ISO/IEC 10646\dash 1:1993. It contains all the same characters
 and encoding points as ISO/IEC 10646, as well as additional
 information about the characters and their use.
@@ -1125,7 +1128,7 @@ Child determination name& Value\\ \hline
 \livelink{chap:DWATentrypc}{DW\-\_AT\-\_entry\-\_pc}&0x52&address 
         \addtoindexx{entry pc attribute!encoding}  \\
 \livelink{chap:DWATuseUTF8}{DW\-\_AT\-\_use\-\_UTF8}&0x53&\livelink{chap:flag}{flag} 
 \livelink{chap:DWATentrypc}{DW\-\_AT\-\_entry\-\_pc}&0x52&address 
         \addtoindexx{entry pc attribute!encoding}  \\
 \livelink{chap:DWATuseUTF8}{DW\-\_AT\-\_use\-\_UTF8}&0x53&\livelink{chap:flag}{flag} 
-        \addtoindexx{use UTF8 attribute!encoding}  \\
+        \addtoindexx{use UTF8 attribute!encoding}\addtoindex{UTF-8}  \\
 \livelink{chap:DWATextension}{DW\-\_AT\-\_extension}&0x54&reference 
         \addtoindexx{extension attribute!encoding}  \\
 \livelink{chap:DWATranges}{DW\-\_AT\-\_ranges}&0x55&\livelink{chap:rangelistptr}{rangelistptr} 
 \livelink{chap:DWATextension}{DW\-\_AT\-\_extension}&0x54&reference 
         \addtoindexx{extension attribute!encoding}  \\
 \livelink{chap:DWATranges}{DW\-\_AT\-\_ranges}&0x55&\livelink{chap:rangelistptr}{rangelistptr} 
@@ -1922,6 +1925,7 @@ with a header consisting of:
 
 \begin{enumerate}[1.]
 \item unit\_length (initial length) \\
 
 \begin{enumerate}[1.]
 \item unit\_length (initial length) \\
+\addtoindexx{unit\_length}
 A 4\dash byte or 12\dash byte unsigned integer 
 \addtoindexx{initial length}
 representing the length
 A 4\dash byte or 12\dash byte unsigned integer 
 \addtoindexx{initial length}
 representing the length
@@ -1934,7 +1938,7 @@ of the 4\dash byte value 0xffffffff followed by an 8\dash byte unsigned
 integer that gives the actual length
 (see Section \refersec{datarep:32bitand64bitdwarfformats}).
 
 integer that gives the actual length
 (see Section \refersec{datarep:32bitand64bitdwarfformats}).
 
-\item  version (uhalf)
+\item  version (\addtoindex(uhalf))
 A 2\dash byte unsigned integer representing the version of the
 DWARF information\addtoindexx{version number!compilation unit} for the compilation unit
 \addtoindexx{version number!name lookup table}
 A 2\dash byte unsigned integer representing the version of the
 DWARF information\addtoindexx{version number!compilation unit} for the compilation unit
 \addtoindexx{version number!name lookup table}
@@ -1991,6 +1995,7 @@ section begins with a header containing:
 % these tables.
 
 \item unit\_length (initial length) \\
 % these tables.
 
 \item unit\_length (initial length) \\
+\addtoindexx{unit\_length}
 A 4-byte or 12-byte length containing the length of the
 \addtoindexx{initial length}
 set of entries for this compilation unit, not including the
 A 4-byte or 12-byte length containing the length of the
 \addtoindexx{initial length}
 set of entries for this compilation unit, not including the
@@ -2001,7 +2006,7 @@ in the 64-bit DWARF format, this consists of the 4-byte value
 the actual length 
 (see Section \refersec{datarep:32bitand64bitdwarfformats}).
 
 the actual length 
 (see Section \refersec{datarep:32bitand64bitdwarfformats}).
 
-\item version (uhalf) \\
+\item version (\addtoindex(uhalf)) \\
 A 2\dash byte version identifier
 \addtoindexx{version number!address range table} containing the value 2 
 (see Appendix \refersec{app:dwarfsectionversionnumbersinformative}). 
 A 2\dash byte version identifier
 \addtoindexx{version number!address range table} containing the value 2 
 (see Appendix \refersec{app:dwarfsectionversionnumbersinformative}). 
@@ -2335,7 +2340,7 @@ Table 41 \refersec{tab:integerrepresentationnames}.
 \setlength{\extrarowheight}{0.1cm}
 \begin{longtable}{c|l}
   \caption{Integer Representation Names} \label{tab:integerrepresentationnames}\\
 \setlength{\extrarowheight}{0.1cm}
 \begin{longtable}{c|l}
   \caption{Integer Representation Names} \label{tab:integerrepresentationnames}\\
-  \hline \\ \bfseries Representation Name&\bfseries Representation \\ \hline
+  \hline \bfseries Representation Name&\bfseries Representation \\ \hline
 \endfirsthead
   \bfseries Representation Name&\bfseries Representation\\ \hline
 \endhead
 \endfirsthead
   \bfseries Representation Name&\bfseries Representation\\ \hline
 \endhead
index b93f366..b9e0722 100644 (file)
@@ -43,7 +43,7 @@ escapeinside={\%*}{*)}  % if you want to add a comment within your code
 \usepackage[plainpages=false,pdfpagelabels,pagebackref]{hyperref}  % Lets us generate colored active links inside a pdf.
 \makeindex  % This and the makeidx package allow \index to create index entries.
 
 \usepackage[plainpages=false,pdfpagelabels,pagebackref]{hyperref}  % Lets us generate colored active links inside a pdf.
 \makeindex  % This and the makeidx package allow \index to create index entries.
 
-\newcommand{\docdate}{21 October 2012}
+\newcommand{\docdate}{17 December 2012}
 
 \newcommand{\dwf}{DWARF Debugging Information Format}
 \newenvironment{myindentpara}[1]%
 
 \newcommand{\dwf}{DWARF Debugging Information Format}
 \newenvironment{myindentpara}[1]%
@@ -96,6 +96,7 @@ escapeinside={\%*}{*)}  % if you want to add a comment within your code
 
 \begin{document}
 \pagestyle{empty}
 
 \begin{document}
 \pagestyle{empty}
+
 \nonzeroparskip
 \setlength{\parindent}{0pt} 
 \setlength{\headheight}{6cm}
 \nonzeroparskip
 \setlength{\parindent}{0pt} 
 \setlength{\headheight}{6cm}
@@ -117,6 +118,7 @@ escapeinside={\%*}{*)}  % if you want to add a comment within your code
 
 \url{http://www.dwarfstd.org}
 
 
 \url{http://www.dwarfstd.org}
 
+\large
 \textbf{\docdate}
 
 \end{centering}
 \textbf{\docdate}
 
 \end{centering}
@@ -155,6 +157,7 @@ escapeinside={\%*}{*)}  % if you want to add a comment within your code
 
 \include{copyright}
 \include{foreword}
 
 \include{copyright}
 \include{foreword}
+\include{foreword4.1}
 
 \tableofcontents
 
 
 \tableofcontents
 
index 0616c3f..6c98370 100644 (file)
@@ -1832,8 +1832,8 @@ Section \refersec{app:constantexpressionsdwarfdescription}.
 
 \section{Unicode Character Example}
 \label{app:unicodecharacterexample}
 
 \section{Unicode Character Example}
 \label{app:unicodecharacterexample}
-
-Unicode character encodings can be described in DWARF as
+\addtoindexx{Unicode|see {\textit{also} UTF-8}}
+\addtoindex{Unicode} character encodings can be described in DWARF as
 illustrated in 
 Section \refersec{app:unicodecharacterexamplesub}.
 
 illustrated in 
 Section \refersec{app:unicodecharacterexamplesub}.
 
index b702b75..8f2ab76 100644 (file)
@@ -59,7 +59,7 @@ DWARF Committee members contributing to Version 4 are:
 \begin{center}
 \begin{tabular}{ll}
 Todd Allen&Concurrent Computer\\
 \begin{center}
 \begin{tabular}{ll}
 Todd Allen&Concurrent Computer\\
-David Anderson\\
+David Anderson, Associate Editor\\
 John Bishop&Intel\\
 Jim Blandy&CodeSourcery\\
 Ron Brender, Editor\\
 John Bishop&Intel\\
 Jim Blandy&CodeSourcery\\
 Ron Brender, Editor\\
diff --git a/dwarf5/latexdoc/foreword4.1.tex b/dwarf5/latexdoc/foreword4.1.tex
new file mode 100644 (file)
index 0000000..920539a
--- /dev/null
@@ -0,0 +1,14 @@
+\renewcommand{\abstractname}{Foreword to Version 4.1}
+\setlength{\parindent}{0pt}
+\begin{abstract}
+\nonzeroparskip
+\setlength{\parindent}{0pt}
+
+This version of the DWARF Debugging Information Format is first and foremost 
+a re-implementation of the Version 4 document using the \LaTeX document preparation system.
+There are no substantive changes compared to the Version 4 document and very few even minor
+editorial changes other than those mandated by the underlying technology.
+
+If any descrepencies are discovered between these two documents, please bring them to the
+attention of the DWARF Information Format Committee.
+\end{abstract}
\ No newline at end of file
index 022fb87..ebea018 100644 (file)
@@ -351,7 +351,7 @@ actually declared in the source}{objects or types that are not actually declared
 &\livelinki{chap:DWATstringlengthstringlengthofstringtype}{String length of string type}{string length of string type}
  \\
 \livetarg{chap:DWATthreadsscaled}{DW\-\_AT\-\_threads\-\_scaled}
 &\livelinki{chap:DWATstringlengthstringlengthofstringtype}{String length of string type}{string length of string type}
  \\
 \livetarg{chap:DWATthreadsscaled}{DW\-\_AT\-\_threads\-\_scaled}
-&\livelink{chap:DWATthreadsscaledupcarrayboundthreadsscalfactor}{UPC array bound THREADS scale factor}\\
+&\livelink{chap:DWATthreadsscaledupcarrayboundthreadsscalfactor}{UPC!array bound THREADS scale factor}\\
 \livetarg{chap:DWATtrampoline}{DW\-\_AT\-\_trampoline}
 &\livelinki{chap:DWATtrampolinetargetsubroutine}{Target subroutine}{target subroutine of trampoline} \\
 \livetarg{chap:DWATtype}{DW\-\_AT\-\_type}
 \livetarg{chap:DWATtrampoline}{DW\-\_AT\-\_trampoline}
 &\livelinki{chap:DWATtrampolinetargetsubroutine}{Target subroutine}{target subroutine of trampoline} \\
 \livetarg{chap:DWATtype}{DW\-\_AT\-\_type}
@@ -361,7 +361,7 @@ actually declared in the source}{objects or types that are not actually declared
 &\livelinki{chap:DWATupperboundupperboundofsubrange}{Upper bound of subrange}{upper bound of subrange} \\
 \livetarg{chap:DWATuselocation}{DW\-\_AT\-\_use\-\_location}
 &\livelinki{chap:DWATuselocationmemberlocationforpointertomembertype}{Member location for pointer to member type}{member location for pointer to member type} \\
 &\livelinki{chap:DWATupperboundupperboundofsubrange}{Upper bound of subrange}{upper bound of subrange} \\
 \livetarg{chap:DWATuselocation}{DW\-\_AT\-\_use\-\_location}
 &\livelinki{chap:DWATuselocationmemberlocationforpointertomembertype}{Member location for pointer to member type}{member location for pointer to member type} \\
-\livetarg{chap:DWATuseUTF8}{DW\-\_AT\-\_use\-\_UTF8}
+\livetarg{chap:DWATuseUTF8}{DW\-\_AT\-\_use\-\_UTF8}\addtoindexx{use UTF8 attribute}\addtoindexx{UTF-8}
 &\livelinki{chap:DWATuseUTF8compilationunitusesutf8strings}{Compilation unit uses UTF-8 strings}{compilation unit uses UTF-8 strings} \\
 \livetarg{chap:DWATvariableparameter}{DW\-\_AT\-\_variable\-\_parameter}
 &\livelinki{chap:DWATvariableparameternonconstantparameterflag}{Non-constant parameter flag}{non-constant parameter flag}  \\
 &\livelinki{chap:DWATuseUTF8compilationunitusesutf8strings}{Compilation unit uses UTF-8 strings}{compilation unit uses UTF-8 strings} \\
 \livetarg{chap:DWATvariableparameter}{DW\-\_AT\-\_variable\-\_parameter}
 &\livelinki{chap:DWATvariableparameternonconstantparameterflag}{Non-constant parameter flag}{non-constant parameter flag}  \\
@@ -1041,10 +1041,8 @@ examples illustrate their behavior graphically.
 \label{chap:locationdescriptions}
 \textit{Debugging information 
 \addtoindexx{location description}
 \label{chap:locationdescriptions}
 \textit{Debugging information 
 \addtoindexx{location description}
-\addtoindexx{location description}
 must 
 must 
-%FIXME: should be 'see also' somehow.
-\addtoindexx{location description|see{DWARF expression}}
+\addtoindexx{location description|see{\textit{also} DWARF expression}}
 provide consumers a way to find
 the location of program variables, determine the bounds
 of dynamic arrays and strings, and possibly to find the
 provide consumers a way to find
 the location of program variables, determine the bounds
 of dynamic arrays and strings, and possibly to find the
@@ -1334,7 +1332,8 @@ variable instance.
 
 \livelink{chap:DWOPfbreg}{DW\-\_OP\-\_fbreg} -50
 \begin{myindentpara}{1cm}
 
 \livelink{chap:DWOPfbreg}{DW\-\_OP\-\_fbreg} -50
 \begin{myindentpara}{1cm}
-Given a \livelink{chap:DWATframebase}{DW\-\_AT\-\_frame\-\_base} value of ``\livelink{chap:DWOPbreg31}{DW\-\_OP\-\_breg31} 64,''this example
+Given a \livelink{chap:DWATframebase}{DW\-\_AT\-\_frame\-\_base} value of
+``\livelink{chap:DWOPbreg31}{DW\-\_OP\-\_breg31} 64,'' this example
 computes the address of a local variable that is -50 bytes from a
 logical frame pointer that is computed by adding 64 to the current
 stack pointer (register 31).
 computes the address of a local variable that is -50 bytes from a
 logical frame pointer that is computed by adding 64 to the current
 stack pointer (register 31).
@@ -1611,10 +1610,10 @@ Figure \ref{fig:virtualitycodes}.
 for objects or types that were not actually declared in the
 source of the application. An example is a formal parameter
 %FIXME: The word 'this' should be rendered like a variant italic,
 for objects or types that were not actually declared in the
 source of the application. An example is a formal parameter
 %FIXME: The word 'this' should be rendered like a variant italic,
-%FIXME: not as a quoted name.
+%FIXME: not as a quoted name. Changed to tt font--RB
 entry to represent the 
 entry to represent the 
-\addtoindexx{this parameter}
-hidden ``this'' parameter that most C++
+\addtoindexx{\texttt{this} parameter}
+hidden \texttt{this} parameter that most C++
 implementations pass as the first argument to non-static member
 functions.}  
 
 implementations pass as the first argument to non-static member
 functions.}  
 
index c736270..189f281 100644 (file)
@@ -206,7 +206,7 @@ Add an optional section for global type names (similar to
 the global section for objects and functions).
 
 \item
 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
 \item
 Add improved support for optimized code (discontiguous
 scopes, end of prologue determination, multiple section
index e1ac83b..916da10 100644 (file)
@@ -92,11 +92,12 @@ Each set begins with a header containing four values:
 \begin{enumerate}[1.]
 
 \item unit\_length (initial length) \\
 \begin{enumerate}[1.]
 
 \item unit\_length (initial length) \\
+\addtoindexx{unit\_length}
 The total length of the all of the entries for that set,
 not including the length field itself 
 (see Section \refersec{datarep:locationdescriptions}).
 
 The total length of the all of the entries for that set,
 not including the length field itself 
 (see Section \refersec{datarep:locationdescriptions}).
 
-\item  version (uhalf) \\
+\item  version (\addtoindex(uhalf)) \\
 A version number
 \addtoindexx{version number!name lookup table}
 \addtoindexx{version number!type lookup table} 
 A version number
 \addtoindexx{version number!name lookup table}
 \addtoindexx{version number!type lookup table} 
@@ -160,11 +161,12 @@ Each set begins with a header containing five values:
 \begin{enumerate}[1.]
 
 \item unit\_length (initial length) \\
 \begin{enumerate}[1.]
 
 \item unit\_length (initial length) \\
+\addtoindexx{unit\_length}
 The total length of all of the
 entries for that set, not including the length field itself
 (see Section \refersec{datarep:initiallengthvalues}).
 
 The total length of all of the
 entries for that set, not including the length field itself
 (see Section \refersec{datarep:initiallengthvalues}).
 
-\item version (uhalf) \\
+\item version (\addtoindex(uhalf)) \\
 A version number\addtoindexx{version number!address lookup table} 
 (see Appendix \refersec{app:dwarfsectionversionnumbersinformative}). 
 This number is specific to the address lookup table and is
 A version number\addtoindexx{version number!address lookup table} 
 (see Appendix \refersec{app:dwarfsectionversionnumbersinformative}). 
 This number is specific to the address lookup table and is
@@ -177,21 +179,17 @@ beginning of the \addtoindex{.debug\_info} or
 \addtoindex{.debug\_types} section of the
 compilation unit header referenced by the set.
 
 \addtoindex{.debug\_types} section of the
 compilation unit header referenced by the set.
 
-\item address\_size (ubyte) \\
+\item address\_size (\addtoindex{ubyte}) \\
 The \addtoindex{size of an address}
 The \addtoindex{size of an address}
-in 
-\addtoindexx{ubyte}
-bytes on
+in bytes on
 \addtoindexx{address\_size}
 the target architecture. For 
 \addtoindexx{address space!segmented}
 segmented addressing, this is
 the size of the offset portion of the address.
 
 \addtoindexx{address\_size}
 the target architecture. For 
 \addtoindexx{address space!segmented}
 segmented addressing, this is
 the size of the offset portion of the address.
 
-\item segment\_size (ubyte) \\
-The size of a segment selector 
-\addtoindexx{ubyte}
-in
+\item segment\_size (\addtoindex{ubyte}) \\
+The size of a segment selector in
 \addtoindexx{segment\_size}
 bytes on the target architecture. If the target system uses
 a flat address space, this value is 0.
 \addtoindexx{segment\_size}
 bytes on the target architecture. If the target system uses
 a flat address space, this value is 0.
@@ -224,8 +222,7 @@ multiple address range descriptors for that compilation unit.}
 \section{Line Number Information}
 \label{chap:linenumberinformation}
 \textit{A source\dash level debugger will need to know how to
 \section{Line Number Information}
 \label{chap:linenumberinformation}
 \textit{A source\dash level debugger will need to know how to
-%FIXME: the see here is not 'see also'. Fix?
-\addtoindexx{line number information|see{statement list attribute}}
+\addtoindexx{line number information|see{\textit{also} statement list attribute}}
 associate locations in the source files with the corresponding
 machine instruction addresses in the executable object or
 the shared objects used by that executable object. Such an
 associate locations in the source files with the corresponding
 machine instruction addresses in the executable object or
 the shared objects used by that executable object. Such an
@@ -445,13 +442,13 @@ The state machine instructions in a line number program belong to one of three c
 
 \begin{tabular}{lp{10cm}}
 special opcodes &
 
 \begin{tabular}{lp{10cm}}
 special opcodes &
-These have a ubyte opcode field and no operands.
+These have a \addtoindex{ubyte} opcode field and no operands.
 
 \textit{Most of the instructions in a 
 line number program are special opcodes.} \\
 
 standard opcodes &
 
 \textit{Most of the instructions in a 
 line number program are special opcodes.} \\
 
 standard opcodes &
-These have a ubyte opcode field which may be followed by zero or more
+These have a \addtoindex{ubyte} opcode field which may be followed by zero or more
 LEB128 operands (except for 
 \livelink{chap:DWLNSfixedadvancepc}{DW\-\_LNS\-\_fixed\-\_advance\-\_pc}, see below).
 The opcode implies the number of operands and their meanings, but the
 LEB128 operands (except for 
 \livelink{chap:DWLNSfixedadvancepc}{DW\-\_LNS\-\_fixed\-\_advance\-\_pc}, see below).
 The opcode implies the number of operands and their meanings, but the
@@ -462,7 +459,7 @@ extended opcodes &
 These have a multiple byte format. The first byte is zero; the next bytes
 are an unsigned LEB128 integer giving the number of bytes in the
 instruction itself (does not include the first zero byte or the size). The
 These have a multiple byte format. The first byte is zero; the next bytes
 are an unsigned LEB128 integer giving the number of bytes in the
 instruction itself (does not include the first zero byte or the size). The
-remaining bytes are the instruction itself (which begins with a ubyte
+remaining bytes are the instruction itself (which begins with a \addtoindex{ubyte}
 extended opcode). \\
 \end{tabular}
 
 extended opcode). \\
 \end{tabular}
 
@@ -481,11 +478,12 @@ a header containing the following fields in order:
 
 \begin{enumerate}[1.]
 \item unit\_length (initial length)  \\
 
 \begin{enumerate}[1.]
 \item unit\_length (initial length)  \\
+\addtoindexx{unit\_length}
 The size in bytes of the line number information for this
 compilation unit, not including the unit\_length field itself
 (see Section \refersec{datarep:initiallengthvalues}). 
 
 The size in bytes of the line number information for this
 compilation unit, not including the unit\_length field itself
 (see Section \refersec{datarep:initiallengthvalues}). 
 
-\item version (uhalf
+\item version (\addtoindex(uhalf)
 A version number\addtoindexx{version number!line number information} 
 (see Appendix \refersec{app:dwarfsectionversionnumbersinformative}). 
 This number is specific to
 A version number\addtoindexx{version number!line number information} 
 (see Appendix \refersec{app:dwarfsectionversionnumbersinformative}). 
 This number is specific to
@@ -500,7 +498,7 @@ length; in the 64\dash bit DWARF format, this field is an
 8\dash byte unsigned length 
 (see Section \refersec{datarep:32bitand64bitdwarfformats}). 
 
 8\dash byte unsigned length 
 (see Section \refersec{datarep:32bitand64bitdwarfformats}). 
 
-\item minimum\_instruction\_length (ubyte)  \\
+\item minimum\_instruction\_length (\addtoindex{ubyte})  \\
 \addtoindexx{minimum\_instruction\_length}
 The size in bytes of the smallest target machine
 instruction. Line number program opcodes that alter
 \addtoindexx{minimum\_instruction\_length}
 The size in bytes of the smallest target machine
 instruction. Line number program opcodes that alter
@@ -508,7 +506,7 @@ the address and \addtoindex{op\_index} registers use this and
 \addtoindexx{maximum\_operations\_per\_instruction}
 maximum\-\_operations\-\_per\-\_instruction in their calculations. 
 
 \addtoindexx{maximum\_operations\_per\_instruction}
 maximum\-\_operations\-\_per\-\_instruction in their calculations. 
 
-\item maximum\_operations\_per\_instruction (ubyte) \\
+\item maximum\_operations\_per\_instruction (\addtoindex{ubyte}) \\
 The 
 \addtoindexx{maximum\_operations\_per\_instruction}
 maximum number of individual operations that may be
 The 
 \addtoindexx{maximum\_operations\_per\_instruction}
 maximum number of individual operations that may be
@@ -521,7 +519,7 @@ For non-VLIW
 architectures, this field is 1, the \addtoindex{op\_index register} is always
 0, and the operation pointer is simply the address register.
 
 architectures, this field is 1, the \addtoindex{op\_index register} is always
 0, and the operation pointer is simply the address register.
 
-\item default\_is\_stmt (ubyte) \\
+\item default\_is\_stmt (\addtoindex{ubyte}) \\
 \addtoindexx{default\_is\_stmt}
 The initial value of the \addtoindex{is\_stmt} register.  
 
 \addtoindexx{default\_is\_stmt}
 The initial value of the \addtoindex{is\_stmt} register.  
 
@@ -552,18 +550,14 @@ used as part of support for debugging optimized code.}
 \addtoindexx{line\_base}
 This parameter affects the meaning of the special opcodes. See below.
 
 \addtoindexx{line\_base}
 This parameter affects the meaning of the special opcodes. See below.
 
-\item line\_range (ubyte) \\
+\item line\_range (\addtoindex{ubyte}) \\
 \addtoindexx{line\_range}
 \addtoindexx{line\_range}
-This 
-\addtoindexx{ubyte}
-parameter affects the meaning of the special opcodes. See below.
+This parameter affects the meaning of the special opcodes. See below.
 
 
-\item opcode\_base (ubyte) \\
+\item opcode\_base (\addtoindex{ubyte}) \\
 The 
 \addtoindex{opcode\_base}
 The 
 \addtoindex{opcode\_base}
-number
-\addtoindexx{ubyte}
- assigned to the first special opcode.
+number assigned to the first special opcode.
 
 \textit{Opcode base is typically one greater than the highest-numbered
 \addtoindex{opcode\_base}
 
 \textit{Opcode base is typically one greater than the highest-numbered
 \addtoindex{opcode\_base}
@@ -583,7 +577,7 @@ is greater than the typical value, then the numbers between
 that of the highest standard opcode and the first special
 opcode (not inclusive) are used for vendor specific extensions.}
 
 that of the highest standard opcode and the first special
 opcode (not inclusive) are used for vendor specific extensions.}
 
-\item standard\_opcode\_lengths (array of ubyte) \\
+\item standard\_opcode\_lengths (array of \addtoindex{ubyte}) \\
 \addtoindexx{standard\_opcode\_lengths}
 This array specifies the number of LEB128 operands for each
 of the standard opcodes. The first element of the array
 \addtoindexx{standard\_opcode\_lengths}
 This array specifies the number of LEB128 operands for each
 of the standard opcodes. The first element of the array
@@ -691,7 +685,7 @@ scheduling or other optimization.)
 
 \subsubsection{Special Opcodes} 
 \label{chap:specialopcodes}
 
 \subsubsection{Special Opcodes} 
 \label{chap:specialopcodes}
-Each ubyte special opcode has the following effect on the state machine:
+Each \addtoindex{ubyte} special opcode has the following effect on the state machine:
 
 \begin{enumerate}[1.]
 
 
 \begin{enumerate}[1.]
 
@@ -935,7 +929,7 @@ or more bytes.}
 
 \item \textbf{DW\-\_LNS\-\_fixed\-\_advance\-\_pc} \\ 
 The \livetarg{chap:DWLNSfixedadvancepc}{DW\-\_LNS\-\_fixed\-\_advance\-\_pc} opcode
 
 \item \textbf{DW\-\_LNS\-\_fixed\-\_advance\-\_pc} \\ 
 The \livetarg{chap:DWLNSfixedadvancepc}{DW\-\_LNS\-\_fixed\-\_advance\-\_pc} opcode
-takes a single uhalf (unencoded) operand and adds it to the
+takes a single \addtoindex(uhalf) (unencoded) operand and adds it to the
 address register of the state machine and sets the op\_index
 register to 0. This is the only standard opcode whose operand
 is \textbf{not} a variable length number. It also does 
 address register of the state machine and sets the op\_index
 register to 0. This is the only standard opcode whose operand
 is \textbf{not} a variable length number. It also does 
@@ -1490,7 +1484,7 @@ integral multiple of the address size.
 \item  CIE\_id (4 or 8 bytes, see Section \refersec{datarep:32bitand64bitdwarfformats}) \\
 A constant that is used to distinguish CIEs from FDEs.
 
 \item  CIE\_id (4 or 8 bytes, see Section \refersec{datarep:32bitand64bitdwarfformats}) \\
 A constant that is used to distinguish CIEs from FDEs.
 
-\item  version (ubyte) \\
+\item  version (\addtoindex{ubyte}) \\
 A version number\addtoindexx{version number!call frame information} 
 (see Section \refersec{datarep:callframeinformation}). 
 This number is specific to the call frame information
 A version number\addtoindexx{version number!call frame information} 
 (see Section \refersec{datarep:callframeinformation}). 
 This number is specific to the call frame information
@@ -1523,20 +1517,16 @@ needs to be freed on exit from the routine.}
 any \addtoindex{.debug\_info} section, the augmentation string always uses
 UTF\dash 8 encoding.}
 
 any \addtoindex{.debug\_info} section, the augmentation string always uses
 UTF\dash 8 encoding.}
 
-\item  address\_size (ubyte) \\
+\item  address\_size (\addtoindex{ubyte}) \\
 The size of a target address
 \addtoindexx{address\_size}
 in this CIE and any FDEs that
 The size of a target address
 \addtoindexx{address\_size}
 in this CIE and any FDEs that
-\addtoindexx{ubyte}
 use it, in bytes. If a compilation unit exists for this frame,
 its address size must match the address size here.
 
 use it, in bytes. If a compilation unit exists for this frame,
 its address size must match the address size here.
 
-\item  segment\_size (ubyte) \\
-The 
-\addtoindexx{segment\_size}
-size 
-\addtoindexx{ubyte}
-of a segment selector in this CIE and any FDEs that
+\item  segment\_size (\addtoindex{ubyte}) \\
+The \addtoindexx{segment\_size}
+size of a segment selector in this CIE and any FDEs that
 use it, in bytes.
 
 \item  \addtoindex{code\_alignment\_factor} (unsigned LEB128) \\
 use it, in bytes.
 
 \item  \addtoindex{code\_alignment\_factor} (unsigned LEB128) \\
@@ -1562,7 +1552,7 @@ rule table represents the return address of the function. Note
 that this column might not correspond to an actual machine
 register.
 
 that this column might not correspond to an actual machine
 register.
 
-\item initial\_instructions (array of ubyte) \\
+\item initial\_instructions (array of \addtoindex{ubyte}) \\
 A sequence of rules that are interpreted to create the initial
 setting of each column in the table.  The default rule for
 all columns before interpretation of the initial instructions
 A sequence of rules that are interpreted to create the initial
 setting of each column in the table.  The default rule for
 all columns before interpretation of the initial instructions
@@ -1570,7 +1560,7 @@ is the undefined rule. However, an ABI authoring body or a
 compilation system authoring body may specify an alternate
 default value for any or all columns.
 
 compilation system authoring body may specify an alternate
 default value for any or all columns.
 
-\item padding (array of ubyte) \\
+\item padding (array of \addtoindex{ubyte}) \\
 Enough \livelink{chap:DWCFAnop}{DW\-\_CFA\-\_nop} instructions to make the size of this entry
 match the length value above.
 \end{enumerate}
 Enough \livelink{chap:DWCFAnop}{DW\-\_CFA\-\_nop} instructions to make the size of this entry
 match the length value above.
 \end{enumerate}
@@ -1611,16 +1601,12 @@ number
 \addtoindexx{target address}
 of bytes of program instructions described by this entry.
 
 \addtoindexx{target address}
 of bytes of program instructions described by this entry.
 
-\item instructions (array of ubyte) \\
-A 
-\addtoindexx{ubyte}
-sequence of table defining instructions that are described below.
+\item instructions (array of \addtoindex{ubyte}) \\
+A sequence of table defining instructions that are described below.
 
 
-\item 6. padding (array of ubyte) \\
+\item 6. padding (array of \addtoindex{ubyte}) \\
 Enough \livelink{chap:DWCFAnop}{DW\-\_CFA\-\_nop} instructions 
 Enough \livelink{chap:DWCFAnop}{DW\-\_CFA\-\_nop} instructions 
-to make the size of this
-\addtoindexx{ubyte}
-entry match the length value above.
+to make the size of this entry match the length value above.
 \end{enumerate}
 
 \subsection{Call Frame Instructions}
 \end{enumerate}
 
 \subsection{Call Frame Instructions}
@@ -1691,19 +1677,21 @@ other values in the new row are initially identical to the
 current row
 
 \item \textbf{DW\-\_CFA\-\_advance\-\_loc1} \\
 current row
 
 \item \textbf{DW\-\_CFA\-\_advance\-\_loc1} \\
-The \livetarg{chap:DWCFAadvanceloc1}{DW\-\_CFA\-\_advance\-\_loc1} instruction takes a single ubyte
+The \livetarg{chap:DWCFAadvanceloc1}{DW\-\_CFA\-\_advance\-\_loc1} instruction takes a single \addtoindex{ubyte}
 operand that represents a constant delta. This instruction
 is identical to \livelink{chap:DWCFAadvanceloc}{DW\-\_CFA\-\_advance\-\_loc} except for the encoding
 and size of the delta operand.
 
 \item \textbf{DW\-\_CFA\-\_advance\-\_loc2} \\
 operand that represents a constant delta. This instruction
 is identical to \livelink{chap:DWCFAadvanceloc}{DW\-\_CFA\-\_advance\-\_loc} except for the encoding
 and size of the delta operand.
 
 \item \textbf{DW\-\_CFA\-\_advance\-\_loc2} \\
-The \livetarg{chap:DWCFAadvanceloc2}{DW\-\_CFA\-\_advance\-\_loc2} instruction takes a single uhalf
+The \livetarg{chap:DWCFAadvanceloc2}{DW\-\_CFA\-\_advance\-\_loc2} instruction takes a single
+\addtoindex(uhalf)
 operand that represents a constant delta. This instruction
 is identical to \livelink{chap:DWCFAadvanceloc}{DW\-\_CFA\-\_advance\-\_loc} except for the encoding
 and size of the delta operand.
 
 \item \textbf{DW\-\_CFA\-\_advance\-\_loc4} \\
 operand that represents a constant delta. This instruction
 is identical to \livelink{chap:DWCFAadvanceloc}{DW\-\_CFA\-\_advance\-\_loc} except for the encoding
 and size of the delta operand.
 
 \item \textbf{DW\-\_CFA\-\_advance\-\_loc4} \\
-The \livetarg{chap:DWCFAadvanceloc4}{DW\-\_CFA\-\_advance\-\_loc4} instruction takes a single uword
+The \livetarg{chap:DWCFAadvanceloc4}{DW\-\_CFA\-\_advance\-\_loc4} instruction takes a single
+\addtoindex{uword}
 operand that represents a constant delta. This instruction
 is identical to \livelink{chap:DWCFAadvanceloc}{DW\-\_CFA\-\_advance\-\_loc} except for the encoding
 and size of the delta operand.
 operand that represents a constant delta. This instruction
 is identical to \livelink{chap:DWCFAadvanceloc}{DW\-\_CFA\-\_advance\-\_loc} except for the encoding
 and size of the delta operand.
index bab5c0b..2da260e 100644 (file)
@@ -9,10 +9,12 @@ as bounded by ranges of text addresses within the program.
 
 \section{Unit Entries}
 An object file may contain one or more compilation units,
 
 \section{Unit Entries}
 An object file may contain one or more compilation units,
-of which there are 
+of which there are
+\addtoindexx{unit|see {compilation unit, partial unit \textit{or} type unit}} 
 \addtoindexx{compilation unit}
 three kinds: 
 \addtoindexx{normal compilation unit}
 \addtoindexx{compilation unit}
 three kinds: 
 \addtoindexx{normal compilation unit}
+\addtoindexx{normal compilation unit|see {compilation unit}}
 normal compilation units,
 partial compilation units and 
 \addtoindexx{type unit}
 normal compilation units,
 partial compilation units and 
 \addtoindexx{type unit}
@@ -156,7 +158,7 @@ Language name & Meaning\\ \hline
 \livetarg{chap:DWLANGPascal83}{DW\-\_LANG\-\_Pascal83} & ISO \addtoindex{Pascal}:1983\\
 \livetarg{chap:DWLANGPLI}{DW\-\_LANG\-\_PLI} \dag & ANSI \addtoindex{PL/I}:1976\\
 \livetarg{chap:DWLANGPython}{DW\-\_LANG\-\_Python} \dag & \addtoindex{Python}\\
 \livetarg{chap:DWLANGPascal83}{DW\-\_LANG\-\_Pascal83} & ISO \addtoindex{Pascal}:1983\\
 \livetarg{chap:DWLANGPLI}{DW\-\_LANG\-\_PLI} \dag & ANSI \addtoindex{PL/I}:1976\\
 \livetarg{chap:DWLANGPython}{DW\-\_LANG\-\_Python} \dag & \addtoindex{Python}\\
-\livetarg{chap:DWLANGUPC}{DW\-\_LANG\-\_UPC} &\addtoindex{Unified Parallel C}\\ \hline
+\livetarg{chap:DWLANGUPC}{DW\-\_LANG\-\_UPC} &\addtoindex{Unified Parallel C}\addtoindexx{UPC}\\ \hline
 \dag \ \ Support for these languages is limited.& \\
 \end{tabular}
 \end{figure}
 \dag \ \ Support for these languages is limited.& \\
 \end{tabular}
 \end{figure}
@@ -283,7 +285,8 @@ to interpret a type conversion to a base type
 \hypertarget{chap:DWATuseUTF8compilationunitusesutf8strings}
 correctly.
 
 \hypertarget{chap:DWATuseUTF8compilationunitusesutf8strings}
 correctly.
 
-\item A \livelink{chap:DWATuseUTF8}{DW\-\_AT\-\_use\-\_UTF8} attribute, 
+\item A \livelink{chap:DWATuseUTF8}{DW\-\_AT\-\_use\-\_UTF8} attribute,
+\addtoindexx{use UTF8 attribute}\addtoindexx{UTF-8} 
 which is a \livelink{chap:flag}{flag} whose
 presence indicates that all strings (such as the names of
 declared entities in the source program) are represented
 which is a \livelink{chap:flag}{flag} whose
 presence indicates that all strings (such as the names of
 declared entities in the source program) are represented
@@ -537,6 +540,7 @@ reference to a namespace.}
 \textit{The \addtoindex{C++} 
 compilation unit specific ``unnamed namespace'' may
 \addtoindexx{namespace (C++)!unnamed}
 \textit{The \addtoindex{C++} 
 compilation unit specific ``unnamed namespace'' may
 \addtoindexx{namespace (C++)!unnamed}
+\addtoindexx{unnamed namespace|see {namespace (C++), unnamed}}
 be represented by a namespace entry with no name attribute in
 the original namespace declaration entry (and therefore no name
 attribute in any namespace extension entry of this namespace).
 be represented by a namespace entry with no name attribute in
 the original namespace declaration entry (and therefore no name
 attribute in any namespace extension entry of this namespace).
@@ -640,6 +644,7 @@ an imported entity, other than a namespace).
 
 \textit{A \addtoindex{Fortran} use statement 
 \addtoindexx{Fortran!use statement}
 
 \textit{A \addtoindex{Fortran} use statement 
 \addtoindexx{Fortran!use statement}
+\addtoindexx{use statement|see {Fortran, use statement}}
 with an ``only list'' may be
 represented by a series of imported declaration entries,
 one (or more) for each entity that is imported. An entity
 with an ``only list'' may be
 represented by a series of imported declaration entries,
 one (or more) for each entity that is imported. An entity
@@ -680,10 +685,10 @@ name in that module. Any entity in the module that is not
 renamed in this way is known in the context of the imported
 module entry by the same name as it is declared in the module.
 
 renamed in this way is known in the context of the imported
 module entry by the same name as it is declared in the module.
 
-\textit{A \addtoindex{C++} using directive 
-may be represented by an 
+\textit{A \addtoindex{C++} using directive
 \addtoindexx{namespace (C++)!using directive}
 \addtoindexx{namespace (C++)!using directive}
-imported module
+\addtoindexx{using directive|see {namespace (C++), using directive}} 
+may be represented by an imported module
 \hypertarget{chap:DWATimportnamespaceusingdirective}
 entry, with an import attribute referring to the namespace
 entry of the appropriate extension of the namespace (which
 \hypertarget{chap:DWATimportnamespaceusingdirective}
 entry, with an import attribute referring to the namespace
 entry of the appropriate extension of the namespace (which
@@ -699,7 +704,8 @@ corresponding to those entities that are renamed as part of
 being imported.
 }
 
 being imported.
 }
 
-\textit{A \addtoindex{Fortran} use statement 
+\textit{A \addtoindex{Fortran} use statement
+\addtoindexx{Fortran!use statement}
 with neither a “rename list” nor
 an “only list” may be represented by an imported module
 entry with an import attribute referring to the module and
 with neither a “rename list” nor
 an “only list” may be represented by an imported module
 entry with an import attribute referring to the module and
@@ -712,6 +718,7 @@ in Section \refersec{chap:importedorrenameddeclarationentries}.
 }
 
 \textit{A \addtoindex{Fortran} use statement for an entity in a module that is
 }
 
 \textit{A \addtoindex{Fortran} use statement for an entity in a module that is
+\addtoindexx{Fortran!use statement}
 itself imported by a use statement without an explicit mention
 may be represented by an imported declaration entry that refers
 to the original debugging information entry. For example, given
 itself imported by a use statement without an explicit mention
 may be represented by an imported declaration entry that refers
 to the original debugging information entry. For example, given
@@ -734,8 +741,10 @@ the imported declaration entry for Q within module C refers
 directly to the variable declaration entry for A in module A
 because there is no explicit representation for X in module B.
 
 directly to the variable declaration entry for A in module A
 because there is no explicit representation for X in module B.
 
-A similar situation arises for a \addtoindex{C++} using declaration that
-imports an entity in terms of a namespace alias. See 
+A similar situation arises for a \addtoindex{C++} using declaration
+\addtoindexx{namespace (C++)!using declaration}
+\addtoindexx{using declaration|see {namespace (C++), using declaration}}
+that imports an entity in terms of a namespace alias. See 
 Appendix  \refersec{app:namespaceexample}
 for an example.
 
 Appendix  \refersec{app:namespaceexample}
 for an example.
 
@@ -1093,7 +1102,8 @@ debuggers to support this same kind of referencing.}
 If 
 \hypertarget{chap:DWATstaticlinklocationofuplevelframe}
 a 
 If 
 \hypertarget{chap:DWATstaticlinklocationofuplevelframe}
 a 
-\addtoindexx{address!uplevel|see{static link attribute}}
+\addtoindexx{address!uplevel|see {static link attribute}}
+\addtoindexx{uplevel address|see {static link attribute}}
 subroutine or entry point is nested, it may have a
 \livelink{chap:DWATstaticlink}{DW\-\_AT\-\_static\-\_link}
 attribute, whose value is a location
 subroutine or entry point is nested, it may have a
 \livelink{chap:DWATstaticlink}{DW\-\_AT\-\_static\-\_link}
 attribute, whose value is a location
index 307f779..4e354af 100644 (file)
@@ -199,7 +199,7 @@ floating\dash point number \\
 \livetarg{chap:DWATEsignedfixed}{DW\-\_ATE\-\_signed\-\_fixed} & signed fixed\dash point scaled integer \\
 \livetarg{chap:DWATEunsignedfixed}{DW\-\_ATE\-\_unsigned\-\_fixed}& unsigned fixed\dash point scaled integer \\
 \livetarg{chap:DWATEdecimalfloat}{DW\-\_ATE\-\_decimal\-\_float} & decimal floating\dash point number \\ 
 \livetarg{chap:DWATEsignedfixed}{DW\-\_ATE\-\_signed\-\_fixed} & signed fixed\dash point scaled integer \\
 \livetarg{chap:DWATEunsignedfixed}{DW\-\_ATE\-\_unsigned\-\_fixed}& unsigned fixed\dash point scaled integer \\
 \livetarg{chap:DWATEdecimalfloat}{DW\-\_ATE\-\_decimal\-\_float} & decimal floating\dash point number \\ 
-\livetarg{chap:DWATEUTF}{DW\-\_ATE\-\_UTF} & Unicode character \\
+\livetarg{chap:DWATEUTF}{DW\-\_ATE\-\_UTF} & \addtoindex{Unicode} character \\
 \end{tabular}
 \caption{Encoding attribute values}
 \label{fig:encodingattributevalues}
 \end{tabular}
 \caption{Encoding attribute values}
 \label{fig:encodingattributevalues}
@@ -209,8 +209,8 @@ floating\dash point number \\
 floating\dash point representations that have a power\dash of\dash ten
 exponent, such as that specified in IEEE 754R.}
 
 floating\dash point representations that have a power\dash of\dash ten
 exponent, such as that specified in IEEE 754R.}
 
-\textit{The \livelink{chap:DWATEUTF}{DW\-\_ATE\-\_UTF} encoding is intended for Unicode string
-encodings (see the Universal Character Set standard,
+\textit{The \livelink{chap:DWATEUTF}{DW\-\_ATE\-\_UTF} encoding is intended for \addtoindex{Unicode}
+string encodings (see the Universal Character Set standard,
 ISO/IEC 10646\dash 1:1993). For example, the 
 \addtoindex{C++} type char16\_t is
 represented by a base type entry with a name attribute whose
 ISO/IEC 10646\dash 1:1993). For example, the 
 \addtoindex{C++} type char16\_t is
 represented by a base type entry with a name attribute whose
@@ -528,7 +528,7 @@ rvalue
 \addtoindexx{restricted type entry}
 reference to an object of the type being modified 
 \addtoindexx{rvalue reference qualified type entry} \\
 \addtoindexx{restricted type entry}
 reference to an object of the type being modified 
 \addtoindexx{rvalue reference qualified type entry} \\
-\livetarg{chap:DWTAGsharedtype}{DW\-\_TAG\-\_shared\-\_type}&UPC shared qualified type 
+\livetarg{chap:DWTAGsharedtype}{DW\-\_TAG\-\_shared\-\_type}&\addtoindex{UPC} shared qualified type 
 \addtoindexx{shared qualified type entry} \\
 \livetarg{chap:DWTAGvolatiletype}{DW\-\_TAG\-\_volatile\-\_type}&C or C++ volatile qualified type 
 \addtoindex{volatile qualified type entry} \\
 \addtoindexx{shared qualified type entry} \\
 \livetarg{chap:DWTAGvolatiletype}{DW\-\_TAG\-\_volatile\-\_type}&C or C++ volatile qualified type 
 \addtoindex{volatile qualified type entry} \\
@@ -543,25 +543,30 @@ reference to an object of the type being modified
 declarations:}
 
 \begin{alltt}
 declarations:}
 
 \begin{alltt}
-const unsigned char * volatile p;
-    which represents a volatile pointer to a constant
-    character. This is encoded in DWARF as:
+   const unsigned char * volatile p;
+\end{alltt}
+\textit{which represents a volatile pointer to a constant
+character. This is encoded in DWARF as:}
+\begin{alltt}
         \livelink{chap:DWTAGvariable}{DW\-\_TAG\-\_variable}(p) -->
             \livelink{chap:DWTAGvolatiletype}{DW\-\_TAG\-\_volatile\-\_type} -->
                 \livelink{chap:DWTAGpointertype}{DW\-\_TAG\-\_pointer\-\_type} -->
                     \livelink{chap:DWTAGconsttype}{DW\-\_TAG\-\_const\-\_type} -->
                         \livelink{chap:DWTAGbasetype}{DW\-\_TAG\-\_base\-\_type}(unsigned char)
         \livelink{chap:DWTAGvariable}{DW\-\_TAG\-\_variable}(p) -->
             \livelink{chap:DWTAGvolatiletype}{DW\-\_TAG\-\_volatile\-\_type} -->
                 \livelink{chap:DWTAGpointertype}{DW\-\_TAG\-\_pointer\-\_type} -->
                     \livelink{chap:DWTAGconsttype}{DW\-\_TAG\-\_const\-\_type} -->
                         \livelink{chap:DWTAGbasetype}{DW\-\_TAG\-\_base\-\_type}(unsigned char)
-
-volatile unsigned char * const restrict p;
-    on the other hand, represents a restricted constant
-    pointer to a volatile character. This is encoded as:
+\end{alltt}
+\textit{On the other hand}
+\begin{alltt}                        
+   volatile unsigned char * const restrict p;
+\end{alltt}
+\textit{represents a restricted constant
+pointer to a volatile character. This is encoded as:}
+\begin{alltt}
         \livelink{chap:DWTAGvariable}{DW\-\_TAG\-\_variable}(p) -->
             \livelink{chap:DWTAGrestricttype}{DW\-\_TAG\-\_restrict\-\_type} -->
                 \livelink{chap:DWTAGconsttype}{DW\-\_TAG\-\_const\-\_type} -->
                     \livelink{chap:DWTAGpointertype}{DW\-\_TAG\-\_pointer\-\_type} -->
                         \livelink{chap:DWTAGvolatiletype}{DW\-\_TAG\-\_volatile\-\_type} -->
                             \livelink{chap:DWTAGbasetype}{DW\-\_TAG\-\_base\-\_type}(unsigned char)
         \livelink{chap:DWTAGvariable}{DW\-\_TAG\-\_variable}(p) -->
             \livelink{chap:DWTAGrestricttype}{DW\-\_TAG\-\_restrict\-\_type} -->
                 \livelink{chap:DWTAGconsttype}{DW\-\_TAG\-\_const\-\_type} -->
                     \livelink{chap:DWTAGpointertype}{DW\-\_TAG\-\_pointer\-\_type} -->
                         \livelink{chap:DWTAGvolatiletype}{DW\-\_TAG\-\_volatile\-\_type} -->
                             \livelink{chap:DWTAGbasetype}{DW\-\_TAG\-\_base\-\_type}(unsigned char)
-
 \end{alltt}
 
 \section{Typedef Entries}
 \end{alltt}
 
 \section{Typedef Entries}
@@ -705,9 +710,7 @@ Other attributes especially applicable to arrays are
 \livelink{chap:DWATdatalocation}{DW\-\_AT\-\_data\-\_location},
 which are described in 
 Section \refersec{chap:dynamictypeproperties}. 
 \livelink{chap:DWATdatalocation}{DW\-\_AT\-\_data\-\_location},
 which are described in 
 Section \refersec{chap:dynamictypeproperties}. 
-For relevant examples,
-see also 
-Appendix \refersec{app:fortran90example}.
+For relevant examples, see also Appendix \refersec{app:fortran90example}.
 
 \section{ Structure, Union, Class and Interface Type Entries}
 \label{chap:structureunionclassandinterfacetypeentries}
 
 \section{ Structure, Union, Class and Interface Type Entries}
 \label{chap:structureunionclassandinterfacetypeentries}
 \livelink{chap:DWATthreadsscaled}{DW\-\_AT\-\_threads\-\_scaled} attribute,
 which is a \livelink{chap:flag}{flag}. 
 If present, this attribute indicates whether
 \livelink{chap:DWATthreadsscaled}{DW\-\_AT\-\_threads\-\_scaled} attribute,
 which is a \livelink{chap:flag}{flag}. 
 If present, this attribute indicates whether
-this subrange represents a UPC array bound which is scaled
+this subrange represents a \addtoindex{UPC} array bound which is scaled
 by the runtime THREADS value (the number of UPC threads in
 this execution of the program).
 
 by the runtime THREADS value (the number of UPC threads in
 this execution of the program).
 
-\textit{This allows the representation of a UPC shared array such as}
+\textit{This allows the representation of a \addtoindex{UPC} shared array such as}
 
 \begin{lstlisting}
 int shared foo[34*THREADS][10][20];
 
 \begin{lstlisting}
 int shared foo[34*THREADS][10][20];
@@ -2052,7 +2055,9 @@ subrange
 \hypertarget{chap:DWATupperboundupperboundofsubrange}
 entry may have the attributes 
 \livelink{chap:DWATlowerbound}{DW\-\_AT\-\_lower\-\_bound}
 \hypertarget{chap:DWATupperboundupperboundofsubrange}
 entry may have the attributes 
 \livelink{chap:DWATlowerbound}{DW\-\_AT\-\_lower\-\_bound}
-and \livelink{chap:DWATupperbound}{DW\-\_AT\-\_upper\-\_bound} to specify, respectively, the lower
+\addtoindexx{lower bound attribute}
+and \livelink{chap:DWATupperbound}{DW\-\_AT\-\_upper\-\_bound}
+\addtoindexx{upper bound attribute} to specify, respectively, the lower
 and upper bound values of the subrange. The 
 \livelink{chap:DWATupperbound}{DW\-\_AT\-\_upper\-\_bound}
 attribute 
 and upper bound values of the subrange. The 
 \livelink{chap:DWATupperbound}{DW\-\_AT\-\_upper\-\_bound}
 attribute 
@@ -2073,8 +2078,7 @@ Section \refersec{chap:staticanddynamicvaluesofattributes}.
 If the lower bound value is missing, the value is assumed to
 be a language\dash dependent default constant. 
 \addtoindexx{lower bound attribute!default}
 If the lower bound value is missing, the value is assumed to
 be a language\dash dependent default constant. 
 \addtoindexx{lower bound attribute!default}
-The default lower
-bound is 0 for 
+The default lower bound is 0 for 
 \addtoindex{C}, \addtoindex{C++}, 
 \addtoindex{D}, 
 \addtoindex{Java}, 
 \addtoindex{C}, \addtoindex{C++}, 
 \addtoindex{D}, 
 \addtoindex{Java}, 
@@ -2092,7 +2096,7 @@ The default lower bound is 1 for
 \textit{No other default lower bound values are currently defined.}
 
 If the upper bound and count are missing, then the upper bound value is 
 \textit{No other default lower bound values are currently defined.}
 
 If the upper bound and count are missing, then the upper bound value is 
-\textit{unknown}.
+\textit{unknown}.\addtoindexx{upper bound attribute!default unknown}
 
 If the subrange entry has no type attribute describing the
 basis type, the basis type is assumed to be the same as
 
 If the subrange entry has no type attribute describing the
 basis type, the basis type is assumed to be the same as
@@ -2166,6 +2170,7 @@ has
 \addtoindex{pointer to member entry} 
 a 
 \livelink{chap:DWATuselocation}{DW\-\_AT\-\_use\-\_location} attribute
 \addtoindex{pointer to member entry} 
 a 
 \livelink{chap:DWATuselocation}{DW\-\_AT\-\_use\-\_location} attribute
+\addtoindexx{use location attribute}
 whose value is a 
 \addtoindex{location description} that computes the
 address of the member of the class to which the pointer to
 whose value is a 
 \addtoindex{location description} that computes the
 address of the member of the class to which the pointer to