These had a handful of spelling errors. None
[dwarf-doc.git] / dwarf5 / latexdoc / dwarf5.tex
index f17cf38..b93f366 100644 (file)
@@ -43,7 +43,7 @@ escapeinside={\%*}{*)}  % if you want to add a comment within your code
 \usepackage[plainpages=false,pdfpagelabels,pagebackref]{hyperref}  % Lets us generate colored active links inside a pdf.
 \makeindex  % This and the makeidx package allow \index to create index entries.
 
-\newcommand{\docdate}{29 May 2012}
+\newcommand{\docdate}{21 October 2012}
 
 \newcommand{\dwf}{DWARF Debugging Information Format}
 \newenvironment{myindentpara}[1]%
@@ -64,11 +64,13 @@ escapeinside={\%*}{*)}  % if you want to add a comment within your code
 
 % Generate a page ref.
 % use like   \refersec{chap:registerbasedaddressing}
-\newcommand{\refersec}[1]{ \ref{#1} Page \pageref{#1} }
+\newcommand{\refersec}[1]{\ref{#1} on page \pageref{#1}}
 
 % Generate a live link in the document
 % use like \livelink{chap:DWOPdup}{DW\-\_OP\-\_dup}
-\newcommand{\livelink}[2]{\hyperlink{#1}{#2}\index{#2} }
+\newcommand{\livelink}[2]{\hyperlink{#1}{#2}\index{#2}}
+% use when the index is different from the text and target.
+\newcommand{\livelinki}[3]{\hyperlink{#1}{#2}\index{#3}}
 % livetarg is the declaration this is the target of livelinks.
 % FIXME: we might want livetarg and livetargi  #2 to be \textbf{#2}
 \newcommand{\livetarg}[2]{\hypertarget{#1}{#2}\index{#2}}
@@ -77,8 +79,19 @@ escapeinside={\%*}{*)}  % if you want to add a comment within your code
 
 \newcommand{\dash}{\nobreakdash-\hspace{0pt}}  % So we handle dashes ok.
 
-%Fors simple index entries, this saves typing.
+% The following two let us mark a word as 'do not link' or
+% 'do not index' to indicate the word is used generically
+% and has been considered so do not index or link it.
+% There is no significant difference in the two commands, though
+% \nolink would be more oriented to words such as flag or address
+% that might be linked (and indexed) in some circumstances.
+\newcommand{\nolink}[1]{#1}
+\newcommand{\noindex}[1]{#1}
+
+%For index entries.
 \newcommand{\addtoindex}[1]{#1\index{#1}}
+\newcommand{\addtoindexi}[2]{#1\index{#2}}
+\newcommand{\addtoindexx}[1]{\index{#1}}
 
 
 \begin{document}
@@ -97,7 +110,7 @@ escapeinside={\%*}{*)}  % if you want to add a comment within your code
 \textbf{Version 4.1}
 
 \centering
-\includegraphics[keepaspectratio=true,scale=0.5]{DWlogo}
+\includegraphics[keepaspectratio=true,scale=1.0]{DWlogo}
 
 \centering
 \href{http://www.dwarfstd.org}{\dwf\ Committee} 
@@ -144,9 +157,14 @@ escapeinside={\%*}{*)}  % if you want to add a comment within your code
 \include{foreword}
 
 \tableofcontents
+
+\newpage
 \listoffigures
+
+\newpage
 \listoftables
 
+\newpage
 \mainmatter
 
 % Define the levels of sectionality that are numbered.
@@ -171,6 +189,7 @@ escapeinside={\%*}{*)}  % if you want to add a comment within your code
 
 \aliaspagestyle{chapter}{fragFirstChPage}
 
+\flushleft
 
 \include{introduction}
 \include{generaldescription}