Added the livetargi command and use it when creating
authorDavid Anderson <davea42@earthlink.net>
Tue, 29 May 2012 16:53:47 +0000 (09:53 -0700)
committerDavid Anderson <davea42@earthlink.net>
Tue, 29 May 2012 16:53:47 +0000 (09:53 -0700)
the index entries for the experloc and other class definitions.

dwarf5/latexdoc/dwarf5.tex
dwarf5/latexdoc/generaldescription.tex

index aa2c649..765332d 100644 (file)
@@ -70,7 +70,9 @@ escapeinside={\%*}{*)}  % if you want to add a comment within your code
 % use like \livelink{chap:DWOPdup}{DW\_OP\_dup}
 \newcommand{\livelink}[2]{ \hyperref[#1]{#2}\index{#2} }
 % livetarg is the declaration this is the target of livelinks.
-\newcommand{\livetarg}[2]{ \label{#1} #2\index{#2}  }
+\newcommand{\livetarg}[2]{\label{#1}#2\index{#2}}
+% When we want the index entry to look different from the name.
+\newcommand{\livetargi}[3]{\label{#1}#2\index{#3}}
 
 \newcommand{\dash}{\nobreakdash-\hspace{0pt}}  % So we handle dashes ok.
 
index 7746145..09f730e 100644 (file)
@@ -380,23 +380,27 @@ Section 7.6.).
 another (codes, offsets, counts, and so on); these are
 sometimes called ``integer constants'' for emphasis.} \\
 
-\index{exprloc class}exprloc\label{chap:exprloc}&A DWARF expression or location description.
+\livetargi{chap:exprloc}{exprloc}{exprloc class}
+&A DWARF expression or location description.
 \\
-\index{flag class}flag&A small constant that indicates the presence or absence of an attribute.
+\livetargi{chap:flag}{flag}{flag class}
+&A small constant that indicates the presence or absence of an attribute.
 \\
-\index{lineptr class}lineptr& Refers to a location in the DWARF section that holds line number information.
+\livetargi{chap:lineptr}{lineptr}{lineptr class}
+&Refers to a location in the DWARF section that holds line number information.
 \\
-\index{loclistptr class}loclistptr&Refers to a location in the DWARF section that holds location lists, which
+\livetargi{chap:loclistptr}{loclistptr}{loclistptr class}
+&Refers to a location in the DWARF section that holds location lists, which
 describe objects whose location can change during their lifetime.
 \\
-\index{macptr class}macptr
+\livetargi{chap:macptr}{macptr}{macptr class}
 & Refers to a location in the DWARF section that holds macro definition
  information.  \\
-
-\index{rangelistptr class}rangelistptr
+\livetargi{chap:rangelistptr}{rangelistptr}{rangelistptr class}
 & Refers to a location in the DWARF section that holds non\dash contiguous address ranges.  \\
 
-\index{reference class}reference& Refers to one of the debugging information
+\livetargi{chap:reference}{reference}{reference class}
+& Refers to one of the debugging information
 entries that describe the program.  There are three types of
 reference. The first is an offset relative to the beginning
 of the compilation unit in which the reference occurs and must
@@ -407,7 +411,8 @@ the unit containing the reference. The third type of reference
 is an indirect reference to a type definition using a 64\dash
 bit signature for that type.  \\
 
-\index{string class}string&A null\dash terminated sequence of zero or more
+\livetargi{chap:string}{string}{string class}
+& A null\dash terminated sequence of zero or more
 (non\dash null) bytes. Data in this class are generally
 printable strings. Strings may be represented directly in
 the debugging information entry or as an offset in a separate