tools/fileio.py was not tokenizing
[dwarf-doc.git] / dwarf5 / READMEindexing
index 8645dd2..4870832 100644 (file)
@@ -17,6 +17,7 @@ Of course the command also indexes the link.
 The actual command definitions in dwarf5.tex are:
 \newcommand{\addtoindex}[1]{#1\index{#1}}
 \newcommand{\addtoindexi}[2]{#1\index{#2}}
+\newcommand{\addtoindexx}[1]{\index{#1}}
 \newcommand{\noindex}[1]{#1}
 
 Where a word or phrase is to be indexed.
@@ -59,6 +60,10 @@ a math character.
 \addtoindexi{address selection}{address selection|see{base address selection}}
 
 
+Use \textgreater  and \textless to represent < and >
+in indexes (and other contexts).  For example
+       \textless caf\textgreater   results in <caf>
+oddly enough.
 
 
 ---Linking
@@ -94,6 +99,13 @@ If the 'makes use of' or some other text is not between
 the hypertarget and hyperlink latex produces output text of
 chap:DWATabstractorigin instead of thinking of it as a link.
 
+It's also useful to put the hypertarget before the livelink
+for the attribute use in the sentence because then when your
+reader takes you to the hypertarget (via a mouse click) 
+you will see the attribute instance (assumuing
+your  viewer puts the 'target' location at the top of
+the viewing area).
+
 --- Linking (continued)
 
 The first argument in a livelink/livetarg/livetargi command