Indexing m and n complete.
[dwarf-doc.git] / dwarf5 / latexdoc / programscope.tex
index 8339ea2..37d24db 100644 (file)
@@ -21,8 +21,8 @@ compilation unit using an
 \subsection[Normal and Partial CU Entries]{Normal and Partial Compilation Unit Entries}
 \label{chap:normalandpartialcompilationunitentries}
 
 \subsection[Normal and Partial CU Entries]{Normal and Partial Compilation Unit Entries}
 \label{chap:normalandpartialcompilationunitentries}
 
-A normal compilation unit is represented by a debugging
-information entry with the 
+A \addtoindex{normal compilation unit} is represented by a 
+debugging information entry with the 
 tag \livetarg{chap:DWTAGcompileunit}{DW\-\_TAG\-\_compile\-\_unit}. A partial
 compilation unit is represented by a debugging information
 entry with the 
 tag \livetarg{chap:DWTAGcompileunit}{DW\-\_TAG\-\_compile\-\_unit}. A partial
 compilation unit is represented by a debugging information
 entry with the 
@@ -101,7 +101,9 @@ location lists (see Section
 \refersec{chap:locationlists}) and range lists 
 (see Section \refersec{chap:noncontiguousaddressranges}).
 
 \refersec{chap:locationlists}) and range lists 
 (see Section \refersec{chap:noncontiguousaddressranges}).
 
-\item A \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute whose value is a null\dash terminated
+\item A \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute 
+\addtoindexx{name attribute}
+whose value is a null\dash terminated
 string 
 \hypertarget{chap:DWATnamepathnameofcompilationsource}
 containing the full or relative path name of the primary
 string 
 \hypertarget{chap:DWATnamepathnameofcompilationsource}
 containing the full or relative path name of the primary
@@ -124,26 +126,26 @@ Figure \refersec{fig:languagenames}.
 \label{fig:languagenames}
 \begin{tabular}{ll}
 Language name & Meaning\\ \hline
 \label{fig:languagenames}
 \begin{tabular}{ll}
 Language name & Meaning\\ \hline
-\livetarg{chap:DWLANGAda83}{DW\-\_LANG\-\_Ada83} \dag&ISO Ada:1983 \addtoindexx{Ada} \\
+\livetarg{chap:DWLANGAda83}{DW\-\_LANG\-\_Ada83} \dag&ISO \addtoindex{Ada}:1983 \addtoindexx{Ada} \\
 \livetarg{chap:DWLANGAda95}{DW\-\_LANG\-\_Ada95} \dag&ISO Ada:1995 \addtoindexx{Ada} \\
 \livetarg{chap:DWLANGC}{DW\-\_LANG\-\_C}&Non-standardized C, such as K\&R \\
 \livetarg{chap:DWLANGC89}{DW\-\_LANG\-\_C89}&ISO C:1989 \\
 \livetarg{chap:DWLANGAda95}{DW\-\_LANG\-\_Ada95} \dag&ISO Ada:1995 \addtoindexx{Ada} \\
 \livetarg{chap:DWLANGC}{DW\-\_LANG\-\_C}&Non-standardized C, such as K\&R \\
 \livetarg{chap:DWLANGC89}{DW\-\_LANG\-\_C89}&ISO C:1989 \\
-\livetarg{chap:DWLANGC99}{DW\-\_LANG\-\_C99} & ISO C:1999 \\
-\livetarg{chap:DWLANGCplusplus}{DW\-\_LANG\-\_C\-\_plus\-\_plus}&ISO C++:1998 \\
-\livetarg{chap:DWLANGCobol74}{DW\-\_LANG\-\_Cobol74}& ISO Cobol:1974 \\
-\livetarg{chap:DWLANGCobol85}{DW\-\_LANG\-\_Cobol85} & ISO Cobol:1985 \\
-\livetarg{chap:DWLANGD}{DW\-\_LANG\-\_D} \dag & D \\
-\livetarg{chap:DWLANGFortran77}{DW\-\_LANG\-\_Fortran77} &ISO FORTRAN 77\\
-\livetarg{chap:DWLANGFortran90}{DW\-\_LANG\-\_Fortran90} & ISO Fortran 90\\
-\livetarg{chap:DWLANGFortran95}{DW\-\_LANG\-\_Fortran95} & ISO Fortran 95\\
-\livetarg{chap:DWLANGJava}{DW\-\_LANG\-\_Java} & Java\\
-\livetarg{chap:DWLANGModula2}{DW\-\_LANG\-\_Modula2} & ISO Modula\dash 2:1996\\
-\livetarg{chap:DWLANGObjC}{DW\-\_LANG\-\_ObjC} & Objective C\\
-\livetarg{chap:DWLANGObjCplusplus}{DW\-\_LANG\-\_ObjC\-\_plus\-\_plus} & Objective C++\\
-\livetarg{chap:DWLANGPascal83}{DW\-\_LANG\-\_Pascal83} & ISO Pascal:1983\\
-\livetarg{chap:DWLANGPLI}{DW\-\_LANG\-\_PLI} \dag & ANSI PL/I:1976\\
-\livetarg{chap:DWLANGPython}{DW\-\_LANG\-\_Python} \dag & Python\\
-\livetarg{chap:DWLANGUPC}{DW\-\_LANG\-\_UPC} &Unified Parallel C\\ \hline
+\livetarg{chap:DWLANGC99}{DW\-\_LANG\-\_C99} & ISO \addtoindex{C}:1999 \\
+\livetarg{chap:DWLANGCplusplus}{DW\-\_LANG\-\_C\-\_plus\-\_plus}&ISO \addtoindex{C++}:1998 \\
+\livetarg{chap:DWLANGCobol74}{DW\-\_LANG\-\_Cobol74}& ISO \addtoindex{Cobol}:1974 \\
+\livetarg{chap:DWLANGCobol85}{DW\-\_LANG\-\_Cobol85} & ISO \addtoindex{Cobol}:1985 \\
+\livetarg{chap:DWLANGD}{DW\-\_LANG\-\_D} \dag & D \addtoindexx{D language} \\
+\livetarg{chap:DWLANGFortran77}{DW\-\_LANG\-\_Fortran77} &ISO \addtoindex{FORTRAN} 77\\
+\livetarg{chap:DWLANGFortran90}{DW\-\_LANG\-\_Fortran90} & ISO \addtoindex{Fortran 90}\\
+\livetarg{chap:DWLANGFortran95}{DW\-\_LANG\-\_Fortran95} & ISO \addtoindex{Fortran 95}\\
+\livetarg{chap:DWLANGJava}{DW\-\_LANG\-\_Java} & \addtoindex{Java}\\
+\livetarg{chap:DWLANGModula2}{DW\-\_LANG\-\_Modula2} & ISO Modula\dash 2:1996 \addtoindexx{Modula-2}\\
+\livetarg{chap:DWLANGObjC}{DW\-\_LANG\-\_ObjC} & \addtoindex{Objective C}\\
+\livetarg{chap:DWLANGObjCplusplus}{DW\-\_LANG\-\_ObjC\-\_plus\-\_plus} & \addtoindex{Objective C++}\\
+\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
 \dag \ \ Support for these languages is limited.& \\
 \end{tabular}
 \end{figure}
 \dag \ \ Support for these languages is limited.& \\
 \end{tabular}
 \end{figure}
@@ -158,7 +160,9 @@ value of the statement list attribute is the offset in the
 information for this compilation unit 
 (see Section \refersec{chap:linenumberinformation}).
 
 information for this compilation unit 
 (see Section \refersec{chap:linenumberinformation}).
 
-\item A \livelink{chap:DWATmacroinfo}{DW\-\_AT\-\_macro\-\_info} attribute whose value is a section
+\item A \livelink{chap:DWATmacroinfo}{DW\-\_AT\-\_macro\-\_info} attribute 
+\addtoindex{macro information attribute}
+whose value is a section
 \hypertarget{chap:DWATmacroinfomacroinformation}
 offset to the macro information for this compilation unit.
 This information is placed in a separate object file section
 \hypertarget{chap:DWATmacroinfomacroinformation}
 offset to the macro information for this compilation unit.
 This information is placed in a separate object file section
@@ -210,7 +214,9 @@ is given in Figure
 
 \livetarg{chap:DWIDcasesensitive}{DW\-\_ID\-\_case\-\_sensitive} is the default for all compilation units
 that do not have this attribute.  It indicates that names given
 
 \livetarg{chap:DWIDcasesensitive}{DW\-\_ID\-\_case\-\_sensitive} is the default for all compilation units
 that do not have this attribute.  It indicates that names given
-as the values of \livelink{chap:DWATname}{DW\-\_AT\-\_name} attributes in debugging information
+as the values of \livelink{chap:DWATname}{DW\-\_AT\-\_name} attributes 
+\addtoindexx{name attribute}
+in debugging information
 entries for the compilation unit reflect the names as they
 appear in the source program. The debugger should be sensitive
 to the case of identifier names when doing identifier lookups.
 entries for the compilation unit reflect the names as they
 appear in the source program. The debugger should be sensitive
 to the case of identifier names when doing identifier lookups.
@@ -264,6 +270,7 @@ using the UTF\dash 8 representation
 
 
 \item A \livelink{chap:DWATmainsubprogram}{DW\-\_AT\-\_main\-\_subprogram} attribute, which is a \livelink{chap:flag}{flag}
 
 
 \item A \livelink{chap:DWATmainsubprogram}{DW\-\_AT\-\_main\-\_subprogram} attribute, which is a \livelink{chap:flag}{flag}
+\addtoindexx{main subprogram attribute}
 whose presence indicates 
 \hypertarget{chap:DWATmainsubprogramunitcontainingmainorstartingsubprogram}
 that the compilation unit contains a
 whose presence indicates 
 \hypertarget{chap:DWATmainsubprogramunitcontainingmainorstartingsubprogram}
 that the compilation unit contains a
@@ -373,7 +380,9 @@ those entities.}
 \label{chap:moduleentries}
 \textit{Several languages have the concept of a ``module.''
 \addtoindexx{Modula-2}
 \label{chap:moduleentries}
 \textit{Several languages have the concept of a ``module.''
 \addtoindexx{Modula-2}
-A Modula\dash 2 definition module may be represented by a module
+A Modula\dash 2 definition module 
+\addtoindexx{Modula-2!definition module}
+may be represented by a module
 entry containing a 
 \addtoindex{declaration attribute}
 (\livelink{chap:DWATdeclaration}{DW\-\_AT\-\_declaration}). A
 entry containing a 
 \addtoindex{declaration attribute}
 (\livelink{chap:DWATdeclaration}{DW\-\_AT\-\_declaration}). A
@@ -390,11 +399,14 @@ Module entries may own other
 debugging information entries describing program entities
 whose declaration scopes end at the end of the module itself.
 
 debugging information entries describing program entities
 whose declaration scopes end at the end of the module itself.
 
-If the module has a name, the module entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name}
-attribute whose value is a null\dash terminated string containing
+If the module has a name, the module entry has a 
+\livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute 
+\addtoindexx{name attribute}
+whose value is a null\dash terminated string containing
 the module name as it appears in the source program.
 
 the module name as it appears in the source program.
 
-The module entry may have either a \livelink{chap:DWATlowpc}{DW\-\_AT\-\_low\-\_pc} and
+The \addtoindex{module entry} may have either a 
+\livelink{chap:DWATlowpc}{DW\-\_AT\-\_low\-\_pc} and
 \livelink{chap:DWAThighpc}{DW\-\_AT\-\_high\-\_pc} 
 pair 
 \addtoindexx{high PC attribute}
 \livelink{chap:DWAThighpc}{DW\-\_AT\-\_high\-\_pc} 
 pair 
 \addtoindexx{high PC attribute}
@@ -427,6 +439,7 @@ represented as it would be on the target architecture.
 \subsection{Namespace Entries}
 \label{chap:namespaceentries}
 \textit{\addtoindex{C++} has the notion of a namespace, which provides a way to
 \subsection{Namespace Entries}
 \label{chap:namespaceentries}
 \textit{\addtoindex{C++} has the notion of a namespace, which provides a way to
+\addtoindexx{namespace (C++)}
 implement name hiding, so that names of unrelated things
 do not accidentally clash in the 
 \addtoindex{global namespace} when an
 implement name hiding, so that names of unrelated things
 do not accidentally clash in the 
 \addtoindex{global namespace} when an
@@ -450,11 +463,15 @@ entry. A namespace extension entry does not need to duplicate
 information in a previous extension entry of the namespace
 nor need it duplicate information in the original namespace
 entry. (Thus, for a namespace with a name, 
 information in a previous extension entry of the namespace
 nor need it duplicate information in the original namespace
 entry. (Thus, for a namespace with a name, 
-a \livelink{chap:DWATname}{DW\-\_AT\-\_name}
-attribute need only be attached directly to the original
+a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute 
+\addtoindexx{name attribute}
+need only be attached directly to the original
 \livelink{chap:DWTAGnamespace}{DW\-\_TAG\-\_namespace} entry.)
 
 \livelink{chap:DWTAGnamespace}{DW\-\_TAG\-\_namespace} entry.)
 
-Namespace and namespace extension entries may own other
+Namespace and namespace extension entries may own 
+\addtoindexx{namespace extension entry}
+other
+\addtoindexx{namespace declaration entry}
 debugging information entries describing program entities
 whose declarations occur in the namespace.
 
 debugging information entries describing program entities
 whose declarations occur in the namespace.
 
@@ -477,7 +494,9 @@ referenced by the specification attribute.
 \textit{The \addtoindex{C++} \addtoindex{global namespace}
 (the 
 \addtoindexx{global namespace|see{namespace (C++), global}}
 \textit{The \addtoindex{C++} \addtoindex{global namespace}
 (the 
 \addtoindexx{global namespace|see{namespace (C++), global}}
-namespace referred to by
+namespace 
+\addtoindexx{namespace (C++)!global}
+referred to by
 ``::f'', for example) is not explicitly represented in
 DWARF with a namespace entry (thus mirroring the situation
 in \addtoindex{C++} source).  
 ``::f'', for example) is not explicitly represented in
 DWARF with a namespace entry (thus mirroring the situation
 in \addtoindex{C++} source).  
@@ -486,6 +505,7 @@ reference to a namespace.}
 
 \textit{The \addtoindex{C++} 
 compilation unit specific ``unnamed namespace'' may
 
 \textit{The \addtoindex{C++} 
 compilation unit specific ``unnamed namespace'' may
+\addtoindexx{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).
@@ -496,6 +516,7 @@ explicitly represent namespace extensions, or to represent the
 final namespace declaration of a compilation unit; this is a
 quality\dash of\dash implementation issue and no specific requirements
 are given here. If only the final namespace is represented,
 final namespace declaration of a compilation unit; this is a
 quality\dash of\dash implementation issue and no specific requirements
 are given here. If only the final namespace is represented,
+\addtoindexx{namespace (C++)!using declaration}
 it is impossible for a debugger to interpret using declaration
 references in exactly the manner defined by the 
 \addtoindex{C++} language.
 it is impossible for a debugger to interpret using declaration
 references in exactly the manner defined by the 
 \addtoindex{C++} language.
@@ -506,7 +527,9 @@ compilation units can result in a significant increase in the
 size of the debug information and significant duplication of
 information across compilation units. 
 The \addtoindex{C++} namespace std,
 size of the debug information and significant duplication of
 information across compilation units. 
 The \addtoindex{C++} namespace std,
-for example, is large and will probably be referenced in
+for example, 
+\addtoindexx{namespace (C++)!std}
+is large and will probably be referenced in
 every \addtoindex{C++} compilation unit.
 }
 
 every \addtoindex{C++} compilation unit.
 }
 
@@ -544,6 +567,7 @@ is being imported.
 An imported declaration may also have a 
 \livelink{chap:DWATname}{DW\-\_AT\-\_name}
 attribute
 An imported declaration may also have a 
 \livelink{chap:DWATname}{DW\-\_AT\-\_name}
 attribute
+\addtoindexx{name attribute}
 whose value is a null\dash terminated string containing the
 name, as it appears in the source program, by which the
 imported entity is to be known in the context of the imported
 whose value is a null\dash terminated string containing the
 name, as it appears in the source program, by which the
 imported entity is to be known in the context of the imported
@@ -560,7 +584,9 @@ declaration or the imported entity occurs.
 
 \textit{A \addtoindex{C++} namespace alias may be represented by an imported
 \hypertarget{chap:DWATimportnamespacealias}
 
 \textit{A \addtoindex{C++} namespace alias may be represented by an imported
 \hypertarget{chap:DWATimportnamespacealias}
-declaration entry with a name attribute whose value is
+declaration entry 
+\addtoindexx{namespace (C++)!alias}
+with a name attribute whose value is
 a null\dash terminated string containing the alias name as it
 appears in the source program and an import attribute whose
 value is a reference to the applicable original namespace or
 a null\dash terminated string containing the alias name as it
 appears in the source program and an import attribute whose
 value is a reference to the applicable original namespace or
@@ -569,7 +595,9 @@ namespace extension entry.
 
 \textit{A \addtoindex{C++} using declaration may be represented by one or more
 \hypertarget{chap:DWATimportnamespaceusingdeclaration}
 
 \textit{A \addtoindex{C++} using declaration may be represented by one or more
 \hypertarget{chap:DWATimportnamespaceusingdeclaration}
-imported declaration entries.  When the using declaration
+imported 
+\addtoindexx{namespace (C++)!using declaration}
+declaration entries.  When the using declaration
 refers to an overloaded function, there is one imported
 declaration entry corresponding to each overloading. Each
 imported declaration entry has no name attribute but it does
 refers to an overloaded function, there is one imported
 declaration entry corresponding to each overloading. Each
 imported declaration entry has no name attribute but it does
@@ -621,7 +649,9 @@ 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 
 module entry by the same name as it is declared in the module.
 
 \textit{A \addtoindex{C++} using directive 
-may be represented by an imported module
+may be represented by an 
+\addtoindexx{namespace (C++)!using directive}
+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
@@ -722,8 +752,12 @@ Section \refersec{chap:memberfunctionentries}.
 
 A 
 \hypertarget{chap:DWATmainsubprogrammainorstartingsubprogram}
 
 A 
 \hypertarget{chap:DWATmainsubprogrammainorstartingsubprogram}
-subroutine entry may contain a \livelink{chap:DWATmainsubprogram}{DW\-\_AT\-\_main\-\_subprogram}
-attribute which is 
+subroutine entry 
+may contain a 
+\livelink{chap:DWATmainsubprogram}{DW\-\_AT\-\_main\-\_subprogram}
+attribute 
+\addtoindexx{main subprogram attribute}
+which is 
 a \livelink{chap:flag}{flag} whose presence indicates that the
 subroutine has been identified as the starting function of
 the program.  If more than one subprogram contains this 
 a \livelink{chap:flag}{flag} whose presence indicates that the
 subroutine has been identified as the starting function of
 the program.  If more than one subprogram contains this 
@@ -1084,7 +1118,9 @@ template definition is represented by a debugging information
 entry with the 
 tag \livetarg{chap:DWTAGtemplatetypeparameter}{DW\-\_TAG\-\_template\-\_type\-\_parameter}. 
 Each
 entry with the 
 tag \livetarg{chap:DWTAGtemplatetypeparameter}{DW\-\_TAG\-\_template\-\_type\-\_parameter}. 
 Each
-such entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, whose value is a
+such entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, 
+\addtoindexx{name attribute}
+whose value is a
 null\dash terminated string containing the name of the formal
 type parameter as it appears in the source program. The
 \addtoindexx{formal type parameter|see{template type parameter entry}}
 null\dash terminated string containing the name of the formal
 type parameter as it appears in the source program. The
 \addtoindexx{formal type parameter|see{template type parameter entry}}
@@ -1173,7 +1209,8 @@ instance root, together with the root itself, is known as
 \addtoindexx{abstract instance!tree}
 an ``abstract instance tree.'' However, in the case where
 an abstract instance tree is nested within another abstract
 \addtoindexx{abstract instance!tree}
 an ``abstract instance tree.'' However, in the case where
 an abstract instance tree is nested within another abstract
-instance tree, the entries in the nested abstract instance
+instance tree, the entries in the 
+\addtoindex{nested abstract instance}
 tree are not considered to be entries in the outer abstract
 instance tree.
 
 tree are not considered to be entries in the outer abstract
 instance tree.
 
@@ -1330,7 +1367,8 @@ of some concrete inlined instance root, together with the root
 itself, is known as a ``concrete inlined instance tree.''
 However, in the case where a concrete inlined instance tree
 is nested within another concrete instance tree, the entries
 itself, is known as a ``concrete inlined instance tree.''
 However, in the case where a concrete inlined instance tree
 is nested within another concrete instance tree, the entries
-in the nested concrete instance tree are not considered to
+in the \addtoindex{nested concrete inline instance} tree 
+are not considered to
 be entries in the outer concrete instance tree.
 
 \textit{Concrete inlined instance trees are defined so that no entry
 be entries in the outer concrete instance tree.
 
 \textit{Concrete inlined instance trees are defined so that no entry
@@ -1403,7 +1441,9 @@ the reference should refer to the abstract instance entry.
 
 \item Entries in the concrete instance tree which are associated
 with entries in the abstract instance tree such that neither
 
 \item Entries in the concrete instance tree which are associated
 with entries in the abstract instance tree such that neither
-has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, and neither is referenced by
+has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute,
+\addtoindexx{name attribute}
+and neither is referenced by
 any other debugging information entry, may be omitted. This
 may happen for debugging information entries in the abstract
 instance trees that became unnecessary in the concrete instance
 any other debugging information entry, may be omitted. This
 may happen for debugging information entries in the abstract
 instance trees that became unnecessary in the concrete instance
@@ -1558,7 +1598,8 @@ subprogram.
 the relocated address of the target subprogram.
 
 \item If the value is of class string, then the value is the
 the relocated address of the target subprogram.
 
 \item If the value is of class string, then the value is the
-(possibly mangled) name of the target subprogram.
+(possibly mangled) \addtoindexx{mangled names}
+name of the target subprogram.
 
 \item If the value is of class \livelink{chap:flag}{flag}, then the value true
 indicates that the containing subroutine is a trampoline but
 
 \item If the value is of class \livelink{chap:flag}{flag}, then the value true
 indicates that the containing subroutine is a trampoline but
@@ -1636,6 +1677,7 @@ in the source
 program, then the corresponding 
 lexical \livelink{chap:lexicalblockentry}{block} entry has a
 \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute whose 
 program, then the corresponding 
 lexical \livelink{chap:lexicalblockentry}{block} entry has a
 \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute whose 
+\addtoindexx{name attribute}
 value is a null\dash terminated string
 containing the name of the lexical \livelink{chap:lexicalblock}{block} 
 as it appears in
 value is a null\dash terminated string
 containing the name of the lexical \livelink{chap:lexicalblock}{block} 
 as it appears in
@@ -1670,8 +1712,10 @@ the source program.
 The label entry has a \livelink{chap:DWATlowpc}{DW\-\_AT\-\_low\-\_pc} attribute whose value
 is the relocated address of the first machine instruction
 generated for the statement identified by the label in
 The label entry has a \livelink{chap:DWATlowpc}{DW\-\_AT\-\_low\-\_pc} attribute whose value
 is the relocated address of the first machine instruction
 generated for the statement identified by the label in
-the source program.  The label entry also has a \livelink{chap:DWATname}{DW\-\_AT\-\_name}
-attribute whose value is a null-terminated string containing
+the source program.  The label entry also has a 
+\livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute 
+\addtoindexx{name attribute}
+whose value is a null-terminated string containing
 the name of the label as it appears in the source program.
 
 
 the name of the label as it appears in the source program.