Indexing letter 's'.
[dwarf-doc.git] / dwarf5 / latexdoc / programscope.tex
index 5407d19..7c39e76 100644 (file)
@@ -159,9 +159,14 @@ Language name & Meaning\\ \hline
 \end{tabular}
 \end{figure}
 
-\item A \livelink{chap:DWATstmtlist}{DW\-\_AT\-\_stmt\-\_list} attribute whose value is a section
+\item A \livelink{chap:DWATstmtlist}{DW\-\_AT\-\_stmt\-\_list} attribute whose value is 
+\addtoindexx{statement list attribute}
+a 
+\addtoindexx{section offset!in statement list attribute}
+section
 \hypertarget{chap:DWATstmtlistlinenumberinformationforunit}
-offset to the line number information for this compilation
+offset 
+to the line number information for this compilation
 unit.  This information is placed in a separate object file
 section from the debugging information entries themselves. The
 value of the statement list attribute is the offset in the
@@ -171,7 +176,9 @@ information for this compilation unit
 
 \item A \livelink{chap:DWATmacroinfo}{DW\-\_AT\-\_macro\-\_info} attribute 
 \addtoindex{macro information attribute}
-whose value is a section
+whose value is a 
+\addtoindexx{section offset!in macro information attribute}
+section
 \hypertarget{chap:DWATmacroinfomacroinformation}
 offset to the macro information for this compilation unit.
 This information is placed in a separate object file section
@@ -501,10 +508,14 @@ If a type, variable, or function declared in a namespace is
 defined outside of the body of the namespace declaration,
 that type, variable, or function definition entry has a
 \livelink{chap:DWATspecification}{DW\-\_AT\-\_specification} attribute 
+\addtoindexx{specification attribute}
 whose value is a reference to the
 debugging information entry representing the declaration of
 the type, variable or function. Type, variable, or function
-entries with a \livelink{chap:DWATspecification}{DW\-\_AT\-\_specification} attribute do not need
+entries with a 
+\livelink{chap:DWATspecification}{DW\-\_AT\-\_specification} attribute 
+\addtoindexx{specification attribute}
+do not need
 to duplicate information provided by the declaration entry
 referenced by the specification attribute.
 
@@ -734,7 +745,9 @@ debugging information entries
 \addtoindexx{function entry|see{subroutine entry}}
 for 
 \addtoindexx{subroutine entry}
-subroutines and entry
+subroutines 
+\addtoindexx{subprogram entry}
+and entry
 % FIXME: is entry point entry the right index 'entry'?
 \addtoindexx{entry point entry}
 points:
@@ -754,6 +767,7 @@ It may also have a \livelink{chap:DWATlinkagename}{DW\-\_AT\-\_linkage\-\_name}
 described in Section \refersec{chap:linkagenames}.
 
 If the name of the subroutine described by an entry with the
+\addtoindex{subprogram entry}
 tag \livelink{chap:DWTAGsubprogram}{DW\-\_TAG\-\_subprogram}
 is visible outside of its containing
 \hypertarget{chap:DWATexternalexternalsubroutine}
@@ -1133,7 +1147,9 @@ values of different types. DWARF does not represent the generic
 template definition, but does represent each instantiation.}
 
 A template instantiation is represented by a debugging
-information entry with the tag \livelink{chap:DWTAGsubprogram}{DW\-\_TAG\-\_subprogram}. With four
+information entry with the 
+\addtoindexx{subprogram entry!use for template instantiation}
+tag \livelink{chap:DWTAGsubprogram}{DW\-\_TAG\-\_subprogram}. With four
 exceptions, such an entry will contain the same attributes and
 will have the same types of child entries as would an entry
 for a subroutine defined explicitly using the instantiation
@@ -1180,7 +1196,9 @@ A declaration or a definition of an inlinable subroutine
 is represented by a debugging information entry with the
 tag 
 \livelink{chap:DWTAGsubprogram}{DW\-\_TAG\-\_subprogram}.
-The entry for a subroutine that is
+The entry for a 
+\addtoindexx{subprogram entry!use in inlined subprogram}
+subroutine that is
 \hypertarget{chap:DWATinlineinlinedsubroutine}
 explicitly declared to be available for inline expansion or
 that was expanded inline implicitly by the compiler has 
@@ -1243,8 +1261,11 @@ instance tree.
 
 Each abstract instance root is either part of a larger
 \addtoindexx{abstract instance!root}
-tree (which gives a context for the root) or uses
-\livelink{chap:DWATspecification}{DW\-\_AT\-\_specification} to refer to the declaration in context.
+tree (which gives a context for the root) or 
+\addtoindexx{specification attribute}
+uses
+\livelink{chap:DWATspecification}{DW\-\_AT\-\_specification} 
+to refer to the declaration in context.
 
 \textit{For example, in \addtoindex{C++} the context might be a namespace
 declaration or a class declaration.}
@@ -1275,6 +1296,7 @@ should
 be 
 \addtoindexx{low PC attribute!and abstract instance}
 omitted; 
+\addtoindex{segment attribute!and abstract instance}
 however, 
 \addtoindexx{return address attribute!and abstract instance}
 this