Indexing i and j is done.
[dwarf-doc.git] / dwarf5 / latexdoc / generaldescription.tex
index 1b2d8d7..4ed0ce1 100644 (file)
@@ -507,7 +507,6 @@ Many places in this document
 refer
 \addtoindexx{address size|see{size of an address}}
 to the size 
-\addtoindexx{address!size of an|see{size of an address}}
 of an
 \addtoindexi{address}{size of an address}
 on the target architecture (or equivalently, target machine)
@@ -1151,7 +1150,8 @@ one of the register based addressing operations, such as
 
 \paragraph{Implicit Location Descriptions}
 
-An implicit location description represents a piece or all
+An \addtoindex{implicit location description}
+represents a piece or all
 of an object which has no actual location but whose contents
 are nonetheless either known or known to be undefined.
 
@@ -1635,6 +1635,7 @@ A debugging information entry representing a program entity
 typically represents the defining declaration of that
 entity. In certain contexts, however, a debugger might need
 information about a declaration of an entity that is not
+\addtoindexx{incomplete declaration}
 also a definition, or is otherwise incomplete, to evaluate
 \hypertarget{chap:DWATdeclarationincompletenondefiningorseparateentitydeclaration}
 an expression correctly.
@@ -1659,8 +1660,11 @@ 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 
+represents a non-defining or 
+\addtoindex{non-defining declaration}
+otherwise 
+\addtoindex{incomplete declaration}
+of a program entity has 
 \addtoindexx{declaration attribute}
 a 
 \livelink{chap:DWATdeclaration}{DW\-\_AT\-\_declaration} 
@@ -1726,7 +1730,9 @@ The value of
 \addtoindex{declaration file attribute}
 the 
 \livelink{chap:DWATdeclfile}{DW\-\_AT\-\_decl\-\_file}
-attribute corresponds to
+attribute 
+\addtoindexx{file containing declaration}
+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
@@ -1752,7 +1758,9 @@ indicates that no column has been specified.
 \label{chap:identifiernames}
 Any 
 \hypertarget{chap:DWATnamenameofdeclaration}
-debugging information entry representing a program entity
+debugging information entry 
+\addtoindexx{identifier names}
+representing a program entity
 that has been given a name may have a 
 \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute,
 whose value is a string representing the name as it appears in
@@ -1816,11 +1824,18 @@ and
 the like, may have
 
 \begin{itemize}
-\item A \livelink{chap:DWATlowpc}{DW\-\_AT\-\_low\-\_pc} and \livelink{chap:DWAThighpc}{DW\-\_AT\-\_high\-\_pc} pair of 
-attributes for a single contiguous range of
+\item A \livelink{chap:DWATlowpc}{DW\-\_AT\-\_low\-\_pc} and 
+\livelink{chap:DWAThighpc}{DW\-\_AT\-\_high\-\_pc} pair of 
+attributes 
+\addtoindexx{high PC attribute}
+for 
+\addtoindexx{low PC attribute}
+a single contiguous range of
 addresses, or
 
-\item A \livelink{chap:DWATranges}{DW\-\_AT\-\_ranges} attribute for a non-contiguous range of addresses.
+\item A \livelink{chap:DWATranges}{DW\-\_AT\-\_ranges} attribute 
+\addtoindexx{ranges attribute}
+for a non-contiguous range of addresses.
 \end{itemize}
 
 In addition, a non-contiguous range of 
@@ -1843,9 +1858,17 @@ insufficient reason to change this.
 \subsection{Continuous Address Range}
 \label{chap:contiguousaddressranges}
 When the set of addresses of a debugging information entry can
-be described as a single continguous range, the entry may have
-a \livelink{chap:DWATlowpc}{DW\-\_AT\-\_low\-\_pc} and \livelink{chap:DWAThighpc}{DW\-\_AT\-\_high\-\_pc} pair of attributes. The value
-of the \livelink{chap:DWATlowpc}{DW\-\_AT\-\_low\-\_pc} attribute is the relocated address of the
+be described as a single continguous range, the entry 
+\addtoindexx{high PC attribute}
+may 
+\addtoindexx{low PC attribute}
+have
+a \livelink{chap:DWATlowpc}{DW\-\_AT\-\_low\-\_pc} and 
+\livelink{chap:DWAThighpc}{DW\-\_AT\-\_high\-\_pc} pair of attributes. 
+The value
+of the 
+\livelink{chap:DWATlowpc}{DW\-\_AT\-\_low\-\_pc} attribute 
+is the relocated address of the
 first instruction associated with the entity. If the value of
 the \livelink{chap:DWAThighpc}{DW\-\_AT\-\_high\-\_pc} is of class address, it is the relocated
 address of the first location past the last instruction
@@ -1864,7 +1887,9 @@ attributes should be produced.
 \label{chap:noncontiguousaddressranges}
 When the set of addresses of a debugging information entry
 cannot be described as a single contiguous range, the entry has
-a \livelink{chap:DWATranges}{DW\-\_AT\-\_ranges} attribute whose value is of class \livelink{chap:rangelistptr}{rangelistptr}
+a \livelink{chap:DWATranges}{DW\-\_AT\-\_ranges} attribute 
+\addtoindexx{ranges attribute}
+whose value is of class \livelink{chap:rangelistptr}{rangelistptr}
 and indicates the beginning of a range list. Similarly,
 a \livelink{chap:DWATstartscope}{DW\-\_AT\-\_start\-\_scope} attribute may have a value of class
 \livelink{chap:rangelistptr}{rangelistptr} for the same reason.  
@@ -1874,6 +1899,7 @@ in a separate object file section called
 \addtoindex{.debug\_ranges}. A
 range list is indicated by a 
 \livelink{chap:DWATranges}{DW\-\_AT\-\_ranges} attribute whose
+\addtoindexx{ranges attribute}
 value is represented as an offset from the beginning of the
 \addtoindex{.debug\_ranges} section to the beginning of the range list.