Indexing m and n complete.
[dwarf-doc.git] / dwarf5 / latexdoc / typeentries.tex
index 195334b..605caf0 100644 (file)
@@ -26,7 +26,10 @@ with the tag
 \livetarg{chap:DWTAGbasetype}{DW\-\_TAG\-\_base\-\_type}.
 
 A \addtoindex{base type entry}
-has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute whose value is
+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 base type
 as recognized by the programming language of the compilation
 unit containing the base type entry.
@@ -390,7 +393,9 @@ type is represented by a debugging information entry with
 the tag \livetarg{chap:DWTAGunspecifiedtype}{DW\-\_TAG\-\_unspecified\-\_type}. 
 If a name has been given
 to the type, then the corresponding unspecified type entry
-has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute whose value is
+has 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.
 
@@ -426,7 +431,9 @@ Figure \refersec{fig:typemodifiertags}.
 
 If a name has been given to the modified type in the source
 program, then the corresponding modified type entry has
-a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute whose value is a null-terminated
+a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute 
+\addtoindexx{name attribute}
+whose value is a null\dash terminated
 string containing the modified type name as it appears in
 the source program.
 
@@ -522,8 +529,9 @@ volatile unsigned char * const restrict p;
 A named type that is defined in terms of another type
 definition is represented by a debugging information entry with
 the tag \livetarg{chap:DWTAGtypedef}{DW\-\_TAG\-\_typedef}. 
-The typedef entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name}
-attribute whose value is a null-terminated string containing
+The typedef 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 typedef as it appears in the source program.
 
 The typedef entry may also contain a \livelink{chap:DWATtype}{DW\-\_AT\-\_type} attribute whose
@@ -557,8 +565,10 @@ If a name has been
 given to
 \addtoindexx{array!declaration of type}
 the array type in the source program, then the corresponding
-array type entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute whose value is a
-null-terminated string containing the array type name as it
+array type entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute 
+\addtoindexx{name attribute}
+whose value is a
+null\dash terminated string containing the array type name as it
 appears in the source program.
 
 The 
@@ -701,7 +711,9 @@ and \livetarg{chap:DWTAGclasstype}{DW\-\_TAG\-\_class\-\_type},
 respectively. If a name has been given to the structure,
 union, or class in the source program, then the corresponding
 structure type, union type, or class type entry has a
-\livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute whose value is a null\dash terminated string
+\livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute 
+\addtoindexx{name attribute}
+whose value is a null\dash terminated string
 containing the type name as it appears in the source program.
 
 The members of a structure, union, or class are represented
@@ -807,8 +819,11 @@ are represented by debugging information
 entries with the 
 tag \livetarg{chap:DWTAGinterfacetype}{DW\-\_TAG\-\_interface\-\_type}.
 
-An interface type entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, whose
-value is a null-terminated string containing the type name
+An interface type entry has 
+a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute,
+\addtoindexx{name attribute}
+whose
+value is a null\dash terminated string containing the type name
 as it appears in the source program.
 
 The members of an interface are represented by debugging
@@ -922,8 +937,11 @@ information entry with the tag
 Each
 such entry is a child of the class or structure type entry.
 
-An access declaration entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, whose
-value is a null-terminated string representing the name used
+An access declaration entry has 
+a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, 
+\addtoindexx{name attribute}
+whose
+value is a null\dash terminated string representing the name used
 in the declaration in the source program, including any class
 or structure qualifiers.
 
@@ -961,15 +979,21 @@ the declaration of the friend.
 A data member (as opposed to a member function) is
 represented by a debugging information entry with the 
 tag \livetarg{chap:DWTAGmember}{DW\-\_TAG\-\_member}. 
-The member entry for a named member has
-a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute whose value is a null-terminated
+The 
+\addtoindexx{member entry (data)}
+member entry for a named member has
+a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute 
+\addtoindexx{name attribute}
+whose value is a null\dash terminated
 string containing the member name as it appears in the source
 program. If the member entry describes an 
 \addtoindex{anonymous union},
 the
 name attribute is omitted or consists of a single zero byte.
 
-The data member entry has a \livelink{chap:DWATtype}{DW\-\_AT\-\_type} attribute to denote
+The data member entry has a 
+\livelink{chap:DWATtype}{DW\-\_AT\-\_type} attribute to denote
+\addtoindexx{member entry (data)}
 the type of that member.
 
 A data member entry may 
@@ -982,7 +1006,11 @@ is assumed for an entry of a structure, union, or interface.
 
 A data member 
 \hypertarget{chap:DWATmutablemutablepropertyofmemberdata}
-entry may have a \livelink{chap:DWATmutable}{DW\-\_AT\-\_mutable} attribute,
+entry 
+\addtoindexx{member entry (data)}
+may 
+\addtoindexx{mutable attribute}
+have a \livelink{chap:DWATmutable}{DW\-\_AT\-\_mutable} attribute,
 which is a \livelink{chap:flag}{flag}. 
 This attribute indicates whether the data
 member was declared with the mutable storage class specifier.
@@ -1002,7 +1030,9 @@ Bit offsets in DWARF use the bit numbering and direction
 conventions that are appropriate to the current language on
 the target system.
 
-The member entry corresponding to a data member that is
+The member entry 
+\addtoindexx{member entry (data)}
+corresponding to a data member that is
 \hypertarget{chap:DWATdatabitoffsetdatamemberbitlocation}
 defined 
 \hypertarget{chap:DWATdatamemberlocationdatamemberlocation}
@@ -1302,8 +1332,10 @@ as well as specify the size of the data member) }
 \subsection{Member Function Entries}
 \label{chap:memberfunctionentries}
 
-A member function is represented by a debugging information
-entry with the tag \livelink{chap:DWTAGsubprogram}{DW\-\_TAG\-\_subprogram}.
+A member function is represented by a 
+\addtoindexx{member function entry}
+debugging information entry with the 
+tag \livelink{chap:DWTAGsubprogram}{DW\-\_TAG\-\_subprogram}.
 The member function entry
 may contain the same attributes and follows the same rules
 as non\dash member global subroutine entries 
@@ -1408,7 +1440,9 @@ types and values. The exceptions are:
 template definition is represented by a debugging information
 entry with the tag 
 \livelink{chap:DWTAGtemplatetypeparameter}{DW\-\_TAG\-\_template\-\_type\-\_parameter}. Each
-such entry may have a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, whose value is
+such entry may have 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
 template type parameter entry also has a \livelink{chap:DWATtype}{DW\-\_AT\-\_type} attribute
@@ -1420,7 +1454,9 @@ template definition is represented by a debugging information
 entry with the 
 tag \livetarg{chap:DWTAGtemplatevalueparameter}{DW\-\_TAG\-\_template\-\_value\-\_parameter}. 
 Each
-such entry may have a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, whose value is
+such entry may have 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
 value parameter as it appears in the source program. 
 The
@@ -1469,7 +1505,9 @@ represented by a
 \addtoindexx{discriminant (entry)}
 separate debugging information entry which
 is a child of the variant part entry. This entry has the form
-of a structure data member entry. The variant part entry will
+of a 
+\addtoindexx{member entry (data)!as discriminant}
+structure data member entry. The variant part entry will
 \addtoindexx{discriminant attribute}
 have a 
 \livelink{chap:DWATdiscr}{DW\-\_AT\-\_discr} attribute 
@@ -1555,7 +1593,9 @@ describes a
 logical condition that tests whether a given data item’s
 value matches one of a set of constant values. If a name
 has been given to the condition, the condition entry has a
-\livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute whose value is a null\dash terminated string
+\livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute
+\addtoindexx{name attribute}
+whose value is a null\dash terminated string
 giving the condition name as it appears in the source program.
 
 The condition entry's parent entry describes the conditional
@@ -1601,7 +1641,9 @@ entry with the tag
 
 If a name has been given to the enumeration type in the source
 program, then the corresponding enumeration type entry has
-a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute whose value is a null\dash terminated
+a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute
+\addtoindexx{name attribute}
+whose value is a null\dash terminated
 string containing the enumeration type name as it appears
 in the source program. This entry also has a \livelink{chap:DWATbytesize}{DW\-\_AT\-\_byte\-\_size}
 attribute whose integer constant value is the number of bytes
@@ -1651,6 +1693,7 @@ of the enumeration literals in the source program.
 
 Each \addtoindex{enumerator 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
 \hypertarget{chap:DWATconstvalueenumerationliteralvalue}
 enumeration literal as it appears in the source program. 
@@ -1702,8 +1745,10 @@ entry with the
 tag \livetarg{chap:DWTAGsubroutinetype}{DW\-\_TAG\-\_subroutine\-\_type}. 
 If a name has
 been given to the subroutine type in the source program,
-then the corresponding subroutine type entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name}
-attribute whose value is a null\dash terminated string containing
+then the corresponding subroutine type entry has 
+a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute 
+\addtoindexx{name attribute}
+whose value is a null\dash terminated string containing
 the subroutine type name as it appears in the source program.
 
 If the subroutine type describes a function that returns
@@ -1766,7 +1811,9 @@ A string type is represented by a debugging information entry
 with the tag \livetarg{chap:DWTAGstringtype}{DW\-\_TAG\-\_string\-\_type}. 
 If a name has been given to
 the string type in the source program, then the corresponding
-string type entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute whose value is
+string type entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute
+\addtoindexx{name attribute}
+whose value is
 a null\dash terminated string containing the string type name as
 it appears in the source program.
 
@@ -1803,7 +1850,9 @@ a group of values of ordinal type.}
 A set is represented by a debugging information entry with
 the tag \livetarg{chap:DWTAGsettype}{DW\-\_TAG\-\_set\-\_type}. 
 If a name has been given to the
-set type, then the set type entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute
+set type, then the set type entry has 
+a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute
+\addtoindexx{name attribute}
 whose value is a null\dash terminated string containing the
 set type name as it appears in the source program.
 
@@ -1834,7 +1883,9 @@ entry with the
 tag \livetarg{chap:DWTAGsubrangetype}{DW\-\_TAG\-\_subrange\-\_type}. 
 If a name has been
 given to the subrange type, then the subrange type entry
-has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute whose value is a null\dash terminated
+has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute
+\addtoindexx{name attribute}
+whose value is a null\dash terminated
 string containing the subrange type name as it appears in
 the source program.
 
@@ -1907,7 +1958,7 @@ bound is 0 for
 The default lower bound is 1 for 
 \addtoindex{Ada}, \addtoindex{COBOL},
 \addtoindex{Fortran}, 
-\addtoindex{Modula}\dash 2, 
+\addtoindex{Modula-2},
 \addtoindex{Pascal} and 
 \addtoindex{PL/I}.
 
@@ -1958,7 +2009,9 @@ object that is a pointer to a structure or class member has
 the tag \livetarg{chap:DWTAGptrtomembertype}{DW\-\_TAG\-\_ptr\-\_to\-\_member\-\_type}.
 
 If the pointer to member type has a name, the pointer to
-member entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, whose value is a
+member entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute,
+\addtoindexx{name attribute}
+whose value is a
 null\dash terminated string containing the type name as it appears
 in the source program.
 
@@ -2033,7 +2086,9 @@ with
 the 
 \livetarg{chap:DWTAGfiletype}{DW\-\_TAG\-\_file\-\_type}. 
 If the file type has a name,
-the file type entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, whose value
+the file type entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute,
+\addtoindexx{name attribute}
+whose value
 is a null\dash terminated string containing the type name as it
 appears in the source program.
 
@@ -2156,7 +2211,9 @@ A type named using a template alias is represented
 by a debugging information entry with the tag
 \livetarg{chap:DWTAGtemplatealias}{DW\-\_TAG\-\_template\-\_alias}. 
 The template alias entry has a
-\livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute whose value is a null\dash terminated string
+\livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute 
+\addtoindexx{name attribute}
+whose value is a null\dash terminated string
 containing the name of the template alias as it appears in
 the source program. The template alias entry also contains a
 \livelink{chap:DWATtype}{DW\-\_AT\-\_type} attribute whose value is a reference to the type
@@ -2169,7 +2226,9 @@ in the template alias declaration is represented
 by a debugging information entry with the tag
 \livelink{chap:DWTAGtemplatetypeparameter}{DW\-\_TAG\-\_template\-\_type\-\_parameter}. 
 Each such entry may have
-a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, whose value is a null\dash terminated
+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 template type parameter
 entry also has a \livelink{chap:DWATtype}{DW\-\_AT\-\_type} attribute describing the actual
@@ -2180,7 +2239,9 @@ appearing in the template alias declaration is
 represented by a debugging information entry with the tag
 \livelink{chap:DWTAGtemplatevalueparameter}{DW\-\_TAG\-\_template\-\_value\-\_parameter}. 
 Each such entry may have
-a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, whose value is a null\dash terminated
+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 value parameter
 as it appears in the source program. The template value
 parameter entry also has a \livelink{chap:DWATtype}{DW\-\_AT\-\_type} attribute describing