Created links and targets for DW_LNE_ DW_LNS_ DW_MACINFO_ .
[dwarf-doc.git] / dwarf5 / latexdoc / datarepresentation.tex
index 4f2f6cf..58a5e1c 100644 (file)
@@ -35,7 +35,8 @@ between the number of standard line number opcodes and
 the first special line number opcode. However, since the
 number of standard opcodes varies with the DWARF version,
 the range for extensions is also version dependent. Thus,
-DW\-\_LNS\-\_lo\-\_user and DW\-\_LNS\-\_hi\-\_user symbols are not defined.}
+\livetarg{chap:DWLNSlouser}{DW\-\_LNS\-\_lo\-\_user} and 
+\livetarg{chap:DWLNShiuser}{DW\-\_LNS\-\_hi\-\_user} symbols are not defined.}
 
 Vendor defined tags, attributes, base type encodings, location
 atoms, language names, line number actions, calling conventions
@@ -1310,11 +1311,11 @@ Table \refersec{tab:decimalsignencodings}.
   \hline
 \endlastfoot
 
-DW\-\_DS\-\_unsigned & 0x01  \\
-DW\-\_DS\-\_leading\-\_overpunch & 0x02  \\
-DW\-\_DS\-\_trailing\-\_overpunch & 0x03  \\
-DW\-\_DS\-\_leading\-\_separate & 0x04  \\
-DW\-\_DS\-\_trailing\-\_separate & 0x05  \\
+\livelink{chap:DWDSunsigned}{DW\-\_DS\-\_unsigned} & 0x01  \\
+\livelink{chap:DWDSleadingoverpunch}{DW\-\_DS\-\_leading\-\_overpunch} & 0x02  \\
+\livelink{chap:DWDStrailingoverpunch}{DW\-\_DS\-\_trailing\-\_overpunch} & 0x03  \\
+\livelink{chap:DWDSleadingseparate}{DW\-\_DS\-\_leading\-\_separate} & 0x04  \\
+\livelink{chap:DWDStrailingseparate}{DW\-\_DS\-\_trailing\-\_separate} & 0x05  \\
 
 \end{longtable}
 \end{centering}
@@ -1336,11 +1337,11 @@ Table \refersec{tab:endianityencodings}.
   \hline
 \endlastfoot
 
-DW\-\_END\-\_default  & 0x00 \\
-DW\-\_END\-\_big & 0x01 \\
-DW\-\_END\-\_little & 0x02 \\
-DW\-\_END\-\_lo\-\_user & 0x40 \\
-DW\-\_END\-\_hi\-\_user & 0xff \\
+\livelink{chap:DWENDdefault}{DW\-\_END\-\_default}  & 0x00 \\
+\livelink{chap:DWENDbig}{DW\-\_END\-\_big} & 0x01 \\
+\livelink{chap:DWENDlittle}{DW\-\_END\-\_little} & 0x02 \\
+\livetarg{chap:DWENDlouser}{DW\-\_END\-\_lo\-\_user} & 0x40 \\
+\livetarg{chap:DWENDhiuser}{DW\-\_END\-\_hi\-\_user} & 0xff \\
 
 \end{longtable}
 \end{centering}
@@ -1462,28 +1463,28 @@ defined language.
   \hline
 \endlastfoot
 
-DW\-\_LANG\-\_C89&0x0001&0       \\
-DW\-\_LANG\-\_C&0x0002&0       \\
-DW\-\_LANG\-\_Ada83 \dag &0x0003&1       \\
-DW\-\_LANG\-\_C\-\_plus\-\_plus &0x0004&0       \\
-DW\-\_LANG\-\_Cobol74 \dag &0x0005&1       \\
-DW\-\_LANG\-\_Cobol85 \dag &0x0006&1       \\
-DW\-\_LANG\-\_Fortran77&0x0007&1       \\
-DW\-\_LANG\-\_Fortran90&0x0008&1       \\
-DW\-\_LANG\-\_Pascal83&0x0009&1       \\
-DW\-\_LANG\-\_Modula2&0x000a&1       \\
-DW\-\_LANG\-\_Java&0x000b&0       \\
-DW\-\_LANG\-\_C99&0x000c&0       \\
-DW\-\_LANG\-\_Ada95 \dag &0x000d&1       \\
-DW\-\_LANG\-\_Fortran95 &0x000e&1       \\
-DW\-\_LANG\-\_PLI \dag &0x000f&1 \\
-DW\-\_LANG\-\_ObjC&0x0010&0 \\
-DW\-\_LANG\-\_ObjC\-\_plus\-\_plus&0x0011&0 \\
-DW\-\_LANG\-\_UPC&0x0012&0 \\
-DW\-\_LANG\-\_D&0x0013&0 \\
-DW\-\_LANG\-\_Python \dag &0x0014&0 \\
-DW\-\_LANG\-\_lo\-\_user&0x8000 & \\
-DW\-\_LANG\-\_hi\-\_user&0xffff & \\
+\livelink{chap:DWLANGC89}{DW\-\_LANG\-\_C89}&0x0001&0       \\
+\livelink{chap:DWLANGC}{DW\-\_LANG\-\_C}&0x0002&0       \\
+\livelink{chap:DWLANGAda83}{DW\-\_LANG\-\_Ada83} \dag &0x0003&1       \\
+\livelink{chap:DWLANGCplusplus}{DW\-\_LANG\-\_C\-\_plus\-\_plus} &0x0004&0       \\
+\livelink{chap:DWLANGCobol74}{DW\-\_LANG\-\_Cobol74} \dag &0x0005&1       \\
+\livelink{chap:DWLANGCobol85}{DW\-\_LANG\-\_Cobol85} \dag &0x0006&1       \\
+\livelink{chap:DWLANGFortran77}{DW\-\_LANG\-\_Fortran77}&0x0007&1       \\
+\livelink{chap:DWLANGFortran90}{DW\-\_LANG\-\_Fortran90}&0x0008&1       \\
+\livelink{chap:DWLANGPascal83}{DW\-\_LANG\-\_Pascal83}&0x0009&1       \\
+\livelink{chap:DWLANGModula2}{DW\-\_LANG\-\_Modula2}&0x000a&1       \\
+\livelink{chap:DWLANGJava}{DW\-\_LANG\-\_Java}&0x000b&0       \\
+\livelink{chap:DWLANGC99}{DW\-\_LANG\-\_C99}&0x000c&0       \\
+\livelink{chap:DWLANGAda95}{DW\-\_LANG\-\_Ada95} \dag &0x000d&1       \\
+\livelink{chap:DWLANGFortran95}{DW\-\_LANG\-\_Fortran95} &0x000e&1       \\
+\livelink{chap:DWLANGPLI}{DW\-\_LANG\-\_PLI} \dag &0x000f&1 \\
+\livelink{chap:DWLANGObjC}{DW\-\_LANG\-\_ObjC}&0x0010&0 \\
+\livelink{chap:DWLANGObjCplusplus}{DW\-\_LANG\-\_ObjC\-\_plus\-\_plus}&0x0011&0 \\
+\livelink{chap:DWLANGUPC}{DW\-\_LANG\-\_UPC}&0x0012&0 \\
+\livelink{chap:DWLANGD}{DW\-\_LANG\-\_D}&0x0013&0 \\
+\livelink{chap:DWLANGPython}{DW\-\_LANG\-\_Python} \dag &0x0014&0 \\
+\livetarg{chap:DWLANGlouser}{DW\-\_LANG\-\_lo\-\_user}&0x8000 & \\
+\livetarg{chap:DWLANGhiuser}{DW\-\_LANG\-\_hi\-\_user}&0xffff & \\
 
 \end{longtable}
 \dag See text
@@ -1515,10 +1516,10 @@ Table \refersec{tab:identifiercaseencodings}.
 \endfoot
   \hline
 \endlastfoot
-DW\-\_ID\-\_case\-\_sensitive&0x00     \\
-DW\-\_ID\-\_up\-\_case&0x01     \\
-DW\-\_ID\-\_down\-\_case&0x02     \\
-DW\-\_ID\-\_case\-\_insensitive&0x03     \\
+\livelink{chap:DWIDcasesensitive}{DW\-\_ID\-\_case\-\_sensitive}&0x00     \\
+\livelink{chap:DWIDupcase}{DW\-\_ID\-\_up\-\_case}&0x01     \\
+\livelink{chap:DWIDdowncase}{DW\-\_ID\-\_down\-\_case}&0x02     \\
+\livelink{chap:DWIDcaseinsensitive}{DW\-\_ID\-\_case\-\_insensitive}&0x03     \\
 \end{longtable}
 \end{centering}
 
@@ -1570,10 +1571,10 @@ Table \refersec{tab:inlineencodings}.
   \hline
 \endlastfoot
 
-DW\-\_INL\-\_not\-\_inlined&0x00      \\
-DW\-\_INL\-\_inlined&0x01      \\
-DW\-\_INL\-\_declared\-\_not\-\_inlined&0x02      \\
-DW\-\_INL\-\_declared\-\_inlined&0x03      \\
+\livelink{chap:DWINLnotinlined}{DW\-\_INL\-\_not\-\_inlined}&0x00      \\
+\livelink{chap:DWINLinlined}{DW\-\_INL\-\_inlined}&0x01      \\
+\livelink{chap:DWINLdeclarednotinlined}{DW\-\_INL\-\_declared\-\_not\-\_inlined}&0x02      \\
+\livelink{chap:DWINLdeclaredinlined}{DW\-\_INL\-\_declared\-\_inlined}&0x03      \\
 
 \end{longtable}
 \end{centering}
@@ -1631,8 +1632,8 @@ Table \refersec{tab:discriminantdescriptorencodings}.
   \hline
 \endlastfoot
 
-DW\-\_DSC\-\_label&0x00 \\
-DW\-\_DSC\-\_range&0x01 \\
+\livetarg{chap:DWDSClabel}{DW\-\_DSC\-\_label}&0x00 \\
+\livetarg{chap:DWDSCrange}{DW\-\_DSC\-\_range}&0x01 \\
 
 \end{longtable}
 \end{centering}
@@ -1780,18 +1781,18 @@ Table \refersec{tab:linenumberstandardopcodeencodings}.
   \hline
 \endlastfoot
 
-DW\-\_LNS\-\_copy&0x01 \\
-DW\-\_LNS\-\_advance\-\_pc&0x02 \\
-DW\-\_LNS\-\_advance\-\_line&0x03 \\
-DW\-\_LNS\-\_set\-\_file&0x04 \\
-DW\-\_LNS\-\_set\-\_column&0x05 \\
-DW\-\_LNS\-\_negate\-\_stmt&0x06 \\
-DW\-\_LNS\-\_set\-\_basic\-\_block&0x07 \\
-DW\-\_LNS\-\_const\-\_add\-\_pc*0x08 \\
-DW\-\_LNS\-\_fixed\-\_advance\-\_pc&0x09 \\
-DW\-\_LNS\-\_set\-\_prologue\-\_end&0x0a \\
-DW\-\_LNS\-\_set\-\_epilogue\-\_begin&0x0b \\
-DW\-\_LNS\-\_set\-\_isa&0x0c \\
+\livelink{chap:DWLNScopy}{DW\-\_LNS\-\_copy}&0x01 \\
+\livelink{chap:DWLNSadvancepc}{DW\-\_LNS\-\_advance\-\_pc}&0x02 \\
+\livelink{chap:DWLNSadvanceline}{DW\-\_LNS\-\_advance\-\_line}&0x03 \\
+\livelink{chap:DWLNSsetfile}{DW\-\_LNS\-\_set\-\_file}&0x04 \\
+\livelink{chap:DWLNSsetcolumn}{DW\-\_LNS\-\_set\-\_column}&0x05 \\
+\livelink{chap:DWLNSnegatestmt}{DW\-\_LNS\-\_negate\-\_stmt}&0x06 \\
+\livelink{chap:DWLNSsetbasicblock}{DW\-\_LNS\-\_set\-\_basic\-\_block}&0x07 \\
+\livelink{chap:DWLNSconstaddpc}{DW\-\_LNS\-\_const\-\_add\-\_pc}*0x08 \\
+\livelink{chap:DWLNSfixedadvancepc}{DW\-\_LNS\-\_fixed\-\_advance\-\_pc}&0x09 \\
+\livelink{chap:DWLNSsetprologueend}{DW\-\_LNS\-\_set\-\_prologue\-\_end}&0x0a \\
+\livelink{chap:DWLNSsetepiloguebegin}{DW\-\_LNS\-\_set\-\_epilogue\-\_begin}&0x0b \\
+\livelink{chap:DWLNSsetisa}{DW\-\_LNS\-\_set\-\_isa}&0x0c \\
 
 \end{longtable}
 \end{centering}
@@ -1813,12 +1814,12 @@ Table \refersec{tab:linenumberextendedopcodeencodings}.
   \hline
 \endlastfoot
 
-DW\-\_LNE\-\_end\-\_sequence&0x01    \\
-DW\-\_LNE\-\_set\-\_address&0x02\\
-DW\-\_LNE\-\_define\-\_file&0x03\\
-DW\-\_LNE\-\_set\-\_discriminator \ddag &0x04   \\
-DW\-\_LNE\-\_lo\-\_user&0x80   \\
-DW\-\_LNE\-\_hi\-\_user&0xff   \\
+\livelink{chap:DWLNEendsequence}{DW\-\_LNE\-\_end\-\_sequence}&0x01    \\
+\livelink{chap:DWLNEsetaddress}{DW\-\_LNE\-\_set\-\_address}&0x02\\
+\livelink{chap:DWLNEdefinefile}{DW\-\_LNE\-\_define\-\_file}&0x03\\
+\livelink{chap:DWLNEsetdiscriminator}{DW\-\_LNE\-\_set\-\_discriminator} \ddag &0x04   \\
+\livetarg{chap:DWLNElouser}{DW\-\_LNE\-\_lo\-\_user}&0x80   \\
+\livetarg{chap:DWLNEhiuser}{DW\-\_LNE\-\_hi\-\_user}&0xff   \\
 
 \end{longtable}
 \ddag Extended opcode new in DWARF Version 4.
@@ -1829,7 +1830,7 @@ DW\-\_LNE\-\_hi\-\_user&0xff   \\
 
 The source line numbers and source file indices encoded in the
 macro information section are represented as unsigned LEB128
-numbers as are the constants in a DW\-\_MACINFO\-\_vendor\-\_ext entry.
+numbers as are the constants in a \livelink{chap:DWMACINFOvendorext}{DW\-\_MACINFO\-\_vendor\-\_ext} entry.
 
 The macinfo type is encoded as a single byte. 
 The encodings are given in 
@@ -1849,11 +1850,11 @@ Table \refersec{tab:macinfotypeencodings}.
   \hline
 \endlastfoot
 
-DW\-\_MACINFO\-\_define&0x01 \\
-DW\-\_MACINFO\-\_undef&0x02 \\
-DW\-\_MACINFO\-\_start\-\_file&0x03 \\
-DW\-\_MACINFO\-\_end\-\_file&0x04 \\
-DW\-\_MACINFO\-\_vendor\-\_ext&0xff \\
+\livelink{chap:DWMACINFOdefine}{DW\-\_MACINFO\-\_define}&0x01 \\
+\livelink{chap:DWMACINFOundef}{DW\-\_MACINFO\-\_undef}&0x02 \\
+\livelink{chap:DWMACINFOstartfile}{DW\-\_MACINFO\-\_start\-\_file}&0x03 \\
+\livelink{chap:DWMACINFOendfile}{DW\-\_MACINFO\-\_end\-\_file}&0x04 \\
+\livelink{chap:DWMACINFOvendorext}{DW\-\_MACINFO\-\_vendor\-\_ext}&0xff \\
 
 \end{longtable}
 \end{centering}