compression.tex
[dwarf-doc.git] / dwarf5 / latexdoc / programscope.tex
index 4b88e8c..b493c89 100644 (file)
@@ -70,8 +70,13 @@ attributes:
 
 \begin{enumerate}[1]
 \item Either a \livelink{chap:DWATlowpc}{DW\-\_AT\-\_low\-\_pc} and \livelink{chap:DWAThighpc}{DW\-\_AT\-\_high\-\_pc} pair of
-attributes or a \livelink{chap:DWATranges}{DW\-\_AT\-\_ranges} attribute whose values encode the
-contiguous or non\dash contiguous address ranges, respectively,
+attributes or a 
+\livelink{chap:DWATranges}{DW\-\_AT\-\_ranges} attribute
+whose values encode 
+\addtoindexx{discontiguous address ranges|see{non-contiguous address ranges}}
+the
+contiguous or 
+non\dash contiguous address ranges, respectively,
 of the machine instructions generated for the compilation
 unit (see Section {chap:codeaddressesandranges}).  
 A \livelink{chap:DWATlowpc}{DW\-\_AT\-\_low\-\_pc} attribute may also
@@ -339,7 +344,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).}
@@ -834,7 +841,8 @@ entries may be interspersed with other entries used by formal
 parameter entries, such as type entries.}
 
 The unspecified parameters of a variable parameter list are
-represented by a debugging information entry with the tag
+represented by a debugging information entry\addtoindexx{unspecified parameters entry}
+with the tag
 \livetarg{chap:DWTAGunspecifiedparameters}{DW\-\_TAG\-\_unspecified\-\_parameters}.
 
 The entry for a subroutine that includes a 
@@ -1170,7 +1178,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.}
 
@@ -1216,7 +1225,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,
@@ -1526,8 +1538,9 @@ executable statements within which the fields of a record
 variable may be referenced, unqualified by the name of the
 record variable.}
 
-A with statement is represented by a debugging information
-entry with the tag \livetarg{chap:DWTAGwithstmt}{DW\-\_TAG\-\_with\-\_stmt}.
+A with statement is represented by a
+\addtoindexi{debugging information entry}{with statement entry}
+with the tag \livetarg{chap:DWTAGwithstmt}{DW\-\_TAG\-\_with\-\_stmt}.
 
 A with statement entry may have either a \livelink{chap:DWATlowpc}{DW\-\_AT\-\_low\-\_pc} and
 \livelink{chap:DWAThighpc}{DW\-\_AT\-\_high\-\_pc} pair of attributes or a \livelink{chap:DWATranges}{DW\-\_AT\-\_ranges} attribute
@@ -1580,7 +1593,8 @@ that catch \livelink{chap:catchblock}{block}.
 This child entry has one of the 
 \addtoindexx{unspecified parameters entry!in catch block}
 tags
-\livelink{chap:DWTAGformalparameter}{DW\-\_TAG\-\_formal\-\_parameter} or \livelink{chap:DWTAGunspecifiedparameters}{DW\-\_TAG\-\_unspecified\-\_parameters},
+\livelink{chap:DWTAGformalparameter}{DW\-\_TAG\-\_formal\-\_parameter} or
+\livelink{chap:DWTAGunspecifiedparameters}{DW\-\_TAG\-\_unspecified\-\_parameters},
 and will have the same form as other parameter entries.
 
 The siblings immediately following