DW_AT_t* through DW_AT_v* attributes table entries done.
[dwarf-doc.git] / dwarf5 / latexdoc / generaldescription.tex
index 20fc6e1..f84c3f7 100644 (file)
@@ -255,34 +255,34 @@ actually declared in the source} \\
 &\livelink{chap:DWATexternalexternalsubroutine}{External subroutine} \\
 &\livelink{chap:DWATexternalexternalvariable}{External variable} \\
 \livetarg{chap:DWATframebase}{DW\-\_AT\-\_frame\-\_base}
-&Subroutine frame base address\\
+&\livelink{chap:DWATframebasesubroutineframebaseaddress}{Subroutine frame base address} \\
 \livetarg{chap:DWATfriend}{DW\-\_AT\-\_friend}
-&Friend relationship\\
+&\livelink{chap:DWATfriendfriendrelationship}{Friend relationship} \\
 \livetarg{chap:DWAThighpc}{DW\-\_AT\-\_high\-\_pc}
-&Contiguous range of code addresses\\
+&\livelink{chap:DWAThighpccontinguousrangeofcodeaddresses}{Contiguous range of code addresses} \\
 \livetarg{chap:DWATidentifiercase}{DW\-\_AT\-\_identifier\-\_case}
-&Identifier case rule \\
+&\livelink{chap:DWATidentifiercaseidentifiercaserule}{Identifier case rule} \\
 \livetarg{chap:DWATimport}{DW\-\_AT\-\_import}
-&Imported declaration \\
-&Imported unit \\
-&Namespace alias \\
-&Namespace using declaration \\
-&Namespace using directive \\
+&\livelink{chap:DWATimportimporteddeclaration}{Imported declaration} \\
+&\livelink{chap:DWATimportimportedunit}{Imported unit} \\
+&\livelink{chap:DWATimportnamespacealias}{Namespace alias} \\
+&\livelink{chap:DWATimportnamespaceusingdeclaration}{Namespace using declaration} \\
+&\livelink{chap:DWATimportnamespaceusingdirective}{Namespace using directive} \\
 \livetarg{chap:DWATinline}{DW\-\_AT\-\_inline}
-&Abstract instance\\
-&Inlined subroutine\\
+&\livelink{chap:DWATinlineabstracttinstance}{Abstract instance} \\
+&\livelink{chap:DWATinlineinlinedsubroutine}{Inlined subroutine} \\
 \livetarg{chap:DWATisoptional}{DW\-\_AT\-\_is\-\_optional}
-&Optional parameter\\
+&\livelink{chap:DWATisoptionaloptionalparameter}{Optional parameter} \\
 \livetarg{chap:DWATlanguage}{DW\-\_AT\-\_language}
-&Programming language\\
+&\livelink{chap:DWATlanguageprogramminglanguage}{Programming language} \\
 \livetarg{chap:DWATlinkagename}{DW\-\_AT\-\_linkage\-\_name}
-&Object file linkage name of an entity\\
+&\livelink{chap:DWATlinkagenameobjectfilelinkagenameofanentity}{Object file linkage name of an entity}\\
 \livetarg{chap:DWATlocation}{DW\-\_AT\-\_location}
-&Data object location\\
+&\livelink{chap:DWATlocationdataobjectlocation}{Data object location}\\
 \livetarg{chap:DWATlowpc}{DW\-\_AT\-\_low\-\_pc}
-&Code address or range of addresses\\
+&\livelink{chap:DWATlowpccodeaddressorrangeofaddresses}{Code address or range of addresses}\\
 \livetarg{chap:DWATlowerbound}{DW\-\_AT\-\_lower\-\_bound}
-&Lower bound of subrange\\
+&\livelink{chap:DWATlowerboundlowerboundofsubrange}{Lower bound of subrange} \\
 \livetarg{chap:DWATmacroinfo}{DW\-\_AT\-\_macro\-\_info}
 &\livelink{chap:DWATmacroinfomacroinformation}{Macro information} (\#define, \#undef)\\
 \livetarg{chap:DWATmainsubprogram}{DW\-\_AT\-\_main\-\_subprogram}
@@ -335,28 +335,28 @@ actually declared in the source} \\
 \livetarg{chap:DWATstringlength}{DW\-\_AT\-\_string\-\_length}
 &\livelink{chap:DWATstringlengthstringlengthofstringtype}{String length of string type} \\
 \livetarg{chap:DWATthreadsscaled}{DW\-\_AT\-\_threads\-\_scaled}
-&UPC array bound THREADS scale factor\\
+&\livelink{chap:DWATthreadsscaledupcarrayboundthreadsscalfactor}{UPC array bound THREADS scale factor}\\
 \livetarg{chap:DWATtrampoline}{DW\-\_AT\-\_trampoline}
-&Target subroutine\\
+&\livelink{chap:DWATtrampolinetargetsubroutine}{Target subroutine} \\
 \livetarg{chap:DWATtype}{DW\-\_AT\-\_type}
-&Type of declaration\\
-&Type of subroutine return\\
+&\livelink{chap:DWATtypetypeofdeclaration}{Type of declaration} \\
+&\livelink{chap:DWATtypetypeofsubroutinereturn}{Type of subroutine return} \\
 \livetarg{chap:DWATupperbound}{DW\-\_AT\-\_upper\-\_bound}
-&Upper bound of subrange\\
+&\livelink{chap:DWATupperboundupperboundofsubrange}{Upper bound of subrange} \\
 \livetarg{chap:DWATuselocation}{DW\-\_AT\-\_use\-\_location}
-&Member location for pointer to member type\\
+&\livelink{chap:DWATuselocationmemberlocationforpointertomembertype}{Member location for pointer to member type} \\
 \livetarg{chap:DWATuseUTF8}{DW\-\_AT\-\_use\-\_UTF8}
-&Compilation unit uses UTF\dash 8 strings \\
+&\livelink{chap:DWATuseUTF8compilationunitusesutf8strings}{Compilation unit uses UTF-8 strings} \\
 \livetarg{chap:DWATvariableparameter}{DW\-\_AT\-\_variable\-\_parameter}
-&Non\dash constant parameter \livelink{chap:flag}{flag} \\
+&\livelink{chap:DWATvariableparameternonconstantparameterflag}{Non-constant parameter flag}  \\
 \livetarg{chap:DWATvirtuality}{DW\-\_AT\-\_virtuality}
-&Virtuality indication \\
-&Virtuality of base class \\
-&Virtuality of function \\
+&\livelink{chap:DWATvirtualityvirtualityindication}{Virtuality indication} \\
+&\livelink{chap:DWATvirtualityvirtualityofbaseclass}{Virtuality of base class} \\
+&\livelink{chap:DWATvirtualityvirtualityoffunction}{Virtuality of function} \\
 \livetarg{chap:DWATvisibility}{DW\-\_AT\-\_visibility}
-&Visibility of declaration\\
+&\livelink{chap:DWATvisibilityvisibilityofdeclaration}{Visibility of declaration} \\
 \livetarg{chap:DWATvtableelemlocation}{DW\-\_AT\-\_vtable\-\_elem\-\_location}
-&Virtual function vtable slot\\
+&\livelink{chap:DWATvtableelemlocationvirtualfunctiontablevtableslot}{Virtual function vtable slot}\\
 \end{longtable}
 
 \begin{figure}[here]
@@ -1363,7 +1363,9 @@ and representation.}
 
 \section{Types of Program Entities}
 \label{chap:typesofprogramentities}
-Any debugging information entry describing a declaration that
+Any 
+\hypertarget{chap:DWATtypetypeofdeclaration}
+debugging information entry describing a declaration that
 has a type has a \livelink{chap:DWATtype}{DW\-\_AT\-\_type} attribute, whose value is a
 reference to another debugging information entry. The entry
 referenced may describe a base type, that is, a type that is
@@ -1414,7 +1416,9 @@ visibility specifies which declarations are to be
 visible outside of the entity in which they are
 declared.}
 
-The visibility of a declaration is represented 
+The 
+\hypertarget{chap:DWATvisibilityvisibilityofdeclaration}
+visibility of a declaration is represented 
 by a \livelink{chap:DWATvisibility}{DW\-\_AT\-\_visibility} attribute, whose value is a
 constant drawn from the set of codes listed in 
 Figure \ref{fig:visibilitycodes}.
@@ -1435,7 +1439,9 @@ Figure \ref{fig:visibilitycodes}.
 \textit{C++ provides for virtual and pure virtual structure or class
 member functions and for virtual base classes.}
 
-The virtuality of a declaration is represented by a
+The 
+\hypertarget{chap:DWATvirtualityvirtualityindication}
+virtuality of a declaration is represented by a
 \livelink{chap:DWATvirtuality}{DW\-\_AT\-\_virtuality} attribute, whose value is a constant drawn
 from the set of codes listed in 
 Figure \ref{fig:virtualitycodes}.
@@ -1649,7 +1655,10 @@ multiple whitespace characters may be compressed.}
 
 \section{Data Locations and DWARF Procedures}
 Any debugging information entry describing a data object (which
-includes variables and parameters) or common \livelink{chap:commonblockentry}{block} may have a
+\hypertarget{chap:DWATlocationdataobjectlocation}
+includes variables and parameters) or 
+common \livelink{chap:commonblockentry}{block}
+may have a
 \livelink{chap:DWATlocation}{DW\-\_AT\-\_location} attribute, whose value is a location description
 (see Section 2.6).  
 
@@ -1676,7 +1685,10 @@ which includes compilation units, module initialization,
 \hypertarget{chap:DWATrangesnoncontiguousrangeofcodeaddresses}
 subroutines, ordinary \livelink{chap:lexicalblock}{block}, 
 try/catch \nolink{blocks} (see Section\refersec{chap:tryandcatchblockentries}), 
-labels and
+labels 
+\hypertarget{chap:DWATlowpccodeaddressorrangeofaddresses}
+and
+\hypertarget{chap:DWAThighpccontinguousrangeofcodeaddresses}
 the like, may have
 
 \begin{itemize}
@@ -1918,12 +1930,15 @@ associated distinct linkage name it may sometimes be useful
 for a producer to include this name in the DWARF description
 of the program to facilitate consumer access to and use of
 object file information about an entity and/or information
+\hypertarget{chap:DWATlinkagenameobjectfilelinkagenameofanentity}
 that is encoded in the linkage name itself.  
 }
 
 % Some trouble maybe with hbox full, so we try optional word breaks.
 A debugging
-information entry may have a \livelink{chap:DWATlinkagename}{DW\-\_AT\-\_linkage\-\_name} attribute
+information entry may have a 
+\livelink{chap:DWATlinkagename}{DW\-\_AT\-\_linkage\-\_name}
+attribute
 whose value is a null-terminated string describing the object
 file linkage name associated with the corresponding entity.