Merge branch 'HEAD' of dwarfgit@dwarfstd.org:dwarf-doc.git
[dwarf-doc.git] / dwarf5 / latexdoc / compression.tex
index ea149cd..1aec7b6 100644 (file)
@@ -1,5 +1,5 @@
 \chapter[Compression (Informative)]{DWARF Compression and Duplicate Elimination (Informative)}
-\label{dwarfcompressionandduplicateeliminationinformative}
+\label{app:dwarfcompressionandduplicateeliminationinformative}
 
 % It seemed difficult to get close to the same layout and 
 % captioning as DWARF4 here with figures as they moved (floated)
@@ -233,7 +233,7 @@ the same
 \textless gid\dash number\textgreater,
 and
 
-\item  a non\dash matching output (say because of \texttt{\#defines})
+\item  a non-matching output (say because of \texttt{\#defines})
 generates a different 
 \textless gid\dash number\textgreater.
 \end{itemize}
@@ -299,7 +299,7 @@ symbol table, whether the current compilation references all
 those points or not.
 
 \textit{The completeness of the set of names generated is a
-quality\dash of\dash implementation issue.}
+quality-of-implementation issue.}
 
 It is up to the producer to ensure that if 
 \textless die\dash numbers\textgreater\ 
@@ -458,20 +458,20 @@ representation intended to allow duplicate elimination.
 
 \begin{figure}[ht]
 \textit{File wa.h}
-\begin{lstlisting}[numbers=none]
+\begin{nlnlisting}
 struct A {
    int i;
 };
-\end{lstlisting}
+\end{nlnlisting}
 \textit{File wa.c}
-\begin{lstlisting}[numbers=none]
+\begin{nlnlisting}
 #include "wa.h";
 int
 f(A &a)
 {
     return a.i + 2;
 }
-\end{lstlisting}
+\end{nlnlisting}
 \caption{Duplicate elimination example \#1: C++ Source}
 \label{fig:duplicateeliminationexample1csource}
 \end{figure}
@@ -578,23 +578,23 @@ For a \addtoindex{Fortran}
 example, consider 
 Figure \refersec{fig:duplicateeliminationexample2fortransource}.
 
-\begin{figure}[h]
+\begin{figure}[ht]
 \textit{File CommonStuff.f\hspace{1pt}h}
 \addtoindexx{Fortran}
-\begin{lstlisting}[numbers=none]
+\begin{nlnlisting}
 IMPLICIT INTEGER(A-Z)
 COMMON /Common1/ C(100)
 PARAMETER(SEVEN = 7)
-\end{lstlisting}
+\end{nlnlisting}
 
 \textit{File Func.f}
-\begin{lstlisting}[numbers=none]
+\begin{nlnlisting}
 FUNCTION FOO (N)
 INCLUDE 'CommonStuff.fh'
 FOO = C(N + SEVEN)
 RETURN
 END
-\end{lstlisting}
+\end{nlnlisting}
 \caption{Duplicate elimination example \#2: Fortran source} 
 \label{fig:duplicateeliminationexample2fortransource}
 \end{figure}
@@ -689,12 +689,12 @@ Figure \refersec{fig:duplicateeliminationexample2companionsource}
 
 \begin{figure}
 \textit{File Main.f} 
-\begin{lstlisting}[numbers=none]
+\begin{nlnlisting}
 INCLUDE 'CommonStuff.fh'
 C(50) = 8
 PRINT *, 'Result = ', FOO(50 - SEVEN)
 END
-\end{lstlisting}
+\end{nlnlisting}
 \caption{Duplicate elimination example \#2: companion source }
 \label{fig:duplicateeliminationexample2companionsource}
 \end{figure}
@@ -793,8 +793,8 @@ consider a \addtoindex{C++} header file
 containing the type definitions shown
 in Figure \refersec{fig:typesignatureexamplescsource}.
 
-\begin{figure}[h]
-\begin{lstlisting}
+\begin{figure}[ht]
+\begin{nlnlisting}
 namespace N {
 
     struct B;
@@ -815,7 +815,7 @@ namespace N {
         struct C c;
     };
 }
-\end{lstlisting}
+\end{nlnlisting}
 \caption{Type signature examples: C++ source}
 \label{fig:typesignatureexamplescsource}
 \end{figure}
@@ -908,7 +908,7 @@ Figure \refersec{fig:typesignaturecomputation1flattenedbytestream}.
     // Step 3: 'D' \DWTAGmember
     0x44 0x0d
     // Step 4: 'A' \DWATname \DWFORMstring "y"
-    0x41 0x03 0x08 0x78 0x00
+    0x41 0x03 0x08 0x79 0x00
     // Step 4: 'A' \DWATdatamemberlocation \DWFORMsdata 4
     0x41 0x38 0x0d 0x04
     // Step 6: 'R' \DWATtype (type \#2)
@@ -1131,7 +1131,7 @@ to \texttt{N::C}, using
     // Step 6: 'T' \DWATtype (type \#4)
     0x54 0x49
         // Step 3: 'D' \DWTAGpointertype
-0x44 0x0f
+        0x44 0x0f
         // Step 5: 'N' \DWATtype
         0x4e 0x49
         // Step 5: 'C' \DWTAGnamespace "N" 'E'
@@ -1231,7 +1231,7 @@ variable of type \texttt{N::A}, and its DWARF information may look
 like that shown in 
 Figure \refersec{fig:typesignatureexampleusage}.
 
-\begin{figure}[h]
+\begin{figure}[ht]
 \begin{dwflisting}
 \begin{alltt}
   \DWTAGcompileunit
@@ -1259,7 +1259,7 @@ how the bytes of the flattened type description are formed
 during the type signature computation algorithm of
 Section \refersec{datarep:typesignaturecomputation}. 
 
-\begin{figure}[h]
+\begin{figure}[ht]
 \begin{dwflisting}
 %FIXME: The index entries here with \addtoindexx are ineffective.
 \begin{alltt}
@@ -1280,7 +1280,7 @@ attribute
     : 'T' at-code signature              // Recursive type
 children                 //  Step 7
     : child children
-    : '0'
+    : '\textbackslash{}0'
 child
     : 'S' tag-code string
     : signature
@@ -1294,13 +1294,13 @@ form-encoded-value
     : \DWFORMstring string \addtoindexx{string class}
     : \DWFORMblock \nolink{block} \addtoindexx{block class}
 \DWFORMstring \addtoindexx{string class}
-    : 'x08'
+    : '\textbackslash{}x08'
 \DWFORMblock  \addtoindexx{block class}
-    : 'x09'
+    : '\textbackslash{}x09'
 \DWFORMflag \addtoindexx{flag class}
-    : 'x0c'
+    : '\textbackslash{}x0c'
 \DWFORMsdata \addtoindexx{constant class}
-    : 'x0d'
+    : '\textbackslash{}x0d'
 value
     : <SLEB128>
 \nolink{block}
@@ -1327,7 +1327,7 @@ A possible representation of the
 debug information for this function in the compilation unit is shown
 in Figure \refersec{fig:completingedeclarationofamemberfunctiondwarf}.
 
-\begin{figure}[h]
+\begin{figure}[ht]
 \begin{dwflisting}
 \begin{alltt}
   \DWTAGnamespace