More d* index entries added.
authorDavid Anderson <davea42@earthlink.net>
Sat, 10 Nov 2012 17:41:55 +0000 (09:41 -0800)
committerDavid Anderson <davea42@earthlink.net>
Sat, 10 Nov 2012 17:41:55 +0000 (09:41 -0800)
dwarf5/latexdoc/attributesbytag.tex
dwarf5/latexdoc/dataobject.tex
dwarf5/latexdoc/examples.tex
dwarf5/latexdoc/generaldescription.tex
dwarf5/latexdoc/otherdebugginginformation.tex
dwarf5/latexdoc/programscope.tex
dwarf5/latexdoc/typeentries.tex

index 467ed19..9fb85e4 100644 (file)
@@ -15,8 +15,15 @@ entry. Therefore, the list may be taken as instructive, but
 cannot be considered definitive.  
 
 In the following table,
-DECL means the declaration coordinates \livelink{chap:DWATdeclcolumn}{DW\-\_AT\-\_decl\-\_column},
-\livelink{chap:DWATdeclfile}{DW\-\_AT\-\_decl\-\_file}, and \livelink{chap:DWATdeclline}{DW\-\_AT\-\_decl\-\_line}.
+\addtoindex{DECL} 
+means 
+\addtoindex{declaration coordinates} 
+the 
+\addtoindex{declaration coordinates|see {DW\_AT\_decl\_file,DW\_AT\_decl\_line, DW\_AT\_decl\_column}}
+declaration coordinates 
+\livelink{chap:DWATdeclcolumn}{DW\-\_AT\-\_decl\-\_column},
+\livelink{chap:DWATdeclfile}{DW\-\_AT\-\_decl\-\_file}, and 
+\livelink{chap:DWATdeclline}{DW\-\_AT\-\_decl\-\_line}.
 
 
 \label{tab:attributesbytag}
index f5122f1..ed151e7 100644 (file)
@@ -42,6 +42,7 @@ external. Both file static and local variables in C and C++
 are represented by non-external variable entries.
 
 \item A \livelink{chap:DWATdeclaration}{DW\-\_AT\-\_declaration} attribute, 
+\addtoindexx{declaration attribute}
 which is a \livelink{chap:flag}{flag} that
 indicates whether this entry represents a non-defining
 declaration of an object.
@@ -49,7 +50,10 @@ declaration of an object.
 \item A \livelink{chap:DWATlocation}{DW\-\_AT\-\_location} attribute, whose value describes the
 location of a variable or parameter at run-time.  In a variable
 entry representing the definition of a variable (that is,
-with no \livelink{chap:DWATdeclaration}{DW\-\_AT\-\_declaration} attribute) if no location attribute
+\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
 an empty location description (as described in Section 2.6),
 the variable is assumed to exist in the source code but not
@@ -101,7 +105,9 @@ value in the calling function cannot be modified by the callee.
 which is a \livelink{chap:flag}{flag}, if a
 parameter entry represents an optional parameter.
 
-\item A \livelink{chap:DWATdefaultvalue}{DW\-\_AT\-\_default\-\_value} attribute for a formal parameter
+\item A \livelink{chap:DWATdefaultvalue}{DW\-\_AT\-\_default\-\_value} attribute 
+\addtoindexx{default value attribute}
+for a formal parameter
 \hypertarget{chap:DWATdefaultvaluedefaultvalueofparameter}
 entry. The value of this attribute is a reference to the
 debugging information entry for a variable or subroutine,
index 4f3ae06..b3dec1f 100644 (file)
@@ -185,7 +185,9 @@ end do
 \end{figure}
 
 For allocatable and pointer arrays, it is essentially required
-by the Fortran 90 semantics that each array consist of two
+by the Fortran 90 semantics that each array consist of 
+\addtoindexx{descriptor!array}
+two
 \addtoindexx{array!descriptor for}
 parts, which we here call 1) the descriptor and 2) the raw
 data. (A descriptor has often been called a dope vector in
index fdfcad7..6c619c4 100644 (file)
@@ -4,7 +4,9 @@
 \label{chap:thedebuggingentrydie}
 DWARF 
 \addtoindexx{debugging information entry}
-uses a series of debugging information entries (DIEs) to 
+uses 
+\addtoindexx{DIE|see{debugging information entry}}
+a series of debugging information entries (DIEs) to 
 define a low-level
 representation of a source program. 
 Each debugging information entry consists of an identifying
@@ -29,7 +31,8 @@ debugging information entries, are described in
 this section and not necessarily mentioned in all
 contexts where they may be appropriate. 
 Examples include \livelink{chap:DWATartificial}{DW\-\_AT\-\_artificial}, the declaration
-coordinates, and \livelink{chap:DWATdescription}{DW\-\_AT\-\_description}, among others.
+coordinates, and 
+\livelink{chap:DWATdescription}{DW\-\_AT\-\_description}, among others.
 
 The debugging information entries are contained 
 in the \addtoindex{.debug\_info} and 
@@ -1619,8 +1622,11 @@ value of the variable x passed to the function g is the value of the
 global variable x rather than of the local version.}
 
 \subsection{Non-Defining Declarations}
-A debugging information entry that represents a non-defining or otherwise incomplete
-declaration of a program entity has a 
+A debugging information entry that 
+represents a non-defining or otherwise incomplete
+declaration of a program entity has 
+\addtoindexx{declaration attribute}
+a 
 \livelink{chap:DWATdeclaration}{DW\-\_AT\-\_declaration} 
 attribute, which is a 
 \livelink{chap:flag}{flag}.
@@ -1642,9 +1648,12 @@ It is not the case that all attributes of the debugging information entry refere
 \livelink{chap:DWATspecification}{DW\-\_AT\-\_specification} attribute 
 apply to the referring debugging information entry.
 
-\textit{For example,
+\textit{For 
+\addtoindexx{declaration attribute}
+example,
 \livelink{chap:DWATsibling}{DW\-\_AT\-\_sibling} and 
 \livelink{chap:DWATdeclaration}{DW\-\_AT\-\_declaration} 
+\addtoindexx{declaration attribute}
 clearly cannot apply to a referring
 entry.}
 
@@ -1652,7 +1661,9 @@ entry.}
 
 \section{Declaration Coordinates}
 \label{chap:declarationcoordinates}
-\textit{It is sometimes useful in a debugger to be able to associate
+\textit{It is 
+\addtoindexx{declaration coordinates}
+sometimes useful in a debugger to be able to associate
 a declaration with its occurrence in the program source.
 }
 
@@ -1663,11 +1674,23 @@ entry
 representing 
 \hypertarget{chap:DWATdeclcolumncolumnpositionofsourcedeclaration}
 the
-declaration of an object, module, subprogram or type may have
-\livelink{chap:DWATdeclfile}{DW\-\_AT\-\_decl\-\_file}, \livelink{chap:DWATdeclline}{DW\-\_AT\-\_decl\-\_line} and \livelink{chap:DWATdeclcolumn}{DW\-\_AT\-\_decl\-\_column}
+declaration of an object, module, subprogram or
+\addtoindex{declaration column attribute}
+type 
+\addtoindex{declaration file attribute}
+may 
+\addtoindex{declaration line attribute}
+have
+\livelink{chap:DWATdeclfile}{DW\-\_AT\-\_decl\-\_file}, 
+\livelink{chap:DWATdeclline}{DW\-\_AT\-\_decl\-\_line} and 
+\livelink{chap:DWATdeclcolumn}{DW\-\_AT\-\_decl\-\_column}
 attributes each of whose value is an unsigned integer constant.
 
-The value of the \livelink{chap:DWATdeclfile}{DW\-\_AT\-\_decl\-\_file} attribute corresponds to
+The value of 
+\addtoindex{declaration file attribute}
+the 
+\livelink{chap:DWATdeclfile}{DW\-\_AT\-\_decl\-\_file}
+attribute corresponds to
 a file number from the line number information table for the
 compilation unit containing the debugging information entry and
 represents the source file in which the declaration appeared
@@ -1675,12 +1698,16 @@ represents the source file in which the declaration appeared
 The value 0 indicates that no source file
 has been specified.
 
-The value of the \livelink{chap:DWATdeclline}{DW\-\_AT\-\_decl\-\_line} attribute represents
+The value of 
+\addtoindex{declaration line attribute}
+the \livelink{chap:DWATdeclline}{DW\-\_AT\-\_decl\-\_line} attribute represents
 the source line number at which the first character of
 the identifier of the declared object appears. The value 0
 indicates that no source line has been specified.
 
-The value of the \livelink{chap:DWATdeclcolumn}{DW\-\_AT\-\_decl\-\_column} attribute represents
+The value of 
+\addtoindex{declaration column attribute}
+the \livelink{chap:DWATdeclcolumn}{DW\-\_AT\-\_decl\-\_column} attribute represents
 the source column number at which the first character of
 the identifier of the declared object appears. The value 0
 indicates that no column has been specified.
@@ -1952,7 +1979,9 @@ entry that
 \hypertarget{chap:DWATdescriptionartificialnameordescription}
 has, or may have, a 
 \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, may
-also have a 
+also have 
+\addtoindexx{description attribute}
+a 
 \livelink{chap:DWATdescription}{DW\-\_AT\-\_description} attribute whose value is a
 null-terminated string providing a description of the entity.
 
index 88cc2c5..636e5bb 100644 (file)
@@ -387,7 +387,7 @@ op\_index & 0 \\
 file & 1 \\
 line & 1 \\
 column & 0 \\
-is\_stmt & determined by default\_is\_stmt in the line number program header \\
+is\_stmt & determined by \addtoindex{default\_is\_stmt} in the line number program header \\
 basic\_block & ``false'' \addtoindexx{basic block} \\
 end\_sequence & ``false'' \\
 prologue\_end & ``false'' \\
@@ -477,6 +477,7 @@ architectures, this field is 1, the op\_index register is always
 0, and the operation pointer is simply the address register.
 
 \item default\_is\_stmt (ubyte) \\
+\addtoindexx{default\_is\_stmt}
 The initial value of the is\_stmt register.  
 
 \textit{A simple approach
index 5ff7b07..abba05b 100644 (file)
@@ -339,7 +339,9 @@ those entities.}
 \textit{Several languages have the concept of a ``module.''
 \addtoindexx{Modula-2}
 A Modula\dash 2 definition module may be represented by a module
-entry containing a declaration attribute (\livelink{chap:DWATdeclaration}{DW\-\_AT\-\_declaration}). A
+entry containing a 
+\addtoindex{declaration attribute}
+(\livelink{chap:DWATdeclaration}{DW\-\_AT\-\_declaration}). A
 \addtoindex{Fortran 90} module may also be represented by a module entry
 (but no declaration attribute is warranted because \addtoindex{Fortran}
 has no concept of a corresponding module body).}
@@ -1171,7 +1173,8 @@ represented as it would be on the target architecture.
 
 \textit{In \addtoindex{C++}, if a function or a constructor declared with constexpr
 is called with constant expressions, then the corresponding
-concrete inlined instance has a \livelink{chap:DWATconstexpr}{DW\-\_AT\-\_const\-\_expr} attribute,
+concrete inlined instance has a 
+\livelink{chap:DWATconstexpr}{DW\-\_AT\-\_const\-\_expr} attribute,
 as well as a \livelink{chap:DWATconstvalue}{DW\-\_AT\-\_const\-\_value} attribute whose value represents
 the actual return value of the concrete inlined instance.}
 
@@ -1217,7 +1220,10 @@ value of the abstract origin attribute is a reference to the
 associated abstract instance entry.
 
 If an entry within a concrete inlined instance tree contains
-attributes describing the declaration coordinates of that
+attributes describing the 
+\addtoindexx{declaration coordinates!in concrete instance}
+declaration coordinates 
+of that
 entry, then those attributes should refer to the file, line
 and column of the original declaration of the subroutine,
 not to the point at which it was inlined. As a consequence,
index 992e10b..6358333 100644 (file)
@@ -700,6 +700,7 @@ to hold an instance of the structure, union or class type,
 including any padding.  An incomplete structure, union or
 class type is represented by a structure, union or class
 entry that does not have a byte size attribute and that has
+\addtoindexx{declaration attribute}
 a \livelink{chap:DWATdeclaration}{DW\-\_AT\-\_declaration} attribute.
 
 If the complete declaration of a type has been placed in
@@ -791,7 +792,10 @@ declarations in the source program.
 \subsection{Derived or Extended Structs, Classes and Interfaces}
 \label{chap:derivedorextendedstructsclasesandinterfaces}
 
-\textit{In \addtoindex{C++}, a class (or struct) may be ``derived from'' or be a
+\textit{In \addtoindex{C++}, a class (or struct) 
+may 
+\addtoindexx{derived type (C++)|see{inheritance entry}}
+be ``derived from'' or be a
 ``subclass of'' another class. In Java, an interface may ``extend''
 one or more other interfaces, and a class may ``extend'' another
 class and/or ``implement'' one or more interfaces. All of these