diff -Nru cxref-1.6a.old/debian/changelog cxref-1.6a/debian/changelog
--- cxref-1.6a.old/debian/changelog	2008-04-18 08:42:56.180400423 +0200
+++ cxref-1.6a/debian/changelog	2008-05-08 08:33:27.233708844 +0200
@@ -1,3 +1,18 @@
+cxref (1.6a-1.2) unstable; urgency=low
+
+  * Non-maintainer upload to fix pending l10n issues.
+  * Debconf translations:
+    - Galician. Closes: #412871
+    - Finnish. Closes: #478568
+  * [Lintian] Fix doc-base section to "Programming" in doc-base files
+  * [Lintian] Remove non-doc files from listed files in doc-base files
+  * [Lintian] Remove extra spaces at the end of cxref.doc-base
+  * [Lintian] Add real copyright information to debian/copyright
+  * [Lintian] cxref-emacs depend on emacs22 and no longer emacs21
+  * [Lintian) No longer ignore errors by "make distclean"
+
+ -- Christian Perrier <bubulle@debian.org>  Fri, 18 Apr 2008 08:47:53 +0200
+
 cxref (1.6a-1.1) unstable; urgency=low
 
   * Non-maintainer upload (originally meant) to fix longstanding l10n issues
diff -Nru cxref-1.6a.old/debian/control cxref-1.6a/debian/control
--- cxref-1.6a.old/debian/control	2008-04-18 08:42:56.180400423 +0200
+++ cxref-1.6a/debian/control	2008-04-18 11:28:52.415328785 +0200
@@ -34,7 +34,7 @@
 Package: cxref-emacs
 Section: editors
 Architecture: all
-Depends: emacs21 | emacsen, emacsen-common (>= 1.4.14)
+Depends: emacs22 | emacsen, emacsen-common (>= 1.4.14)
 Description: Generates latex and HTML documentation for C programs
  This package provides an emacs mode facilitating the use of cxref,
  and enabling the display of a hierarchical flow graph of cxref
diff -Nru cxref-1.6a.old/debian/copyright cxref-1.6a/debian/copyright
--- cxref-1.6a.old/debian/copyright	2008-04-18 08:42:55.872396590 +0200
+++ cxref-1.6a/debian/copyright	2008-04-18 11:27:30.671328175 +0200
@@ -5,6 +5,6 @@
 
 Upstream Author: Andrew M. Bishop, amb@gedanken.demon.co.uk.
 
-Copyright: GPL
+Copyright © Andrew M. Bishop 1995,96,97,98,99
 
 See /usr/share/common-licenses/GPL
diff -Nru cxref-1.6a.old/debian/cxref-doc.doc-base cxref-1.6a/debian/cxref-doc.doc-base
--- cxref-1.6a.old/debian/cxref-doc.doc-base	2008-04-18 08:42:55.728396509 +0200
+++ cxref-1.6a/debian/cxref-doc.doc-base	2008-04-18 11:24:49.963329793 +0200
@@ -2,16 +2,7 @@
 Title: Cxref Examples
 Author: Andrew M. Bishop
 Abstract: Generates latex and HTML documentation for C programs.
-Section: Apps/Programming
-
-Format: LaTeX
-Files: /usr/share/doc/cxref-doc/examples/*.tex.gz /usr/share/doc/cxref-doc/examples/*.tex
-
-Format: DVI
-Files: /usr/share/doc/cxref-doc/examples/*.dvi.gz /usr/share/doc/cxref-doc/examples/*.dvi
-
-Format: rtf
-Files: /usr/share/doc/cxref-doc/examples/*.rtf.gz /usr/share/doc/cxref-doc/examples/*.rtf
+Section: Programming
 
 Format: HTML
 Index: /usr/share/doc/cxref-doc/examples/cxref.html
diff -Nru cxref-1.6a.old/debian/cxref.doc-base cxref-1.6a/debian/cxref.doc-base
--- cxref-1.6a.old/debian/cxref.doc-base	2008-04-18 08:42:55.856404379 +0200
+++ cxref-1.6a/debian/cxref.doc-base	2008-04-18 11:25:56.030489329 +0200
@@ -2,19 +2,11 @@
 Title:  Cxref Manual
 Author: Andrew M. Bishop
 Abstract: Generates latex and HTML documentation for C programs.
-Section: Apps/Programming
+Section: Programming
 
 Format: text
-Files: /usr/share/doc/cxref/FAQ.gz /usr/share/doc/cxref/README.gz
-
-Format: LaTeX
-Files: /usr/share/doc/cxref/FAQ.gz /usr/share/doc/cxref/README.tex.gz
-
-Format: debiandoc-sgml
-Files: /usr/share/doc/cxref/FAQ.gz /usr/share/doc/cxref/README.sgml.gz
+Files: /usr/share/doc/cxref/FAQ /usr/share/doc/cxref/README
 
 Format: HTML
 Index: /usr/share/doc/cxref/README.html
 Files: /usr/share/doc/cxref/*.html
-
-  
diff -Nru cxref-1.6a.old/debian/po/fi.po cxref-1.6a/debian/po/fi.po
--- cxref-1.6a.old/debian/po/fi.po	1970-01-01 01:00:00.000000000 +0100
+++ cxref-1.6a/debian/po/fi.po	2008-04-30 08:44:10.410125000 +0200
@@ -0,0 +1,50 @@
+msgid ""
+msgstr ""
+"Project-Id-Version: cxref\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2006-11-04 08:55+0100\n"
+"PO-Revision-Date: 2008-04-29 22:43+0200\n"
+"Last-Translator: Esko Arajärvi <edu@iki.fi>\n"
+"Language-Team: Finnish <debian-l10n-finnish@lists.debian.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"X-Poedit-Language: Finnish\n"
+"X-Poedit-Country: FINLAND\n"
+
+#. Type: boolean
+#. Description
+#: ../cxref.templates:1001
+msgid "Automatically configure cxref-cpp?"
+msgstr "Tehdäänkö cxref-cpp:n asetukset automaattisesti?"
+
+#. Type: boolean
+#. Description
+#: ../cxref.templates:1001
+msgid ""
+"cxref-cpp is a cpp-like program used by cxref for better comment processing "
+"and support.  Proper operation of cxref-cpp requires configuration against "
+"the gcc and cpp versions you have installed on your system.  These of course "
+"may change with each upgrade.  This package can attempt to automatically "
+"keep track of your installed gcc and cpp versions and reconfigure cxref-cpp "
+"accordingly, or it can leave such configuration up to you.  In the latter "
+"case, you can run /usr/bin/cxref-cpp-configure as root whenever you wish, "
+"and/or you can edit the file /etc/cxref/cxref-cpp.defines by hand.  In the "
+"former case, the defines file will be automatically updated every time the "
+"cxref package is reconfigured.  In addition, cxref-cpp will detect any gcc "
+"version mismatch at runtime and regenerate a temporary cxref-cpp.defines "
+"file on the fly, warning the user of the situation."
+msgstr ""
+"cxref-cpp on cpp:n kaltainen ohjelma, jota czref käyttää paremman "
+"kommenttien käsittelyn ja tuen takia. Toimiakseen kunnolla cxref-cpp vaatii "
+"järjestelmään asennettujen gcc:n ja cpp:n versioiden mukaisia asetuksia. "
+"Nämä saattavat tietysti muuttua kussakin päivityksessä. Tämä paketti voi "
+"yrittää automaattisesti pitää kirjaa asennetuista gcc:n ja cpp:n versioista "
+"ja tehdä cxref-cpp:n asetukset tarpeen mukaan uudelleen, tai jättää "
+"asetusten teon ylläpitäjälle. Jälkimmäisessä tapauksessa asetukset voidaan "
+"haluttaessa tehdä ajamalla pääkäyttäjänä /usr/bin/cxref-cpp-configure tai "
+"tiedostoa /etc/cxref/cxref-cpp.defines voidaan muokata käsin. Ensimmäisessä "
+"tapauksessa defines-tiedosto päivitetään automaattisesti aina, kun paketin "
+"cxref asetukset tehdään uudelleen. Lisäksi cxref-cpp huomaa gcc:n version "
+"ajonaikaisen vaihtumisen, luo väliaikaisen cxref-cpp.defines-tiedoston "
+"samantien ja varoittaa käyttäjää tilanteesta."
diff -Nru cxref-1.6a.old/debian/po/gl.po cxref-1.6a/debian/po/gl.po
--- cxref-1.6a.old/debian/po/gl.po	1970-01-01 01:00:00.000000000 +0100
+++ cxref-1.6a/debian/po/gl.po	2008-04-18 08:48:39.352395000 +0200
@@ -0,0 +1,52 @@
+# Galician translation of cxref's debconf templates
+# This file is distributed under the same license as the cxref package.
+# Jacobo Tarrio <jtarrio@debian.org>, 2007.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: cxref\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2006-11-04 08:55+0100\n"
+"PO-Revision-Date: 2007-02-28 16:56+0100\n"
+"Last-Translator: Jacobo Tarrio <jtarrio@debian.org>\n"
+"Language-Team: Galician <proxecto@trasno.net>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Type: boolean
+#. Description
+#: ../cxref.templates:1001
+msgid "Automatically configure cxref-cpp?"
+msgstr "¿Configurar automaticamente cxref-cpp?"
+
+#. Type: boolean
+#. Description
+#: ../cxref.templates:1001
+msgid ""
+"cxref-cpp is a cpp-like program used by cxref for better comment processing "
+"and support.  Proper operation of cxref-cpp requires configuration against "
+"the gcc and cpp versions you have installed on your system.  These of course "
+"may change with each upgrade.  This package can attempt to automatically "
+"keep track of your installed gcc and cpp versions and reconfigure cxref-cpp "
+"accordingly, or it can leave such configuration up to you.  In the latter "
+"case, you can run /usr/bin/cxref-cpp-configure as root whenever you wish, "
+"and/or you can edit the file /etc/cxref/cxref-cpp.defines by hand.  In the "
+"former case, the defines file will be automatically updated every time the "
+"cxref package is reconfigured.  In addition, cxref-cpp will detect any gcc "
+"version mismatch at runtime and regenerate a temporary cxref-cpp.defines "
+"file on the fly, warning the user of the situation."
+msgstr ""
+"cxref-cpp é un programa semellante a cpp empregado por cxref para procesar e "
+"soportar mellor os comentarios. O funcionamento correcto de cxref-cpp "
+"precisa de configuración contra as versións de gcc e cpp instaladas no "
+"sistema, que, por suposto, poden cambiar en cada actualización. Este paquete "
+"pode tentar facer un seguemento automático das versións instaladas de gcc e "
+"cpp, e reconfigurar cxref-cpp dun xeito acorde, ou pode deixar toda esa "
+"configuración para vostede. Neste caso, pode executar /usr/bin/cxref-cpp-"
+"configure coma administrador sempre que queira, e/ou pode editar o ficheiro /"
+"etc/cxref/cxref-cpp.defines á man. No outro caso, hase actualizar "
+"automaticamente o ficheiro de definicións cada vez que se reconfigure o "
+"paquete cxref. Ademáis, cxref-cpp ha detectar os cambios de versión de gcc "
+"cada vez que se execute e volver xerar un ficheiro cxref-cpp.defines "
+"temporal no momento, avisando ao usuario da situación."
diff -Nru cxref-1.6a.old/debian/rules cxref-1.6a/debian/rules
--- cxref-1.6a.old/debian/rules	2008-04-18 08:42:55.728396509 +0200
+++ cxref-1.6a/debian/rules	2008-04-18 11:29:58.979327721 +0200
@@ -24,7 +24,7 @@
 	dh_testroot
 	rm -f build-stamp install-stamp
 
-	-$(MAKE) distclean
+	[ ! -f Makefile ] || $(MAKE) distclean
 	-rm -f cxref-inst
 	-rm -f *~ \
 	README.c.sty README.c.src.html README.c.tex README.c.html README.c.rtf README.c.sgml \
diff -Nru cxref-1.6a.old/doc/README.c.html cxref-1.6a/doc/README.c.html
--- cxref-1.6a.old/doc/README.c.html	2008-04-18 08:42:54.828411944 +0200
+++ cxref-1.6a/doc/README.c.html	1970-01-01 01:00:00.000000000 +0100
@@ -1,387 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-
-<!-- This HTML file generated by cxref (version 1.6a). -->
-<!-- cxref program (c) Andrew M. Bishop 1995,96,97,98,99,2000,01,02,03,04. -->
-
-<!--
-Cxref: ../src/cxref -O. -NREADME-TMP -xref -latex -html-src -rtf -sgml README.c
-CPP  : /home/amb/cxref/src/.././cpp/cxref-cpp -cxref-cpp-defines /home/amb/cxref/src/.././cpp/cxref-cpp.defines -C -dD -dI
--->
-
-<HTML>
-
-<HEAD>
-<TITLE>Cross reference for README.c of README-TMP.</TITLE>
-<LINK rel="stylesheet" href="cxref.css" type="text/css">
-</HEAD>
-
-<BODY>
-
-<h1><a name="file" href="README.c.src.html">File README.c</a></h1>
-<b>RCS Header: /home/amb/cxref/doc/RCS/README.c 1.4 1997/05/26 11:23:40 amb Exp </b>
-<p>
-<span class="cxref-file-comment">
-  A comment for the file, RCS header comments are treated specially when first.</span>
-<p>
-
-<hr>
-<h2>Included Files</h2>
-
-<span class="cxref-include-comment"> A #include comment </span>
-<p>
-<ul class="cxref-include">
-  <li class="cxref-include-system"><tt><span class="cxref-include-system">#include &lt;stdio.h&gt;</span></tt>
-</ul>
-<span class="cxref-include-comment"> An alternative #include comment. </span>
-<p>
-<ul class="cxref-include">
-  <li class="cxref-include-system"><tt><span class="cxref-include-system">#include &lt;math.h&gt;</span></tt>
-</ul>
-
-<hr>
-<h2>Preprocessor definitions</h2>
-
-<span class="cxref-define-comment"> A #define comment. </span>
-<p>
-<tt><span class="cxref-define"><a href="README.c.src.html#line17">#define def1</a> 1</span></tt><br>
-<p>
-<span class="cxref-define-comment"> An alternative #define comment. </span>
-<p>
-<tt><span class="cxref-define"><a href="README.c.src.html#line20">#define def2</a> 2</span></tt><br>
-<p>
-<span class="cxref-define-comment">  A #define with args</span>
-<p>
-<tt><span class="cxref-define"><a href="README.c.src.html#line31">#define def3</a>( arg1, arg2 )</span></tt><br>
-<dl compact>
-  <dt><tt><span class="cxref-define">arg1</span></tt>
-  <dd><span class="cxref-define-comment">The first arg</span>
-  <dt><tt><span class="cxref-define">arg2</span></tt>
-  <dd><span class="cxref-define-comment">The second arg</span>
-</dl>
-<p>
-<span class="cxref-define-comment"> An alternative #define with args. </span>
-<p>
-<tt><span class="cxref-define"><a href="README.c.src.html#line36">#define def4</a>( arg1, arg2 )</span></tt><br>
-<dl compact>
-  <dt><tt><span class="cxref-define">arg1</span></tt>
-  <dd><span class="cxref-define-comment"> The first arg  </span>
-  <dt><tt><span class="cxref-define">arg2</span></tt>
-  <dd><span class="cxref-define-comment"> The second arg </span>
-</dl>
-
-<hr>
-<h2><a name="type-type1">Typedef type1</a></h2>
-<span class="cxref-type-comment"> An example typedef comment </span>
-<p>
-<tt><span class="cxref-type"><a href="README.c.src.html#line43">typedef enum {...} type1</a></span></tt><br>
-<table>
-  <tr>
-    <td><tt><span class="cxref-type">enum</span></tt>
-    <td>&nbsp;
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;<tt><span class="cxref-type">{</span></tt>
-    <td>&nbsp;
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-<tt><span class="cxref-type">one;</span></tt>
-    <td><span class="cxref-type-comment"> one value </span>
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-<tt><span class="cxref-type">two;</span></tt>
-    <td><span class="cxref-type-comment"> another value </span>
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;<tt><span class="cxref-type">}</span></tt>
-    <td>&nbsp;
-  </tr>
-</table>
-
-<hr>
-<h2><a name="type-union-bar">Type union bar</a></h2>
-<span class="cxref-type-comment"> Nested structs and unions also work. </span>
-<p>
-<tt><span class="cxref-type"><a href="README.c.src.html#line0">union bar</a></span></tt><br>
-<table>
-  <tr>
-    <td><tt><span class="cxref-type">union bar</span></tt>
-    <td>&nbsp;
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;<tt><span class="cxref-type">{</span></tt>
-    <td>&nbsp;
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-<tt><span class="cxref-type">char a;</span></tt>
-    <td><span class="cxref-type-comment"> Each element </span>
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-<tt><span class="cxref-type">int b;</span></tt>
-    <td><span class="cxref-type-comment"> of a struct </span>
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-<tt><span class="cxref-type">int c;</span></tt>
-    <td><span class="cxref-type-comment"> or a union </span>
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-<tt><span class="cxref-type">long d;</span></tt>
-    <td><span class="cxref-type-comment"> can have a comment </span>
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;<tt><span class="cxref-type">}</span></tt>
-    <td>&nbsp;
-  </tr>
-</table>
-
-<hr>
-<h2><a name="type-type2">Typedef type2</a></h2>
-<span class="cxref-type-comment"> Another example typedef comment,   a type that is a struct. </span>
-<p>
-<tt><span class="cxref-type"><a href="README.c.src.html#line52">typedef struct {...} type2</a></span></tt><br>
-<table>
-  <tr>
-    <td><tt><span class="cxref-type">struct</span></tt>
-    <td>&nbsp;
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;<tt><span class="cxref-type">{</span></tt>
-    <td>&nbsp;
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-<tt><span class="cxref-type">int a;</span></tt>
-    <td><span class="cxref-type-comment"> A variable in a struct. </span>
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-<tt><span class="cxref-type">union bar</span></tt>
-    <td>&nbsp;
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt><span class="cxref-type">{</span></tt>
-    <td>&nbsp;
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-<tt><span class="cxref-type">char a;</span></tt>
-    <td><span class="cxref-type-comment"> Each element </span>
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-<tt><span class="cxref-type">int b;</span></tt>
-    <td><span class="cxref-type-comment"> of a struct </span>
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-<tt><span class="cxref-type">int c;</span></tt>
-    <td><span class="cxref-type-comment"> or a union </span>
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-<tt><span class="cxref-type">long d;</span></tt>
-    <td><span class="cxref-type-comment"> can have a comment </span>
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt><span class="cxref-type">}</span></tt>
-    <td>&nbsp;
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt><span class="cxref-type">e;</span></tt>
-    <td><span class="cxref-type-comment"> Nested structs and unions also work. </span>
-  </tr>
-  <tr>
-    <td>&nbsp;&nbsp;&nbsp;<tt><span class="cxref-type">}</span></tt>
-    <td>&nbsp;
-  </tr>
-</table>
-
-<hr>
-<h2><a name="type-ptype2">Typedef ptype2</a></h2>
-<span class="cxref-type-comment"> Another example typedef comment,   a pointer to a struct type. </span>
-<p>
-<tt><span class="cxref-type"><a href="README.c.src.html#line52">typedef struct {...}* ptype2</a></span></tt><br>
-<table>
-  <tr>
-    <td>See:
-    <td><span class="cxref-reference-local"><a href="#type-type2">Typedef type2</a></span>
-  </tr>
-</table>
-
-<hr>
-<h2><a name="var-var1">Global Variable var1</a></h2>
-<span class="cxref-variable-comment"> A leading comment only. </span>
-<p>
-<tt><span class="cxref-variable"><a href="README.c.src.html#line68">int var1</a></span></tt><br>
-<table>
-  <tr>
-    <td>Visible in:
-    <td>&nbsp;
-    <td><span class="cxref-reference-local"><a href="README.c.html#file">README.c</a></span>
-  </tr>
-  <tr>
-    <td>Used in:
-    <td><span class="cxref-reference-local"><a href="README.c.html#func-function1">function1()</a></span>
-    <td><span class="cxref-reference-local"><a href="README.c.html#func-function1">README.c</a></span>
-  </tr>
-</table>
-
-<hr>
-<h2><a name="var-var2">Global Variable var2</a></h2>
-<span class="cxref-variable-comment"> A leading comment only. </span>
-<p>
-<tt><span class="cxref-variable"><a href="README.c.src.html#line68">int var2</a></span></tt><br>
-<table>
-  <tr>
-    <td>Visible in:
-    <td>&nbsp;
-    <td><span class="cxref-reference-local"><a href="README.c.html#file">README.c</a></span>
-  </tr>
-</table>
-
-<hr>
-<h2><a name="var-var4">Global Variable var4</a></h2>
-<span class="cxref-variable-comment"> A variable for   one thing. </span>
-<p>
-<tt><span class="cxref-variable"><a href="README.c.src.html#line75">int var4</a></span></tt><br>
-<table>
-  <tr>
-    <td>Visible in:
-    <td>&nbsp;
-    <td><span class="cxref-reference-local"><a href="README.c.html#file">README.c</a></span>
-  </tr>
-  <tr>
-    <td>Used in:
-    <td><span class="cxref-reference-local"><a href="README.c.html#func-function1">function1()</a></span>
-    <td><span class="cxref-reference-local"><a href="README.c.html#func-function1">README.c</a></span>
-  </tr>
-</table>
-
-<hr>
-<h2><a name="var-var5">Global Variable var5</a></h2>
-<span class="cxref-variable-comment"> A variable for   a second thing. </span>
-<p>
-<tt><span class="cxref-variable"><a href="README.c.src.html#line76">int var5</a></span></tt><br>
-<table>
-  <tr>
-    <td>Visible in:
-    <td>&nbsp;
-    <td><span class="cxref-reference-local"><a href="README.c.html#file">README.c</a></span>
-  </tr>
-</table>
-
-<hr>
-<h2><a name="var-var6">Global Variable var6</a></h2>
-<span class="cxref-variable-comment"> A variable for   a third thing. </span>
-<p>
-<tt><span class="cxref-variable"><a href="README.c.src.html#line77">int var6</a></span></tt><br>
-<table>
-  <tr>
-    <td>Visible in:
-    <td>&nbsp;
-    <td><span class="cxref-reference-local"><a href="README.c.html#file">README.c</a></span>
-  </tr>
-</table>
-
-<hr>
-<h2>Local Variables</h2>
-
-<b><a name="var-var3">var3</a></b><br>
-<span class="cxref-variable-comment"> A trailing comment only. </span>
-<p>
-<tt><span class="cxref-variable"><a href="README.c.src.html#line71">static int var3</a></span></tt><br>
-<table>
-  <tr>
-    <td>Used in:
-    <td><a href="#func-function1">function1()</a>
-    <td>&nbsp;
-  </tr>
-</table>
-
-<hr>
-<h2><a name="func-function1">Global Function function1()</a></h2>
-<span class="cxref-function-comment">  A function comment (the comments for the args need to be separated by a blank line).</span>
-<p>
-<tt><span class="cxref-function"><a href="README.c.src.html#line99">int function1 ( int arg1, int arg2 )</a></span></tt><br>
-<dl compact>
-  <dt><tt><span class="cxref-function">int function1</span></tt>
-  <dd><span class="cxref-function-comment">The return value.</span>
-  <dt><tt><span class="cxref-function">int arg1</span></tt>
-  <dd><span class="cxref-function-comment">The first argument.</span>
-  <dt><tt><span class="cxref-function">int arg2</span></tt>
-  <dd><span class="cxref-function-comment">The second argument.</span>
-</dl>
-<span class="cxref-function-comment">  Some more comments
-<br>
- This comment is only visible in the HTML output, and can contain HTML markup.
-<br>
- An internal comment in a function that appears as a
-   new paragraph at the end of the comment. </span>
-<p>
-<table>
-  <tr>
-    <td>Calls:
-    <td><span class="cxref-reference-local"><a href="README.c.html#func-function2">function2()</a></span>
-    <td><span class="cxref-reference-local"><a href="README.c.html#func-function2">README.c</a></span>
-  </tr>
-  <tr>
-    <td>Used in:
-    <td><span class="cxref-reference-local"><a href="README.c.html#func-function2">function2()</a></span>
-    <td><span class="cxref-reference-local"><a href="README.c.html#func-function2">README.c</a></span>
-  </tr>
-  <tr>
-    <td>References Variables:
-    <td><span class="cxref-reference-local"><a href="README.c.html#var-var1">var1</a></span>
-    <td><span class="cxref-reference-local"><a href="README.c.html#var-var1">README.c</a></span>
-  </tr>
-  <tr>
-    <td>&nbsp;
-    <td><span class="cxref-reference-local"><a href="README.c.html#var-var3">var3</a></span>
-    <td><span class="cxref-reference-local"><a href="README.c.html#var-var3">README.c</a></span>
-  </tr>
-  <tr>
-    <td>&nbsp;
-    <td><span class="cxref-reference-local"><a href="README.c.html#var-var4">var4</a></span>
-    <td><span class="cxref-reference-local"><a href="README.c.html#var-var4">README.c</a></span>
-  </tr>
-</table>
-
-<hr>
-<h2><a name="func-function2">Global Function function2()</a></h2>
-<span class="cxref-function-comment"> An alternative function comment </span>
-<p>
-<tt><span class="cxref-function"><a href="README.c.src.html#line112">int function2 ( int arg1, int arg2, void )</a></span></tt><br>
-<dl compact>
-  <dt><tt><span class="cxref-function">int function2</span></tt>
-  <dd><span class="cxref-function-comment"> Returns a value </span>
-  <dt><tt><span class="cxref-function">int arg1</span></tt>
-  <dd><span class="cxref-function-comment"> The first argument.  </span>
-  <dt><tt><span class="cxref-function">int arg2</span></tt>
-  <dd><span class="cxref-function-comment"> The second argument. </span>
-  <dt><tt><span class="cxref-function">void</span></tt>
-  <dd><span class="cxref-function-comment">&nbsp;</span>
-</dl>
-<table>
-  <tr>
-    <td>Called by:
-    <td><span class="cxref-reference-local"><a href="README.c.html#func-function1">function1()</a></span>
-    <td><span class="cxref-reference-local"><a href="README.c.html#func-function1">README.c</a></span>
-  </tr>
-  <tr>
-    <td>References Functions:
-    <td><span class="cxref-reference-local"><a href="README.c.html#func-function1">function1()</a></span>
-    <td><span class="cxref-reference-local"><a href="README.c.html#func-function1">README.c</a></span>
-  </tr>
-</table>
-
-</BODY>
-</HTML>
diff -Nru cxref-1.6a.old/doc/README.c.rtf cxref-1.6a/doc/README.c.rtf
--- cxref-1.6a.old/doc/README.c.rtf	2008-04-18 08:42:54.828411944 +0200
+++ cxref-1.6a/doc/README.c.rtf	1970-01-01 01:00:00.000000000 +0100
@@ -1,175 +0,0 @@
-{\rtf\ansi
-\deff0
-{\fonttbl
-{\f0\froman Times New Roman;}
-{\f1\fmodern Courier New;}
-}
-{\stylesheet
-{\s0\f0\fs24 Normal;}
-{\s1\f0\fs40\b\sb400\sa200\keepn\keep Heading 1;}
-{\s2\f0\fs32\b\sb200\sa100\keepn\keep Heading 2;}
-{\s3\f0\fs28\b\sb100\sa100\keepn\keep Heading 3;}
-{\s4\f0\fs24\b\sb100\sa50\keepn\keep Heading 4;}
-{\s5\f1\fs20\ql\sb50\sa50 Code;}
-}
-{\info{\comment
- This RTF file generated by cxref (version 1.6a).
- cxref program (c) Andrew M. Bishop 1995,96,97,98,99,2000,01,02,03,04.
- Cxref: ../src/cxref -O. -NREADME-TMP -xref -latex -html-src -rtf -sgml README.c
- CPP  : /home/amb/cxref/src/.././cpp/cxref-cpp -cxref-cpp-defines /home/amb/cxref/src/.././cpp/cxref-cpp.defines -C -dD -dI
-}}
-\paperw11880\paperh16848\margl1440\margr1440\margt1440\margb1440
-\sectd\plain
-\s0\f0\fs24
-{\s1\f0\fs40\b\sb400\sa200\keepn\keep File README.c\par}
-{\b RCS Header: /home/amb/cxref/doc/RCS/README.c 1.4 1997/05/26 11:23:40 amb Exp}\par
-A comment for the file, RCS header comments are treated specially when first.\par
-{\s2\f0\fs32\b\sb200\sa100\keepn\keep Included Files\par}
-A #include comment\par
-{\s5\f1\fs20\ql\sb50\sa50 #include <stdio.h>\par}
-An alternative #include comment.\par
-{\s5\f1\fs20\ql\sb50\sa50 #include <math.h>\par}
-{\s2\f0\fs32\b\sb200\sa100\keepn\keep Preprocessor definitions\par}
-A #define comment.\par
-{\s5\f1\fs20\ql\sb50\sa50 #define def1 1\par}
-An alternative #define comment.\par
-{\s5\f1\fs20\ql\sb50\sa50 #define def2 2\par}
-A #define with args\par
-{\s5\f1\fs20\ql\sb50\sa50 #define def3( arg1, arg2 )\par}
-{\s5\f1\fs20\ql\sb50\sa50arg1\par}
-{\s6\f0\fs24\ql\li720 The first arg\par}
-{\s5\f1\fs20\ql\sb50\sa50arg2\par}
-{\s6\f0\fs24\ql\li720 The second arg\par}
-An alternative #define with args.\par
-{\s5\f1\fs20\ql\sb50\sa50 #define def4( arg1, arg2 )\par}
-{\s5\f1\fs20\ql\sb50\sa50arg1\par}
-{\s6\f0\fs24\ql\li720 The first arg\par}
-{\s5\f1\fs20\ql\sb50\sa50arg2\par}
-{\s6\f0\fs24\ql\li720 The second arg\par}
-{\s2\f0\fs32\b\sb200\sa100\keepn\keep Type definitions\par}
-{\s3\f0\fs28\b\sb100\sa100\keepn\keep Typedef type1\par}
-An example typedef comment\par
-{\s5\f1\fs20\ql\sb50\sa50 typedef enum \{...\} type1\par}
-\trowd\trgaph120\cellx2880\cellx9000
-\intbl\plain
-{\s5\f1\fs20\ql\sb50\sa50 enum}\cell\cell\row
-{\s5\f1\fs20\ql\sb50\sa50 \{}\cell\cell\row
-	{\s5\f1\fs20\ql\sb50\sa50 one;}\cell one value\cell\row
-	{\s5\f1\fs20\ql\sb50\sa50 two;}\cell another value\cell\row
-{\s5\f1\fs20\ql\sb50\sa50 \}}\cell\cell\row
-\intbl0
-{\s3\f0\fs28\b\sb100\sa100\keepn\keep Type union bar\par}
-Nested structs and unions also work.\par
-\trowd\trgaph120\cellx2880\cellx9000
-\intbl\plain
-{\s5\f1\fs20\ql\sb50\sa50 union bar}\cell\cell\row
-{\s5\f1\fs20\ql\sb50\sa50 \{}\cell\cell\row
-	{\s5\f1\fs20\ql\sb50\sa50 char a;}\cell Each element\cell\row
-	{\s5\f1\fs20\ql\sb50\sa50 int b;}\cell of a struct\cell\row
-	{\s5\f1\fs20\ql\sb50\sa50 int c;}\cell or a union\cell\row
-	{\s5\f1\fs20\ql\sb50\sa50 long d;}\cell can have a comment\cell\row
-{\s5\f1\fs20\ql\sb50\sa50 \}}\cell\cell\row
-\intbl0
-{\s3\f0\fs28\b\sb100\sa100\keepn\keep Typedef type2\par}
-Another example typedef comment, a type that is a struct.\par
-{\s5\f1\fs20\ql\sb50\sa50 typedef struct \{...\} type2\par}
-\trowd\trgaph120\cellx2880\cellx9000
-\intbl\plain
-{\s5\f1\fs20\ql\sb50\sa50 struct}\cell\cell\row
-{\s5\f1\fs20\ql\sb50\sa50 \{}\cell\cell\row
-	{\s5\f1\fs20\ql\sb50\sa50 int a;}\cell A variable in a struct.\cell\row
-	{\s5\f1\fs20\ql\sb50\sa50 union bar}\cell\cell\row
-	{\s5\f1\fs20\ql\sb50\sa50 \{}\cell\cell\row
-		{\s5\f1\fs20\ql\sb50\sa50 char a;}\cell Each element\cell\row
-		{\s5\f1\fs20\ql\sb50\sa50 int b;}\cell of a struct\cell\row
-		{\s5\f1\fs20\ql\sb50\sa50 int c;}\cell or a union\cell\row
-		{\s5\f1\fs20\ql\sb50\sa50 long d;}\cell can have a comment\cell\row
-	{\s5\f1\fs20\ql\sb50\sa50 \}}\cell\cell\row
-	{\s5\f1\fs20\ql\sb50\sa50 e;}\cell Nested structs and unions also work.\par
-{\s5\f1\fs20\ql\sb50\sa50 \}}\cell\cell\row
-\intbl0
-{\s3\f0\fs28\b\sb100\sa100\keepn\keep Typedef ptype2\par}
-Another example typedef comment, a pointer to a struct type.\par
-{\s5\f1\fs20\ql\sb50\sa50 typedef struct \{...\}* ptype2\par}
-See:	Typedef type2\par
-{\s2\f0\fs32\b\sb200\sa100\keepn\keep Variables\par}
-{\s3\f0\fs28\b\sb100\sa100\keepn\keep Variable var1\par}
-A leading comment only.\par
-{\s5\f1\fs20\ql\sb50\sa50 int var1\par}
-\trowd\trgaph120\cellx1440\cellx5220\cellx9000
-\intbl\plain
-Visible in:\cell README.c\cell\cell\row
-Used in:\cell function1()\cell README.c\cell\row
-\intbl0
-{\s3\f0\fs28\b\sb100\sa100\keepn\keep Variable var2\par}
-A leading comment only.\par
-{\s5\f1\fs20\ql\sb50\sa50 int var2\par}
-\trowd\trgaph120\cellx1440\cellx5220\cellx9000
-\intbl\plain
-Visible in:\cell README.c\cell\cell\row
-\intbl0
-{\s3\f0\fs28\b\sb100\sa100\keepn\keep Variable var4\par}
-A variable for one thing.\par
-{\s5\f1\fs20\ql\sb50\sa50 int var4\par}
-\trowd\trgaph120\cellx1440\cellx5220\cellx9000
-\intbl\plain
-Visible in:\cell README.c\cell\cell\row
-Used in:\cell function1()\cell README.c\cell\row
-\intbl0
-{\s3\f0\fs28\b\sb100\sa100\keepn\keep Variable var5\par}
-A variable for a second thing.\par
-{\s5\f1\fs20\ql\sb50\sa50 int var5\par}
-\trowd\trgaph120\cellx1440\cellx5220\cellx9000
-\intbl\plain
-Visible in:\cell README.c\cell\cell\row
-\intbl0
-{\s3\f0\fs28\b\sb100\sa100\keepn\keep Variable var6\par}
-A variable for a third thing.\par
-{\s5\f1\fs20\ql\sb50\sa50 int var6\par}
-\trowd\trgaph120\cellx1440\cellx5220\cellx9000
-\intbl\plain
-Visible in:\cell README.c\cell\cell\row
-\intbl0
-{\s3\f0\fs28\b\sb100\sa100\keepn\keep Local Variables\par}
-{\s4\f0\fs24\b\sb100\sa50\keepn\keep Variable var3\par}
-A trailing comment only.\par
-{\s5\f1\fs20\ql\sb50\sa50 static int var3\par}
-\trowd\trgaph120\cellx1440\cellx5220\cellx9000
-\intbl\plain
-Used in:\cell function1()\cell\cell\row
-\intbl0
-{\s2\f0\fs32\b\sb200\sa100\keepn\keep Functions\par}
-{\s3\f0\fs28\b\sb100\sa100\keepn\keep Global Function function1()\par}
-A function comment (the comments for the args need to be separated by a blank line). Some more comments An internal comment in a function that appears as a new paragraph at the end of the comment.\par
-{\s5\f1\fs20\ql\sb50\sa50 int function1 ( int arg1, int arg2 )\par}
-{\s5\f1\fs20\ql\sb50\sa50 int function1\par}
-{\s6\f0\fs24\ql\li720 The return value.\par}
-{\s5\f1\fs20\ql\sb50\sa50 int arg1\par}
-{\s6\f0\fs24\ql\li720 The first argument.\par}
-{\s5\f1\fs20\ql\sb50\sa50 int arg2\par}
-{\s6\f0\fs24\ql\li720 The second argument.\par}
-\trowd\trgaph120\cellx1440\cellx5220\cellx9000
-\intbl\plain
-Calls: \cell function2()\cell README.c\cell\row
-Used in:\cell function2()\cell README.c\cell\row
-Refs Var:\cell var1\cell README.c\cell\row
-\cell var3\cell README.c\cell\row
-\cell var4\cell README.c\cell\row
-\intbl0
-{\s3\f0\fs28\b\sb100\sa100\keepn\keep Global Function function2()\par}
-An alternative function comment\par
-{\s5\f1\fs20\ql\sb50\sa50 int function2 ( int arg1, int arg2, void )\par}
-{\s5\f1\fs20\ql\sb50\sa50 int function2\par}
-{\s6\f0\fs24\ql\li720 Returns a value\par}
-{\s5\f1\fs20\ql\sb50\sa50 int arg1\par}
-{\s6\f0\fs24\ql\li720 The first argument.\par}
-{\s5\f1\fs20\ql\sb50\sa50 int arg2\par}
-{\s6\f0\fs24\ql\li720 The second argument.\par}
-{\s5\f1\fs20\ql\sb50\sa50 void\par}
-{\s6\f0\fs24\ql\li720 \par}
-\trowd\trgaph120\cellx1440\cellx5220\cellx9000
-\intbl\plain
-Called by:\cell function1()\cell README.c\cell\row
-Refs Func:\cell function1()\cell README.c\cell\row
-\intbl0
-}
diff -Nru cxref-1.6a.old/doc/README.c.sgml cxref-1.6a/doc/README.c.sgml
--- cxref-1.6a.old/doc/README.c.sgml	2008-04-18 08:42:54.828411944 +0200
+++ cxref-1.6a/doc/README.c.sgml	1970-01-01 01:00:00.000000000 +0100
@@ -1,288 +0,0 @@
-<!DOCTYPE LINUXDOC SYSTEM>
-
-<!-- This SGML file generated by cxref (version 1.6a). -->
-<!-- cxref program (c) Andrew M. Bishop 1995,96,97,98,99,2000,01,02,03,04. -->
-
-<!--
-Cxref: ../src/cxref -O. -NREADME-TMP -xref -latex -html-src -rtf -sgml README.c
-CPP  : /home/amb/cxref/src/.././cpp/cxref-cpp -cxref-cpp-defines /home/amb/cxref/src/.././cpp/cxref-cpp.defines -C -dD -dI
--->
-
-<article>
-
-<title>Cross reference for README.c of README-TMP.
-<author>cxref
-
-<sect>File README.c
-<bf>RCS Header: /home/amb/cxref/doc/RCS/README.c 1.4 1997/05/26 11:23:40 amb Exp </bf>
-<p>
-
-  A comment for the file, RCS header comments are treated specially when first.
-<p>
-
-<sect1>Included Files
-
-<p>
- A &num;include comment 
-<p>
-<itemize>
-<item><tt>#include &lt;stdio.h&gt;</tt>
-</itemize>
- An alternative &num;include comment. 
-<p>
-<itemize>
-<item><tt>#include &lt;math.h&gt;</tt>
-</itemize>
-
-<sect1>Preprocessor definitions
-
-<p>
- A &num;define comment. 
-<p>
-<tt>#define def1 1</tt><newline>
-<p>
- An alternative &num;define comment. 
-<p>
-<tt>#define def2 2</tt><newline>
-<p>
-  A &num;define with args
-<p>
-<tt>#define def3( arg1, arg2 )</tt><newline>
-<descrip>
-<tag><tt>arg1</tt></tag>
-The first arg
-<tag><tt>arg2</tt></tag>
-The second arg
-</descrip>
-<p>
- An alternative &num;define with args. 
-<p>
-<tt>#define def4( arg1, arg2 )</tt><newline>
-<descrip>
-<tag><tt>arg1</tt></tag>
- The first arg  
-<tag><tt>arg2</tt></tag>
- The second arg 
-</descrip>
-
-<sect1>Typedef type1
-
-<p>
- An example typedef comment 
-<p>
-<tt>typedef enum {...} type1</tt><newline>
-<itemize>
-<item><tt>enum</tt><newline>
-<itemize>
-<item><tt>{</tt><newline>
-<item><tt>one;      </tt> one value <newline>
-<item><tt>two;      </tt> another value <newline>
-<item><tt>}</tt><newline>
-</itemize>
-</itemize>
-
-<sect1>Type union bar
-
-<p>
- Nested structs and unions also work. 
-<p>
-<itemize>
-<item><tt>union bar</tt><newline>
-<itemize>
-<item><tt>{</tt><newline>
-<item><tt>char a;      </tt> Each element <newline>
-<item><tt>int b;      </tt> of a struct <newline>
-<item><tt>int c;      </tt> or a union <newline>
-<item><tt>long d;      </tt> can have a comment <newline>
-<item><tt>}</tt><newline>
-</itemize>
-</itemize>
-
-<sect1>Typedef type2
-
-<p>
- Another example typedef comment,   a type that is a struct. 
-<p>
-<tt>typedef struct {...} type2</tt><newline>
-<itemize>
-<item><tt>struct</tt><newline>
-<itemize>
-<item><tt>{</tt><newline>
-<item><tt>int a;      </tt> A variable in a struct. <newline>
-<item><tt>union bar</tt><newline>
-<itemize>
-<item><tt>{</tt><newline>
-<item><tt>char a;      </tt> Each element <newline>
-<item><tt>int b;      </tt> of a struct <newline>
-<item><tt>int c;      </tt> or a union <newline>
-<item><tt>long d;      </tt> can have a comment <newline>
-<item><tt>}</tt><newline>
-</itemize>
-<item><tt>e;      </tt> Nested structs and unions also work. <newline>
-<item><tt>}</tt><newline>
-</itemize>
-</itemize>
-
-<sect1>Typedef ptype2
-
-<p>
- Another example typedef comment,   a pointer to a struct type. 
-<p>
-<tt>typedef struct {...}* ptype2</tt><newline>
-<descrip>
-<tag>See:</tag>
-<itemize>
-<item>Typedef type2
-</itemize>
-</descrip>
-
-<sect1>Global Variable var1
-
-<p>
- A leading comment only. 
-<p>
-<tt>int var1</tt><newline>
-<descrip>
-<tag>Visible in:</tag>
-<itemize>
-<item>README.c
-</itemize>
-<tag>Used in:</tag>
-<itemize>
-<item>function1()  :  README.c
-</itemize>
-</descrip>
-
-<sect1>Global Variable var2
-
-<p>
- A leading comment only. 
-<p>
-<tt>int var2</tt><newline>
-<descrip>
-<tag>Visible in:</tag>
-<itemize>
-<item>README.c
-</itemize>
-</descrip>
-
-<sect1>Global Variable var4
-
-<p>
- A variable for   one thing. 
-<p>
-<tt>int var4</tt><newline>
-<descrip>
-<tag>Visible in:</tag>
-<itemize>
-<item>README.c
-</itemize>
-<tag>Used in:</tag>
-<itemize>
-<item>function1()  :  README.c
-</itemize>
-</descrip>
-
-<sect1>Global Variable var5
-
-<p>
- A variable for   a second thing. 
-<p>
-<tt>int var5</tt><newline>
-<descrip>
-<tag>Visible in:</tag>
-<itemize>
-<item>README.c
-</itemize>
-</descrip>
-
-<sect1>Global Variable var6
-
-<p>
- A variable for   a third thing. 
-<p>
-<tt>int var6</tt><newline>
-<descrip>
-<tag>Visible in:</tag>
-<itemize>
-<item>README.c
-</itemize>
-</descrip>
-
-<sect1>Local Variables
-
-<p>
-<bf>var3</bf><newline>
- A trailing comment only. 
-<p>
-<tt>static int var3</tt><newline>
-<descrip>
-<tag>Used in:</tag>
-<itemize>
-<item>function1()
-</itemize>
-</descrip>
-
-<sect1>Global Function function1()
-
-<p>  A function comment (the comments for the args need to be separated by a blank line).
-<p>
-<tt>int function1 ( int arg1, int arg2 )</tt><newline>
-<descrip>
-<tag><tt>int function1</tt></tag>
-The return value.
-<tag><tt>int arg1</tt></tag>
-The first argument.
-<tag><tt>int arg2</tt></tag>
-The second argument.
-</descrip>
-  Some more comments
-<newline>
-<newline>
- An internal comment in a function that appears as a
-   new paragraph at the end of the comment. 
-<p>
-<descrip>
-<tag>Calls:</tag>
-<itemize>
-<item>function2()  :  README.c
-</itemize>
-<tag>Used in:</tag>
-<itemize>
-<item>function2()  :  README.c
-</itemize>
-<tag>References Variables:</tag>
-<itemize>
-<item>var1  :  README.c
-<item>var3  :  README.c
-<item>var4  :  README.c
-</itemize>
-</descrip>
-
-<sect1>Global Function function2()
-
-<p> An alternative function comment 
-<p>
-<tt>int function2 ( int arg1, int arg2, void )</tt><newline>
-<descrip>
-<tag><tt>int function2</tt></tag>
- Returns a value 
-<tag><tt>int arg1</tt></tag>
- The first argument.  
-<tag><tt>int arg2</tt></tag>
- The second argument. 
-<tag><tt>void</tt></tag>
-&nbsp;
-</descrip>
-<descrip>
-<tag>Called by:</tag>
-<itemize>
-<item>function1()  :  README.c
-</itemize>
-<tag>References Functions:</tag>
-<itemize>
-<item>function1()  :  README.c
-</itemize>
-</descrip>
-
-</article>
diff -Nru cxref-1.6a.old/doc/README.c.src.html cxref-1.6a/doc/README.c.src.html
--- cxref-1.6a.old/doc/README.c.src.html	2008-04-18 08:42:54.832397287 +0200
+++ cxref-1.6a/doc/README.c.src.html	1970-01-01 01:00:00.000000000 +0100
@@ -1,143 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-
-<!-- This HTML file generated by cxref (version 1.6a). -->
-<!-- cxref program (c) Andrew M. Bishop 1995,96,97,98,99,2000,01,02,03,04. -->
-
-<!--
-Cxref: ../src/cxref -O. -NREADME-TMP -xref -latex -html-src -rtf -sgml README.c
-CPP  : /home/amb/cxref/src/.././cpp/cxref-cpp -cxref-cpp-defines /home/amb/cxref/src/.././cpp/cxref-cpp.defines -C -dD -dI
--->
-
-<HTML>
-
-<HEAD>
-<TITLE>Source File README.c</TITLE>
-<LINK rel="stylesheet" href="cxref.css" type="text/css">
-</HEAD>
-
-<BODY>
-
-<pre>
-<a name="line1">1    |</a> /*****************
-<a name="line2">2    |</a>   $Header: /home/amb/cxref/doc/RCS/README.c 1.4 1997/05/26 11:23:40 amb Exp $
-<a name="line3">3    |</a> 
-<a name="line4">4    |</a>   A comment for the file, RCS header comments are treated specially when first.
-<a name="line5">5    |</a>   *****************/
-<a name="line6">6    |</a> 
-<a name="line7">7    |</a> 
-<a name="line8">8    |</a> 
-<a name="line9">9    |</a> /*+ A #include comment +*/
-<a name="line10">10   |</a> #include &lt;stdio.h&gt;
-<a name="line11">11   |</a> 
-<a name="line12">12   |</a> 
-<a name="line13">13   |</a> #include &lt;math.h&gt;  /*+ An alternative #include comment. +*/
-<a name="line14">14   |</a> 
-<a name="line15">15   |</a> 
-<a name="line16">16   |</a> /*+ A #define comment. +*/
-<a name="line17">17   |</a> #define def1 1
-<a name="line18">18   |</a> 
-<a name="line19">19   |</a> 
-<a name="line20">20   |</a> #define def2 2  /*+ An alternative #define comment. +*/
-<a name="line21">21   |</a> 
-<a name="line22">22   |</a> 
-<a name="line23">23   |</a> /*+++++++++++
-<a name="line24">24   |</a>   A #define with args
-<a name="line25">25   |</a> 
-<a name="line26">26   |</a>   arg1 The first arg
-<a name="line27">27   |</a> 
-<a name="line28">28   |</a>   arg2 The second arg
-<a name="line29">29   |</a>   +++++++++++*/
-<a name="line30">30   |</a> 
-<a name="line31">31   |</a> #define def3(arg1,arg2) (arg1+arg2)
-<a name="line32">32   |</a> 
-<a name="line33">33   |</a> 
-<a name="line34">34   |</a> /*+ An alternative #define with args. +*/
-<a name="line35">35   |</a> 
-<a name="line36">36   |</a> #define def4(arg1 /*+ The first arg  +*/, \
-<a name="line37">37   |</a>              arg2 /*+ The second arg +*/) \
-<a name="line38">38   |</a>            (arg1+arg2)
-<a name="line39">39   |</a> 
-<a name="line40">40   |</a> 
-<a name="line41">41   |</a> /*+ An example typedef comment +*/
-<a name="line42">42   |</a> typedef enum
-<a name="line43">43   |</a> {
-<a name="line44">44   |</a>  one,            /*+ one value +*/
-<a name="line45">45   |</a>  two             /*+ another value +*/
-<a name="line46">46   |</a> }
-<a name="line47">47   |</a> type1;
-<a name="line48">48   |</a> 
-<a name="line49">49   |</a> 
-<a name="line50">50   |</a> /*+ Another example typedef comment, +*/
-<a name="line51">51   |</a> typedef struct
-<a name="line52">52   |</a> {
-<a name="line53">53   |</a>  int a;         /*+ A variable in a struct. +*/
-<a name="line54">54   |</a>  union bar
-<a name="line55">55   |</a>   {
-<a name="line56">56   |</a>    char a;      /*+ Each element +*/
-<a name="line57">57   |</a>    int  b,      /*+ of a struct +*/
-<a name="line58">58   |</a>         c;      /*+ or a union +*/
-<a name="line59">59   |</a>    long d;      /*+ can have a comment +*/
-<a name="line60">60   |</a>   }
-<a name="line61">61   |</a>  e;             /*+ Nested structs and unions also work. +*/
-<a name="line62">62   |</a> }
-<a name="line63">63   |</a> type2,          /*+ a type that is a struct. +*/
-<a name="line64">64   |</a> *ptype2;        /*+ a pointer to a struct type. +*/
-<a name="line65">65   |</a> 
-<a name="line66">66   |</a> 
-<a name="line67">67   |</a> /*+ A leading comment only. +*/
-<a name="line68">68   |</a> int var1,var2;
-<a name="line69">69   |</a> 
-<a name="line70">70   |</a> 
-<a name="line71">71   |</a> static int var3; /*+ A trailing comment only. +*/
-<a name="line72">72   |</a> 
-<a name="line73">73   |</a> 
-<a name="line74">74   |</a> /*+ A variable for +*/
-<a name="line75">75   |</a> int var4,    /*+ one thing. +*/
-<a name="line76">76   |</a>     var5,    /*+ a second thing. +*/
-<a name="line77">77   |</a>     var6;    /*+ a third thing. +*/
-<a name="line78">78   |</a> 
-<a name="line79">79   |</a> /* Note: The leading comment is combined with each of the trailing comments. */
-<a name="line80">80   |</a> /* Note: the push through of the comment above on the ',' and ';', see README. */
-<a name="line81">81   |</a> 
-<a name="line82">82   |</a> 
-<a name="line83">83   |</a> /*+++++++++++
-<a name="line84">84   |</a>   A function comment (the comments for the args need to be separated by a blank line).
-<a name="line85">85   |</a> 
-<a name="line86">86   |</a>   int function1 The return value.
-<a name="line87">87   |</a> 
-<a name="line88">88   |</a>   int arg1 The first argument.
-<a name="line89">89   |</a> 
-<a name="line90">90   |</a>   int arg2 The second argument.
-<a name="line91">91   |</a> 
-<a name="line92">92   |</a>   Some more comments
-<a name="line93">93   |</a> 
-<a name="line94">94   |</a>   +none+  Note: this line and the two below are processed specially.
-<a name="line95">95   |</a>   +html+  This comment is only visible in the HTML output, and can contain HTML markup.
-<a name="line96">96   |</a>   +latex+ This comment is only visible in the \LaTeX output, and can contain \LaTeX markup.
-<a name="line97">97   |</a>   +++++++++++*/
-<a name="line98">98   |</a> 
-<a name="line99">99   |</a> int function1(int arg1,int arg2)
-<a name="line100">100  |</a> {
-<a name="line101">101  |</a>  /*+ An internal comment in a function that appears as a
-<a name="line102">102  |</a>    new paragraph at the end of the comment. +*/
-<a name="line103">103  |</a> 
-<a name="line104">104  |</a>  var1=0;
-<a name="line105">105  |</a> 
-<a name="line106">106  |</a>  function2(var3,var4);
-<a name="line107">107  |</a> }
-<a name="line108">108  |</a> 
-<a name="line109">109  |</a> 
-<a name="line110">110  |</a> /*+ An alternative function comment +*/
-<a name="line111">111  |</a> 
-<a name="line112">112  |</a> int function2(int arg1,  /*+ The first argument.  +*/
-<a name="line113">113  |</a>               int arg2)  /*+ The second argument. +*/
-<a name="line114">114  |</a> /*+ Returns a value +*/
-<a name="line115">115  |</a> {
-<a name="line116">116  |</a>  int (*funcp)()=&amp;function1;
-<a name="line117">117  |</a> }
-<a name="line118">118  |</a> 
-<a name="line119">119  |</a> /* Note: the push through of the comment above on the ',' and ')', see README. */
-</pre>
-
-</BODY>
-</HTML>
Binary files cxref-1.6a.old/doc/README.dvi and cxref-1.6a/doc/README.dvi differ
diff -Nru cxref-1.6a.old/doc/README.ps cxref-1.6a/doc/README.ps
--- cxref-1.6a.old/doc/README.ps	2008-04-18 08:42:54.832397287 +0200
+++ cxref-1.6a/doc/README.ps	1970-01-01 01:00:00.000000000 +0100
@@ -1,847 +0,0 @@
-%!PS-Adobe-2.0
-%%Creator: dvips(k) 5.92b Copyright 2002 Radical Eye Software
-%%Title: README.dvi
-%%Pages: 13
-%%PageOrder: Ascend
-%%BoundingBox: 0 0 596 842
-%%DocumentFonts: CMBX12 CMR10 CMR7 CMTT10 CMTI10 CMSY10 CMBX10 CMTT9
-%%+ CMSY9 CMSL10 CMTI9
-%%EndComments
-%DVIPSWebPage: (www.radicaleye.com)
-%DVIPSCommandLine: dvips README.dvi -o README.ps
-%DVIPSParameters: dpi=600, compressed
-%DVIPSSource:  TeX output 2004.11.23:1906
-%%BeginProcSet: texc.pro
-%!
-/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
-N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72
-mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0
-0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{
-landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize
-mul 0}ifelse TR}if Resolution VResolution vsize -72 div 1 add mul TR[
-matrix currentmatrix{A A round sub abs 0.00001 lt{round}if}forall round
-exch round exch]setmatrix}N/@landscape{/isls true N}B/@manualfeed{
-statusdict/manualfeed true put}B/@copies{/#copies X}B/FMat[1 0 0 -1 0 0]
-N/FBB[0 0 0 0]N/nn 0 N/IEn 0 N/ctr 0 N/df-tail{/nn 8 dict N nn begin
-/FontType 3 N/FontMatrix fntrx N/FontBBox FBB N string/base X array
-/BitMaps X/BuildChar{CharBuilder}N/Encoding IEn N end A{/foo setfont}2
-array copy cvx N load 0 nn put/ctr 0 N[}B/sf 0 N/df{/sf 1 N/fntrx FMat N
-df-tail}B/dfs{div/sf X/fntrx[sf 0 0 sf neg 0 0]N df-tail}B/E{pop nn A
-definefont setfont}B/Cw{Cd A length 5 sub get}B/Ch{Cd A length 4 sub get
-}B/Cx{128 Cd A length 3 sub get sub}B/Cy{Cd A length 2 sub get 127 sub}
-B/Cdx{Cd A length 1 sub get}B/Ci{Cd A type/stringtype ne{ctr get/ctr ctr
-1 add N}if}B/id 0 N/rw 0 N/rc 0 N/gp 0 N/cp 0 N/G 0 N/CharBuilder{save 3
-1 roll S A/base get 2 index get S/BitMaps get S get/Cd X pop/ctr 0 N Cdx
-0 Cx Cy Ch sub Cx Cw add Cy setcachedevice Cw Ch true[1 0 0 -1 -.1 Cx
-sub Cy .1 sub]/id Ci N/rw Cw 7 add 8 idiv string N/rc 0 N/gp 0 N/cp 0 N{
-rc 0 ne{rc 1 sub/rc X rw}{G}ifelse}imagemask restore}B/G{{id gp get/gp
-gp 1 add N A 18 mod S 18 idiv pl S get exec}loop}B/adv{cp add/cp X}B
-/chg{rw cp id gp 4 index getinterval putinterval A gp add/gp X adv}B/nd{
-/cp 0 N rw exit}B/lsh{rw cp 2 copy get A 0 eq{pop 1}{A 255 eq{pop 254}{
-A A add 255 and S 1 and or}ifelse}ifelse put 1 adv}B/rsh{rw cp 2 copy
-get A 0 eq{pop 128}{A 255 eq{pop 127}{A 2 idiv S 128 and or}ifelse}
-ifelse put 1 adv}B/clr{rw cp 2 index string putinterval adv}B/set{rw cp
-fillstr 0 4 index getinterval putinterval adv}B/fillstr 18 string 0 1 17
-{2 copy 255 put pop}for N/pl[{adv 1 chg}{adv 1 chg nd}{1 add chg}{1 add
-chg nd}{adv lsh}{adv lsh nd}{adv rsh}{adv rsh nd}{1 add adv}{/rc X nd}{
-1 add set}{1 add clr}{adv 2 chg}{adv 2 chg nd}{pop nd}]A{bind pop}
-forall N/D{/cc X A type/stringtype ne{]}if nn/base get cc ctr put nn
-/BitMaps get S ctr S sf 1 ne{A A length 1 sub A 2 index S get sf div put
-}if put/ctr ctr 1 add N}B/I{cc 1 add D}B/bop{userdict/bop-hook known{
-bop-hook}if/SI save N @rigin 0 0 moveto/V matrix currentmatrix A 1 get A
-mul exch 0 get A mul add .99 lt{/QV}{/RV}ifelse load def pop pop}N/eop{
-SI restore userdict/eop-hook known{eop-hook}if showpage}N/@start{
-userdict/start-hook known{start-hook}if pop/VResolution X/Resolution X
-1000 div/DVImag X/IEn 256 array N 2 string 0 1 255{IEn S A 360 add 36 4
-index cvrs cvn put}for pop 65781.76 div/vsize X 65781.76 div/hsize X}N
-/p{show}N/RMat[1 0 0 -1 0 0]N/BDot 260 string N/Rx 0 N/Ry 0 N/V{}B/RV/v{
-/Ry X/Rx X V}B statusdict begin/product where{pop false[(Display)(NeXT)
-(LaserWriter 16/600)]{A length product length le{A length product exch 0
-exch getinterval eq{pop true exit}if}{pop}ifelse}forall}{false}ifelse
-end{{gsave TR -.1 .1 TR 1 1 scale Rx Ry false RMat{BDot}imagemask
-grestore}}{{gsave TR -.1 .1 TR Rx Ry scale 1 1 false RMat{BDot}
-imagemask grestore}}ifelse B/QV{gsave newpath transform round exch round
-exch itransform moveto Rx 0 rlineto 0 Ry neg rlineto Rx neg 0 rlineto
-fill grestore}B/a{moveto}B/delta 0 N/tail{A/delta X 0 rmoveto}B/M{S p
-delta add tail}B/b{S p tail}B/c{-4 M}B/d{-3 M}B/e{-2 M}B/f{-1 M}B/g{0 M}
-B/h{1 M}B/i{2 M}B/j{3 M}B/k{4 M}B/w{0 rmoveto}B/l{p -4 w}B/m{p -3 w}B/n{
-p -2 w}B/o{p -1 w}B/q{p 1 w}B/r{p 2 w}B/s{p 3 w}B/t{p 4 w}B/x{0 S
-rmoveto}B/y{3 2 roll p a}B/bos{/SS save N}B/eos{SS restore}B end
-
-%%EndProcSet
-%%BeginProcSet: texps.pro
-%!
-TeXDict begin/rf{findfont dup length 1 add dict begin{1 index/FID ne 2
-index/UniqueID ne and{def}{pop pop}ifelse}forall[1 index 0 6 -1 roll
-exec 0 exch 5 -1 roll VResolution Resolution div mul neg 0 0]FontType 0
-ne{/Metrics exch def dict begin Encoding{exch dup type/integertype ne{
-pop pop 1 sub dup 0 le{pop}{[}ifelse}{FontMatrix 0 get div Metrics 0 get
-div def}ifelse}forall Metrics/Metrics currentdict end def}{{1 index type
-/nametype eq{exit}if exch pop}loop}ifelse[2 index currentdict end
-definefont 3 -1 roll makefont/setfont cvx]cvx def}def/ObliqueSlant{dup
-sin S cos div neg}B/SlantFont{4 index mul add}def/ExtendFont{3 -1 roll
-mul exch}def/ReEncodeFont{CharStrings rcheck{/Encoding false def dup[
-exch{dup CharStrings exch known not{pop/.notdef/Encoding true def}if}
-forall Encoding{]exch pop}{cleartomark}ifelse}if/Encoding exch def}def
-end
-
-%%EndProcSet
-%%BeginFont: CMTI9
-%%EndFont 
-%%BeginFont: CMSL10
-%%EndFont 
-%%BeginFont: CMSY9
-%%EndFont 
-%%BeginFont: CMTT9
-%%EndFont 
-%%BeginFont: CMBX12
-%%EndFont 
-%%BeginFont: CMBX10
-%%EndFont 
-%%BeginFont: CMSY10
-%%EndFont 
-%%BeginFont: CMTI10
-%%EndFont 
-%%BeginFont: CMTT10
-%%EndFont 
-%%BeginFont: CMR7
-%%EndFont 
-%%BeginFont: CMR10
-%%EndFont 
-TeXDict begin 39158280 55380996 1000 600 600 (README.dvi)
-@start /Fa 139[25 4[39 43 4[24 3[35 1[35 15[43 28[39
-2[39 39 39 2[24 4[31 31 40[{}14 74.7198 /CMTI9 rf /Fb
-139[32 33 3[42 46 1[23 2[23 3[37 1[37 16[61 4[76 6[54
-57 63 60 1[62 18[23 46[{}16 83.022 /CMSL10 rf /Fc 152[38
-38 102[{}2 74.7198 /CMSY9 rf /Fd 134[39 1[39 39 39 39
-39 39 1[39 39 39 39 39 2[39 39 39 39 39 39 39 39 39 34[39
-1[39 39 4[39 39 39 39 39 39 2[39 1[39 1[39 39 39 4[39
-35[{}36 74.7198 /CMTT9 rf /Fe 134[59 3[62 44 44 46 1[62
-56 62 1[31 2[31 3[51 62 50 62 54 10[85 1[78 3[77 6[42
-2[70 18[56 56 56 2[31 33[62 12[{}25 99.6264 /CMBX12 rf
-/Ff 134[50 50 1[50 53 37 38 39 1[53 48 53 80 27 2[27
-53 48 29 44 53 42 53 46 4[50 5[72 1[66 53 72 2[72 1[91
-57 3[75 75 60 63 73 69 1[72 6[27 48 1[48 48 48 48 48
-48 48 48 48 27 32 3[37 37 1[74 3[50 34[{}53 83.022 /CMBX10
-rf /Fg 240[42 13[23 1[{}2 83.022 /CMSY10 rf /Fh 131[85
-2[40 39 55 38 45 28 34 35 1[42 42 47 68 21 38 1[25 42
-38 25 38 42 38 1[42 3[25 43 25 3[83 2[59 5[62 7[54 1[63
-59 8[25 11[25 30 25 64 42 34 34 5[43 25 20[47 51 11[{}44
-83.022 /CMTI10 rf /Fi 130[44 1[44 1[44 44 44 44 44 44
-44 44 1[44 44 44 44 44 44 1[44 44 44 44 44 44 44 44 44
-3[44 44 44 2[44 2[44 44 44 44 1[44 44 44 44 44 2[44 44
-2[44 44 44 1[44 2[44 44 44 44 44 44 1[44 44 44 44 44
-44 44 44 44 44 44 44 44 44 44 44 44 44 1[44 44 44 34[{}71
-83.022 /CMTT10 rf /Fj 134[71 71 2[75 52 53 55 1[75 67
-75 112 37 2[37 75 67 41 61 75 60 1[65 8[102 3[94 75 100
-1[92 101 1[128 81 2[50 105 106 85 88 103 97 1[102 7[67
-67 67 67 67 67 67 67 67 67 1[37 45 32[75 12[{}48 119.552
-/CMBX12 rf /Fk 190[49 65[{}1 58.1154 /CMR7 rf /Fl 132[42
-1[44 44 60 44 46 32 33 33 44 46 42 46 69 23 44 25 23
-46 42 25 37 46 37 46 42 23 2[23 42 23 1[62 62 85 62 62
-60 46 61 65 57 65 62 76 52 2[30 62 65 54 57 63 60 59
-62 65 4[23 23 42 42 42 42 42 42 42 42 42 42 42 23 28
-23 65 42 32 32 23 3[69 42 20[46 46 48 11[{}80 83.022
-/CMR10 rf /Fm 135[123 2[129 90 92 95 1[129 116 129 194
-65 2[65 1[116 71 106 1[103 1[113 4[120 5[175 3[173 2[175
-1[220 6[146 153 178 168 1[175 10[116 4[116 2[65 77 6[181
-3[120 34[{}32 206.559 /CMBX12 rf /Fn 139[75 1[79 1[108
-7[108 2[88 3[94 29[140 15[97 97 97 49[{}10 172.188 /CMBX12
-rf end
-%%EndProlog
-%%BeginSetup
-%%Feature: *Resolution 600dpi
-TeXDict begin
-%%PaperSize: A4
- end
-%%EndSetup
-%%Page: 1 1
-TeXDict begin 1 0 bop 0 664 a Fn(Chapter)65 b(1)0 1038
-y Fm(C)71 b(Cross)f(Referencing)i(&)e(Do)6 b(cumen)-6
-b(ting)0 1245 y(to)6 b(ol.)104 b(V)-19 b(ersion)77 b(1.6)g(-)h(cxref)0
-1677 y Fl(A)28 b(program)d(that)j(can)g(automatically)e(generate)g(do)r
-(cumen)n(tation)i(and)f(cross)f(references)h(for)g(a)g(C)h(program.)0
-1777 y(The)22 b(input)h(is)f(an)n(y)g(C)g(program)e(with)j(appropriate)
-d(commen)n(ts)i(and)g(the)g(output)h(is)f(L)2691 1760
-y Fk(A)2728 1777 y Fl(T)2774 1795 y(E)2820 1777 y(X,)h(HTML,)g(R)-7
-b(TF)22 b(or)g(SGML)0 1876 y(\014les.)0 2117 y Fj(1.1)135
-b(Program)46 b(Options)0 2299 y Fl(The)28 b(name)f(of)h(the)g(program)d
-(is)j(cxref.)0 2418 y(Usage:)36 b Fi(cxref)493 2517 y(filename)k([)j
-(...)86 b(filename])493 2617 y([-Odirname])39 b([-Nbasename])f
-([-Rdirname])493 2717 y([-all-comments])f([-no-comments])493
-2816 y([-verbatim-comme)o(nt)o(s])g([-block-comments])493
-2916 y([-xref[-all][-fi)o(le)o(][-)o(fu)o(nc)o(][-)o(va)o(r][)o(-t)o
-(ype)o(]])493 3016 y([-warn[-all][-co)o(mm)o(ent)o(][)o(-x)o(ref)o(]])
-493 3115 y([-index[-all][-f)o(il)o(e][)o(-f)o(un)o(c][)o(-v)o(ar])o([-)
-o(typ)o(e])o(])493 3215 y([-raw])493 3314 y([-latex])493
-3414 y([-html[-src]])493 3514 y([-rtf])493 3613 y([-sgml])493
-3713 y([-Idirname])i([-Ddefine])g([-Udefine])493 3813
-y([-CPP)i(cpp)p 891 3813 27 4 v 30 w(program])g([--)h(cpp)p
-1620 3813 V 30 w(arg)h([)g(...)86 b(cpp)p 2262 3813 V
-30 w(arg]])0 3920 y Fl(Usage:)36 b Fi(cxref)493 4020
-y(filename)k([)j(...)86 b(filename])40 b(-delete)493
-4120 y([-Odirname])f([-Nbasename])f([-Rdirname])210 4297
-y(filename)g Fl(The)28 b(name)f(of)h(the)g(\014le)f(to)h(do)r(cumen)n
-(t,)g(an)n(y)f(n)n(um)n(b)r(er)g(of)g(\014les)h(ma)n(y)f(b)r(e)h(do)r
-(cumen)n(ted)g(at)f(a)g(time.)253 4462 y Fi(-delete)39
-b Fl(The)c(\014les)f(named)g(are)g(to)g(b)r(e)h(deleted)g(from)f(the)h
-(output)g(directory)e(and)i(their)f(en)n(tries)g(in)h(the)600
-4561 y(cross)26 b(reference)h(database)f(and)i(main)f(output)h(\014les)
-g(are)e(to)i(b)r(e)g(remo)n(v)n(ed.)166 4727 y Fi(-Odirname)38
-b Fl(The)30 b(name)g(of)g(a)g(directory)f(to)h(use)f(for)h(the)h
-(output)f(L)2343 4710 y Fk(A)2380 4727 y Fl(T)2426 4744
-y(E)2472 4727 y(X\014les)g(and)g(the)h(lo)r(cation)e(of)h(the)h(cross)
-600 4826 y(reference)c(\014les)g(that)h(are)f(created.)123
-4991 y Fi(-Nbasename)37 b Fl(The)23 b(name)g(to)g(use)g(for)f(the)h
-(\014rst)g(part)g(of)g(the)g(output)g(and)g(cross)f(reference)g
-(\014les)h(instead)f(of)h(cxref,)600 5091 y(the)28 b(\014le)g
-(extensions)f(remain)g(the)h(same.)166 5256 y Fi(-Rdirname)38
-b Fl(When)32 b(the)f(source)f(\014les)h(are)f(in)h(more)g(than)g(one)g
-(directory)-7 b(,)31 b(set)g(dirname)f(to)h(the)h(name)f(of)g(the)600
-5356 y(ro)r(ot)i(directory)f(of)i(the)g(source)f(tree)g(\(use)h
-(relativ)n(e)f(path)g(if)i(easier)d(e.g.)55 b(\\-R../.."\).)f(This)34
-b(will)600 5456 y(then)c(run)f(cxref)h(from)f(that)h(ro)r(ot)e
-(directory)h(and)g(the)h(\\-Odirname")d(m)n(ust)j(b)r(e)g(relativ)n(e)e
-(to)i(that)600 5555 y(directory)-7 b(.)-8 5720 y Fi(-all-comments)36
-b Fl(In)27 b(case)f(y)n(ou)g(think)h(that)h(the)f(existing)f(commen)n
-(ts)h(migh)n(t)g(w)n(ork,)e(\(see)i(b)r(elo)n(w)f(for)h(description)f
-(of)600 5820 y(sp)r(ecial)h(commen)n(ts\).)37 b Fh([Danger!)i(This)31
-b(option)g(c)l(an)f(pr)l(o)l(duc)l(e)g(weir)l(d)h(r)l(esults.])1854
-5970 y Fl(1)p eop end
-%%Page: 2 2
-TeXDict begin 2 1 bop 3708 -150 a Fl(2)35 83 y Fi(-no-comments)37
-b Fl(Ignores)23 b(all)i(commen)n(ts,)g(useful)g(if)g(y)n(ou)f(just)h(w)
-n(an)n(t)g(the)g(cross)e(references)h(and)g(not)h(the)g(do)r(cumen-)600
-183 y(tation.)-226 349 y Fi(-verbatim-commen)o(ts)35
-b Fl(When)29 b(the)f(commen)n(ts)g(that)h(y)n(ou)e(ha)n(v)n(e)h(in)g
-(the)h(co)r(de)f(are)f(formatted)h(in)h(a)e(predetermined)h(st)n(yle)
-600 448 y(that)33 b(y)n(ou)f(w)n(an)n(t)g(to)h(preserv)n(e)d(on)j(the)g
-(output,)i(this)e(option)f(will)h(force)f(them)h(not)g(to)f(b)r(e)i
-(refor-)600 548 y(matted.)j Fh([Note,)31 b(this)f(is)g(for)h(\014le)e
-(and)i(function)e(c)l(omments)h(only.])-95 714 y Fi(-block-comments)35
-b Fl(When)28 b(the)f(commen)n(ts)g(in)g(the)h(program)d(are)h
-(formatted)h(in)g(the)h(\\blo)r(c)n(k")d(st)n(yle)i(\(with)h(a)f
-(leading)600 814 y(\\*")32 b(c)n(haracter)g(on)h(ev)n(ery)f(line\),)k
-(this)d(option)h(will)f(remo)n(v)n(e)f(that)i(c)n(haracter)d(from)j
-(the)f(output.)600 913 y Fh([Works)e(for)f(a)g(single)h(\\*",)f(\\+",)f
-(\\|")g(or)h(\\:")38 b(on)30 b(e)l(ach)h(line.])341 1079
-y Fi(-xref)39 b Fl(Pro)r(duce)27 b(cross)f(referencing)g(information)h
-(\(see)h(b)r(elo)n(w\).)984 1245 y Fi(-all)40 b Fl(All)28
-b(cross)e(references.)941 1378 y Fi(-file)39 b Fl(Cross)26
-b(references)h(for)g(\014les.)941 1511 y Fi(-func)39
-b Fl(Cross)26 b(references)h(for)g(functions.)984 1644
-y Fi(-var)40 b Fl(Cross)26 b(references)h(for)g(v)-5
-b(ariables.)941 1777 y Fi(-type)39 b Fl(Cross)26 b(references)h(for)g
-(t)n(yp)r(es.)341 1943 y Fi(-warn)39 b Fl(Pro)r(duce)27
-b(w)n(arnings,)f(the)i(options)f(m)n(ust)g(b)r(e)h(concatenated)f
-(together:)984 2109 y Fi(-all)40 b Fl(All)28 b(w)n(arnings.)810
-2242 y Fi(-comment)38 b Fl(W)-7 b(arn)27 b(of)h(missing)f(commen)n(ts.)
-941 2374 y Fi(-xref)39 b Fl(W)-7 b(arn)27 b(of)h(missing)f(cross)f
-(references.)297 2540 y Fi(-index)39 b Fl(Pro)r(duce)27
-b(a)g(cross)f(reference)h(index,)g(the)h(options)f(m)n(ust)h(b)r(e)g
-(concatenated)f(together:)984 2707 y Fi(-all)40 b Fl(All)28
-b(indexes.)941 2839 y Fi(-file)39 b Fl(Index)28 b(of)f(\014les.)941
-2972 y Fi(-func)39 b Fl(Index)28 b(of)f(functions.)984
-3105 y Fi(-var)40 b Fl(Index)28 b(of)f(v)-5 b(ariables.)941
-3238 y Fi(-type)39 b Fl(Index)28 b(of)f(t)n(yp)r(es.)384
-3404 y Fi(-raw)40 b Fl(Pro)r(duce)27 b(a)g(ra)n(w)f(form)h(of)h
-(output,)g(not)g(really)e(of)i(m)n(uc)n(h)f(use)h(except)f(with)h(-w)n
-(arn.)297 3570 y Fi(-latex)39 b Fl(Pro)r(duce)31 b(a)h(LaT)-7
-b(eX)32 b(\014le)g(to)g(do)r(cumen)n(t)h(eac)n(h)e(of)h(the)h(source)e
-(\014les)h(and)g(also)f(an)h(extra)f(\014le)i(that)600
-3670 y(includes)28 b(eac)n(h)f(of)g(these)h(\014les.)341
-3836 y Fi(-html)39 b Fl(Pro)r(duce)d(an)g(HTML)h(4.01)f(\014le)g(to)h
-(do)r(cumen)n(t)g(eac)n(h)f(of)h(the)g(source)e(\014les)i(and)f(a)h
-(main)f(\014le)h(to)600 3935 y(reference)27 b(eac)n(h)f(of)i(these)g
-(\014les.)166 4101 y Fi(-html-src)38 b Fl(Pro)r(duce)27
-b(the)h(HTML)f(output)i(and)e(an)g(HTML)h(v)n(ersion)e(of)i(the)g
-(source)e(\014le)i(with)g(links)f(in)n(to)h(it.)384 4267
-y Fi(-rtf)40 b Fl(Pro)r(duce)27 b(a)g(Ric)n(h)g(T)-7
-b(ext)28 b(F)-7 b(ormat)27 b(\(R)-7 b(TF\))29 b(\014le)e(to)h(do)r
-(cumen)n(t)g(the)g(source)e(\014le.)341 4433 y Fi(-sgml)39
-b Fl(Pro)r(duce)27 b(an)g(SGML)h(\014le)g(to)f(do)r(cumen)n(t)h(the)g
-(source)e(\014le.)37 b(\(Using)28 b(the)g(Lin)n(uxDo)r(c)f(DTD\).)166
-4599 y Fi(-Idirname)38 b Fl(GCC)28 b(option)f(to)h(sp)r(ecify)f(the)h
-(path)g(for)f(include)h(\014les.)210 4765 y Fi(-Ddefine)38
-b Fl(GCC)28 b(option)f(to)h(de\014ne)f(a)h(pre-pro)r(cessor)c(sym)n(b)r
-(ol.)210 4932 y Fi(-Udefine)38 b Fl(GCC)28 b(option)f(to)h(unde\014ne)g
-(a)f(pre-pro)r(cessor)d(sym)n(b)r(ol.)35 5098 y Fi(-CPP)42
-b(program)d Fl(The)23 b(name)g(of)g(the)g(program)e(to)i(use)f(instead)
-h(of)g(the)g(compile)g(time)g(default.)36 b(The)23 b(program)e(m)n(ust)
-600 5197 y(b)r(e)26 b(able)e(to)i(p)r(erform)e(all)h(of)g(the)h
-(actions)e(that)i(\\gcc)e(-E)g(-C)h(-dD")g(do)r(es)g(to)g(w)n(ork.)35
-b(If)26 b(the)f(program)600 5297 y(tak)n(es)i(argumen)n(ts)f(then)i
-(the)g(whole)f(thing)h(needs)g(to)f(b)r(e)h(in)g(quotes)f(so)g(that)h
-(it)g(is)g(in)n(terpreted)f(as)600 5396 y(a)g(single)g(argumen)n(t)g
-(to)g(cxref.)-95 5562 y Fi(--)42 b(arg)h(...)86 b(arg)40
-b Fl(Extra)20 b(argumen)n(ts)f(to)i(b)r(e)g(passed)f(to)h(the)h
-(pre-pro)r(cessor)17 b(can)k(b)r(e)g(placed)g(after)g(the)g(\\{")e
-(separator.)p eop end
-%%Page: 3 3
-TeXDict begin 3 2 bop 3708 -150 a Fl(3)0 83 y Fj(1.2)135
-b(C)45 b(Compiler)h(Replacemen)l(t)h(cxref-cc)0 265 y
-Fl(T)-7 b(o)28 b(simplify)h(using)f(cxref)g(on)g(existing)g(source)f
-(co)r(de,)h(there)g(is)h(no)n(w)e(a)h(shell)g(script)h(that)f(will)h
-(call)f(the)g(C)h(compiler)0 364 y(and)g(then)g(call)g(cxref)f(to)h
-(pro)r(cess)f(the)h(source)f(\014le.)41 b(This)29 b(means)g(that)g(it)h
-(can)e(b)r(e)i(used)e(as)h(a)f(drop)h(in)g(replacemen)n(t)0
-464 y(for)e(CC)h(in)g(Mak)n(e\014les)e(and)h(the)h(lik)n(e.)0
-564 y(Usage:)36 b(cxref-cc)27 b([usual)g(cc)g(options])0
-663 y(The)37 b(name)g(of)h(the)f(source)f(\014le)i(is)f(extracted)g
-(from)g(the)g(list)h(of)f(options)g(as)g(w)n(ell)g(as)f(the)i(\\-D*",)g
-(\\-I*",)h(\\-U*")0 763 y(\015ags)33 b(and)i(when)g(the)f(C)h(compiler)
-f(exits)g(succesfully)h(cxref)f(will)g(b)r(e)h(called.)58
-b(The)34 b(name)g(of)h(the)g(C)f(compiler)g(to)0 863
-y(use)27 b(is)h(con)n(trolled)e(b)n(y)h(the)h(CXREF)n(CC)f(en)n
-(vironmen)n(t)g(v)-5 b(ariable,)26 b(or)h(if)h(this)f(is)h(not)f(set)h
-(then)g(the)g(CC)f(en)n(vironmen)n(t)0 962 y(v)-5 b(ariable,)27
-b(or)f(failing)i(this)g(just)g(gcc.)0 1062 y(Using)36
-b(this)g(script)g(requires)f(the)i(use)f(of)g(a)f(`.cxref)6
-b(')37 b(con\014guration)d(\014le)j(to)f(con)n(tain)f(the)i(options)e
-(since)h(there)g(is)0 1162 y(no)n(where)26 b(to)i(put)g(the)g(options)f
-(on)g(the)h(command)g(line)f(for)g(the)h(C)g(compiler.)0
-1261 y(This)36 b(will)g(only)g(cross-reference)d(and)j(do)r(cumen)n(t)g
-(the)h(C)f(source)e(\014les)i(since)g(they)g(are)f(the)i(only)e(ones)h
-(that)g(are)0 1361 y(compiled,)28 b(but)g(it)g(will)g(mak)n(e)e(sure)h
-(that)h(they)g(are)f(cross-referenced)e(with)j(the)g(correct)e(options)
-h(etc.)0 1602 y Fj(1.3)135 b(Cxref)46 b(con\014guration)f(File)0
-1784 y Fl(These)30 b(command)f(line)i(argumen)n(ts)e(can)g(also)g(b)r
-(e)i(put)f(in)n(to)g(a)g(\014le)g(named)g(\\.cxref)6
-b(")29 b(instead)h(of)g(on)g(the)g(command)0 1884 y(line.)37
-b(When)28 b(cxref)f(is)h(run)f(the)h(argumen)n(ts)f(to)g(the)h(program)
-e(are)g(in)n(terpreted)h(in)h(the)g(follo)n(wing)f(order.)101
-2066 y(1.)42 b(Those)26 b(on)i(the)g(command)f(line.)101
-2232 y(2.)42 b(Those)26 b(in)i(the)g(\\.cxref)6 b(")27
-b(\014le)h(in)g(the)g(curren)n(t)e(directory)-7 b(.)101
-2398 y(3.)42 b(Those)26 b(in)i(the)g(\\.cxref)6 b(")27
-b(\014le)h(in)g(the)g(source)e(tree)h(ro)r(ot)g(sp)r(eci\014ed)h(b)n(y)
-f(\\-R".)0 2581 y(This)h(means)g(that)h(in)g(a)f(m)n(ulti-directory)f
-(source)h(tree,)g(eac)n(h)g(sub-directory)e(can)j(ha)n(v)n(e)e(a)h
-(\\.cxref)6 b(")27 b(\014le)i(con)n(taining)0 2681 y(just)24
-b(the)h(line)f(\\-R..")34 b(or)23 b(appropriate.)34 b(The)24
-b(main)f(directory)g(can)g(ha)n(v)n(e)g(a)g(\\.cxref)6
-b(")23 b(\014le)h(con)n(taining)f(the)h(remainder)0 2780
-y(of)k(the)g(options.)37 b(This)28 b(remo)n(v)n(es)e(completely)h(the)i
-(need)f(to)f(ha)n(v)n(e)g(an)n(y)g(options)g(on)h(the)g(command)f(line)
-i(apart)d(from)0 2880 y(the)i(source)e(\014le)i(names.)0
-2979 y(The)c(format)g(of)g(the)h(.cxref)f(\014le)g(is)g(an)n(y)g(n)n
-(um)n(b)r(er)g(of)g(lines,)h(eac)n(h)e(one)h(con)n(taining)f(a)h
-(single)g(command)g(line)g(argumen)n(t)0 3079 y(\(equiv)-5
-b(alen)n(t)36 b(to)f(one)g(of)h(the)g(argv\).)59 b(The)35
-b(only)h(options)f(that)g(cannot)g(b)r(e)h(used)g(are)e(the)i(names)f
-(of)h(source)e(\014les)0 3179 y(themselv)n(es)23 b(and)g(the)h
-(\\-delete")f(option.)35 b(Blank)23 b(lines)g(are)g(ignored)f(and)i
-(lines)f(starting)g(with)h(a)f(`#')h(are)e(commen)n(ts.)0
-3420 y Fj(1.4)135 b(Program)46 b(Do)t(cumen)l(tation)g(Commen)l(ts)0
-3602 y Fl(The)38 b(do)r(cumen)n(tation)f(for)g(the)h(program)e(is)h
-(pro)r(duced)h(from)f(commen)n(ts)g(in)h(the)g(co)r(de)f(that)h(are)f
-(appropriately)0 3702 y(formatted.)g(The)27 b(cross)f(referencing)h
-(comes)g(from)g(the)h(co)r(de)f(itself)i(and)e(requires)f(no)i(extra)e
-(w)n(ork.)0 3801 y(The)j(sp)r(ecial)f(commen)n(ts)h(are)f(\\/****)e
-(****/")f(\(for)k(a)f(\014le\))i(and)e(\\/*++++)e(++++*/")g(\(for)i(a)h
-(data)f(ob)5 b(ject\))29 b(an)n(y)0 3901 y(n)n(um)n(b)r(er)36
-b(of)f(\\*")g(or)g(\\+")f(can)h(b)r(e)i(used)e(inside)h(of)g(the)g
-(standard)f(\\/*")f(and)h(\\*/")f(commen)n(t)i(delimiters)g(in)g(the)0
-4000 y(commen)n(ts,)27 b(they)h(are)f(ignored.)0 4100
-y(If)c(a)g(commen)n(t)g(line)g(starts)g(with)g(whitespace)g(and)g(is)g
-(follo)n(w)n(ed)f(b)n(y)g(`+h)n(tml+')h(then)h(the)f(rest)g(of)g(the)g
-(line)h(is)f(included)0 4200 y(only)30 b(in)h(the)g(HTML)h(output,)g
-(and)e(is)h(not)g(pro)r(cessed)e(so)h(it)h(can)g(include)g(HTML)g
-(markup,)g(`-h)n(tml-')g(means)f(that)0 4299 y(the)23
-b(rest)g(of)f(the)i(line)f(is)g(included)g(in)g(all)g(except)g(the)g
-(HTML)g(output.)36 b(The)23 b(same)f(also)g(applies)g(to)h(the)g(other)
-g(output)0 4399 y(formats,)28 b(`+none+')f(can)h(b)r(e)g(used)h(for)e
-(lines)h(not)h(to)f(app)r(ear)f(in)i(an)n(y)e(output.)39
-b(The)29 b(exception)e(to)i(this)f(is)g(that)h(the)0
-4499 y(ra)n(w)d(output)i(do)r(es)g(not)f(do)h(an)n(y)e(c)n(hec)n(king)h
-(and)g(will)h(output)g(all)g(lines.)0 4598 y(In)38 b(an)n(y)f
-(situation)g(where)h(a)f(commen)n(t)h(follo)n(ws)e(a)i(\\,",)h(\\;")j
-(or)37 b(\\\)")g(separated)g(only)g(b)n(y)g(spaces)g(and)h(tabs,)i(the)
-0 4698 y(commen)n(t)27 b(is)h(pushed)g(to)f(b)r(efore)h(the)g
-(punctuation)f(to)h(apply)f(to)h(the)g(ob)5 b(ject)27
-b(there.)0 4797 y(The)21 b(program)e(is)i(implemen)n(ted)h(using)f(a)f
-(full)i(ANSI)g(C)f(grammar)e(parser)h(with)i(some)e(GCC)h(extensions,)h
-(this)g(means)0 4897 y(that)28 b(the)g(st)n(yle)f(of)h(the)g(co)r(de)f
-(is)g(unimp)r(ortan)n(t,)h(only)f(the)h(con)n(ten)n(t)f(and)h(commen)n
-(ts.)0 5138 y Fj(1.5)135 b(Automated)46 b(Commen)l(t)g(Insertion)0
-5320 y Fl(T)-7 b(o)30 b(simplify)i(the)f(insertion)f(of)h(commen)n(ts)f
-(that)h(will)g(b)r(e)g(parsed)f(b)n(y)g(cxref,)h(the)g(\014le)g
-(cxref.el)g(pro)n(vides)e(a)h(n)n(um)n(b)r(er)0 5420
-y(of)i(Emacs)e(lisp)i(functions.)49 b(T)-7 b(o)31 b(use)h(them)g(add)f
-(the)h(line)g Fi(\(load)42 b("cxref"\))28 b Fl(to)k(y)n(our)e
-(\\.emacs")g(\014le)i(or)e(t)n(yp)r(e)i Fi(M-x)0 5519
-y(load-file)40 b(cxref.el)24 b Fl(from)j(within)i(Emacs.)0
-5619 y(The)f(functions)g(and)f(k)n(ey)g(bindings)g(are:)p
-eop end
-%%Page: 4 4
-TeXDict begin 4 3 bop 3708 -150 a Fl(4)-5 83 y Fh(Contr)l(ol-C)30
-b(Contr)l(ol-F)42 b Fl(Adds)25 b(\014le)f(commen)n(ts,)h(a)f(/**)f(**/)
-g(header)h(at)g(the)h(top)g(of)f(the)h(\014le)g(and)f(if)h(it)g(is)f(a)
-g(.h)h(\014le)g(then)780 183 y(it)35 b(also)f(adds)g(a)g(#ifndef,)k
-(#de\014ne)d(at)g(the)g(b)r(eginning)g(and)f(#endif)i(at)f(the)g(end)g
-(to)f(stop)780 282 y(m)n(ultiple)28 b(inclusions.)324
-448 y Fh(Contr)l(ol-C)i(f)42 b Fl(Adds)28 b(commen)n(ts)f(to)h(a)f
-(function,)h(the)h(cursor)d(m)n(ust)h(b)r(e)i(on)e(the)h(line)g(con)n
-(taining)f(the)h(start)780 548 y(of)h(the)h(function)f(de\014nition)h
-(when)f(this)h(function)f(is)g(called.)42 b(The)29 b(/*+)f(...)41
-b(+*/)28 b(commen)n(t)780 648 y(that)g(is)f(added)h(is)f(of)h(the)g
-(header)f(t)n(yp)r(e)g(\(see)h(the)g(examples\))f(not)h(inline.)311
-814 y Fh(Contr)l(ol-C)i(v)42 b Fl(Adds)28 b(a)f(leading)g(commen)n(t)h
-(to)f(the)h(v)-5 b(ariable)27 b(or)f(other)h(de\014nition)h(on)g(the)g
-(curren)n(t)e(line.)311 980 y Fh(Contr)l(ol-C)k(e)42
-b Fl(Adds)28 b(a)f(trailing)g(commen)n(t)g(at)h(the)g(end)g(of)f(the)h
-(line.)324 1146 y Fh(Contr)l(ol-C)i(i)42 b Fl(Adds)28
-b(an)f(inline)h(commen)n(t)g(that)g(is)f(ignored)f(b)n(y)i(cxref.)0
-1387 y Fj(1.6)135 b(C)45 b(Prepro)t(cessor)0 1569 y Fl(T)-7
-b(o)27 b(impro)n(v)n(e)g(the)h(output)g(that)g(is)g(a)n(v)-5
-b(ailable)26 b(a)h(mo)r(di\014ed)h(v)n(ersion)f(of)g(the)h(GNU)h(CPP)e
-(V2.7.2)f(is)i(supplied)g(\(named)0 1669 y(cxref-cpp\).)0
-1768 y(This)g(mo)r(di\014ed)g(C)f(prepro)r(cessor)e(allo)n(ws)i(for)g
-(a)g(\014ner)g(con)n(trol)g(o)n(v)n(er)f(some)h(features)g(of)g(the)h
-(prepro)r(cessing)e(that)i(are)0 1868 y(not)j(imp)r(ortan)n(t)g(for)f
-(a)h(compiler.)46 b(In)31 b(a)f(standard)g(prepro)r(cessor,)g(the)h
-(prepro)r(cessor)d(directiv)n(es)i(are)g(in)n(tended)i(for)0
-1967 y(use)27 b(only)h(b)n(y)f(the)h(prepro)r(cessor,)d(so)i(passing)f
-(the)i(information)f(through)g(is)h(not)f(imp)r(ortan)n(t.)0
-2067 y(With)h(cxref-cpp,)g(there)f(are)g(t)n(w)n(o)f(features)h(that)h
-(are)f(di\013eren)n(t)h(to)f(the)h(standard)f(GNU)h(CPP:)101
-2250 y(1.)42 b(The)28 b(#include)g(directiv)n(es)f(from)h(the)h(\014le)
-f(are)f(output)i(in)f(the)g(same)g(w)n(a)n(y)f(as)g(the)h(#de\014nes)h
-(are)e(output.)39 b(An)208 2349 y(extra)29 b(\015ag)g(has)h(b)r(een)g
-(added)g(to)g(cpp)h(to)f(do)f(this,)j('-dI',)e(it)g(w)n(orks)f(in)h
-(the)h(same)e(w)n(a)n(y)g(as)g(the)i(existing)f('-dD')208
-2449 y(\015ag)c(for)h(#de\014nes.)101 2615 y(2.)42 b(Commen)n(ts)28
-b(trailing)f(a)h(#include)h(or)f(a)g(#de\014ne)h(are)e(dropp)r(ed)h
-(with)h(GNU)g(CPP)f(ev)n(en)g(if)g(-C)h(is)f(used.)39
-b(This)208 2715 y(is)27 b(not)h(imp)r(ortan)n(t)f(while)h(compiling)f
-(but)h(is)g(useful)g(for)f(do)r(cumen)n(ting.)0 2956
-y Fj(1.7)135 b(Cross)46 b(Referencing)0 3138 y Fl(The)28
-b(cross)e(referencing)g(is)i(p)r(erformed)f(for)g(the)h(follo)n(wing)e
-(items)389 3304 y(Files)141 b Fg(\017)41 b Fl(The)27
-b(\014les)h(that)g(the)g(curren)n(t)e(\014le)i(is)g(included)g(in)g
-(\(ev)n(en)f(when)h(included)g(via)f(other)g(\014les\).)198
-3470 y(#includes)142 b Fg(\017)41 b Fl(Files)27 b(included)h(in)g(the)g
-(curren)n(t)f(\014le.)700 3603 y Fg(\017)41 b Fl(Files)27
-b(included)h(b)n(y)g(these)f(\014les)h(etc.)226 3769
-y(V)-7 b(ariables)140 b Fg(\017)41 b Fl(The)27 b(lo)r(cation)g(of)h
-(the)g(de\014nition)g(of)f(external)g(v)-5 b(ariables.)700
-3902 y Fg(\017)41 b Fl(The)27 b(\014les)h(that)g(ha)n(v)n(e)e
-(visibilit)n(y)i(of)f(global)g(v)-5 b(ariables.)700 4034
-y Fg(\017)41 b Fl(The)27 b(\014les)h(/)f(functions)h(that)g(use)f(the)h
-(v)-5 b(ariable.)206 4200 y(F)e(unctions)142 b Fg(\017)41
-b Fl(The)27 b(\014le)h(that)g(the)g(function)g(is)g(protot)n(yp)r(ed)e
-(in.)700 4333 y Fg(\017)41 b Fl(The)27 b(functions)h(that)g(the)g
-(function)g(calls.)700 4466 y Fg(\017)41 b Fl(The)27
-b(functions)h(that)g(call)f(the)h(function.)700 4599
-y Fg(\017)41 b Fl(The)27 b(\014les)h(and)f(functions)h(that)g
-(reference)f(the)h(function.)700 4732 y Fg(\017)41 b
-Fl(The)27 b(v)-5 b(ariables)27 b(that)g(are)g(used)h(in)g(the)g
-(function.)0 4898 y(Eac)n(h)e(of)i(these)g(items)f(is)h(cross)e
-(referenced)h(in)h(the)g(output.)0 4997 y(The)e(cross)f(referencing)h
-(uses)g(\014les)g(`cxref.v)-5 b(ariable',)25 b(`cxref.function',)i
-(`cxref.include')g(and)f(`cxref.t)n(yp)r(edef)6 b(')27
-b(in)g(the)0 5097 y(output)h(directory)-7 b(.)0 5197
-y(These)21 b(are)g(a)g(complete)h(list)g(of)f(the)h(function)g(and)g(v)
--5 b(ariable)20 b(usage)h(in)h(the)g(program)d(and)j(could)f(b)r(e)h
-(used)g(to)f(generate)0 5296 y(a)27 b(function)h(call)g(hierarc)n(h)n
-(y)d(or)i(v)-5 b(ariable)26 b(usage)h(diagram)f(for)h(example.)0
-5396 y(Tw)n(o)f(cxref)g(passes)g(of)g(eac)n(h)g(\014le)h(is)f(needed,)h
-(the)g(\014rst)g(to)f(build)h(up)g(the)g(cross)f(referencing)f(\014les)
-i(and)f(the)h(second)f(to)0 5496 y(use)h(them.)0 5595
-y Fh(\(The)k(\014le)e(names)h(ar)l(e)g(di\013er)l(ent)g(if)h(the)f
-(\\-N")e(option)j(is)f(use)l(d.\))p eop end
-%%Page: 5 5
-TeXDict begin 5 4 bop 3708 -150 a Fl(5)0 83 y Fj(1.8)135
-b(L)339 58 y Ff(A)391 83 y Fj(T)463 110 y(E)533 83 y(XOutput)0
-265 y Fl(The)26 b(default)h(L)469 248 y Fk(A)506 265
-y Fl(T)552 283 y(E)598 265 y(Xoutput)f(is)g(a)g(\014le)g(for)g(eac)n(h)
-f(of)h(the)h(source)e(\014les)h(with)h(one)e(extra)g(\014le)i
-(\\cxref.tex")e(that)h(includes)0 364 y(eac)n(h)39 b(of)h(the)g(other)f
-(\014les.)73 b(This)40 b(is)f(to)h(allo)n(w)f(a)g(mak)n(e\014le)g(to)g
-(only)h(up)r(date)g(the)g(c)n(hanged)f(\014les)g(\(although)h(the)0
-464 y(references)33 b(ma)n(y)g(require)g(all)g(of)h(the)g(\014les)g(to)
-g(b)r(e)g(c)n(hec)n(k)n(ed)f(again\).)55 b(When)34 b(the)h(cxref.tex)e
-(\014le)h(has)g(b)r(een)g(written)0 564 y(it)f(can)f(b)r(e)i(mo)r
-(di\014ed)f(b)n(y)f(the)h(user,)h(an)n(y)e(new)g(\014les)h(that)g(are)f
-(added)g(are)g(added)g(at)h(the)g(end)g(of)g(the)g(source)e(co)r(de)0
-663 y(section,)c(the)h(rest)f(of)h(the)g(\014le)g(b)r(eing)f(unc)n
-(hanged.)0 763 y(The)h(index)f(is)h(written)g(to)f(a)g(\014le)h(called)
-f(\\cxref.ap)r(dx.tex")f(and)i(cxref.tex)f(is)h(up)r(dated)g(to)f
-(refer)g(to)h(it.)0 863 y(Also)23 b(written)h(out)g(are)f(three)g(L)979
-846 y Fk(A)1016 863 y Fl(T)1062 880 y(E)1108 863 y(Xst)n(yle)h(\014les)
-g(\\page.st)n(y",)e(\\fon)n(ts.st)n(y")g(and)i(\\cxref.st)n(y".)33
-b(These)24 b(set)g(up)g(the)g(page)0 962 y(to)32 b(use)f(a)h(smaller)f
-(margin)f(and)i(smaller)f(fon)n(ts)h(to)f(allo)n(w)g(more)g(to)h(app)r
-(ear)f(on)g(a)g(page)g(and)h(also)f(de\014ne)h(the)g(new)0
-1062 y(commands)27 b(for)g(t)n(yp)r(esetting)h(the)g(cxref)f(output.)0
-1162 y Fh(\(The)k(\014le)e(names)h(\\cxr)l(ef.tex")f(and)i(\\cxr)l
-(ef.ap)l(dx.tex")f(ar)l(e)g(di\013er)l(ent)g(if)g(the)g(\\-N")f(option)
-h(is)g(use)l(d.\))0 1403 y Fj(1.9)135 b(HTML)44 b(Output)0
-1585 y Fl(The)37 b(default)h(HTML)f(output)h(is)f(a)g(\014le)g(for)g
-(eac)n(h)f(of)h(the)h(source)e(\014les)h(with)g(one)g(extra)f(\014le)i
-(\\cxref.h)n(tml")e(that)0 1684 y(includes)24 b(eac)n(h)e(of)i(the)f
-(other)g(\014les.)36 b(This)23 b(is)g(to)h(allo)n(w)e(a)h(mak)n
-(e\014le)g(to)g(only)g(up)r(date)h(the)g(c)n(hanged)e(\014les)i
-(\(although)f(the)0 1784 y(references)30 b(ma)n(y)g(require)g(all)h(of)
-g(the)g(\014les)g(to)g(b)r(e)g(c)n(hec)n(k)n(ed)f(again\).)46
-b(When)32 b(the)f(cxref.h)n(tml)g(\014le)g(has)f(b)r(een)i(written)0
-1884 y(it)h(can)e(b)r(e)i(mo)r(di\014ed)g(b)n(y)e(the)i(user,)g(an)n(y)
-e(new)h(\014les)h(that)f(are)f(added)h(are)f(added)h(at)h(the)f(end)h
-(b)r(efore)e(the)i(table)f(of)0 1983 y(con)n(ten)n(ts,)27
-b(the)h(rest)f(of)h(the)g(\014le)f(b)r(eing)h(unc)n(hanged.)0
-2083 y(The)g(index)f(is)h(written)g(to)f(a)g(\014le)h(called)f
-(\\cxref.ap)r(dx.h)n(tml")g(and)g(cxref.h)n(tml)h(is)f(up)r(dated)i(to)
-e(refer)g(to)g(it.)0 2182 y Fh(\(The)k(\014le)e(names)h(\\cxr)l
-(ef.html")g(and)g(\\cxr)l(ef.ap)l(dx.html")h(ar)l(e)f(di\013er)l(ent)g
-(if)h(the)f(\\-N")e(option)j(is)f(use)l(d.\))0 2282 y
-Fl(The)e(HTML)g(output)g(uses)f(the)h(HTML)g(4.01)e(standard)h(and)g
-(all)g(pages)g(v)-5 b(alidate)27 b(correctly)-7 b(.)0
-2523 y Fj(1.10)136 b(R)-11 b(TF)44 b(Output)0 2705 y
-Fl(Ric)n(h)19 b(T)-7 b(ext)20 b(F)-7 b(ormat)18 b(is)h(a)g(fairly)g(lo)
-n(w)f(lev)n(el)h(page)f(description)h(format)g(devised)g(b)n(y)g
-(Microsoft.)33 b(It)20 b(is)f(not)g(a)g(w)n(ell)g(de\014ned)0
-2805 y(and)27 b(easy)g(to)h(understand)f(standard)f(as)h(are)g(the)h
-(other)f(formats,)g(but)h(it)g(is)g(p)r(opular)e(for)i(do)r(cumen)n(t)f
-(exc)n(hange.)0 2905 y(There)g(is)h(a)f(single)g(output)h(\014le)g(for)
-f(eac)n(h)g(of)g(the)h(source)e(\014les)i(and)f(an)h(index)f(\014le.)0
-3146 y Fj(1.11)136 b(SGML)43 b(Output)0 3328 y Fl(Since)38
-b(SGML)f(is)h(a)f(meta-language)e(it)j(is)f(necessary)f(to)h(de\014ne)h
-(the)g(la)n(y)n(out)e(elemen)n(ts)i(as)e(w)n(ell)i(as)e(pro)n(vide)h
-(the)0 3427 y(information.)56 b(The)34 b(cxref)g(output)h(uses)f(the)g
-(Lin)n(uxDo)r(c)g(do)r(cumen)n(t)h(format)e(and)h(is)g(designed)g(for)g
-(use)g(with)h(the)0 3527 y(SGMLto)r(ols)27 b(programs)f(\(h)n
-(ttp://www.sgmlto)r(ols.org/\).)0 3627 y(There)h(is)h(a)f(single)g
-(output)h(\014le)g(for)f(eac)n(h)g(of)g(the)h(source)e(\014les)i(and)f
-(an)h(index)f(\014le.)0 3868 y Fj(1.12)136 b(Example)46
-b(Sp)t(ecial)f(Commen)l(ts)0 4050 y Fl(The)31 b(\014le)f(\\README.c")g
-(is)g(included)h(at)f(the)h(end)g(of)f(this)h(do)r(cumen)n(t)g(to)f
-(sho)n(w)g(that)g(the)h(commen)n(ts)f(are)g(indeed)0
-4149 y(seen)d(in)h(the)g(co)r(de,)g(the)g(result)f(of)h(running)f(this)
-h(through)f(cxref)g(is)g(also)g(included.)0 4391 y Fj(1.13)136
-b(F)-11 b(urther)44 b(Information)0 4573 y Fl(There)27
-b(is)h(a)f(list)h(of)g(frequen)n(tly)f(ask)n(ed)g(questions)g(and)h
-(their)f(answ)n(ers)f(for)i(the)g(cxref)f(program)f(in)i(the)g(F)-9
-b(A)n(Q)27 b(\014le.)38 b(A)0 4672 y(list)28 b(of)f(impro)n(v)n(emen)n
-(ts)f(planned)i(for)f(future)h(v)n(ersions)e(of)i(the)g(program)d(are)i
-(listed)h(in)f(the)h(\014le)g(TODO.)0 4772 y(More)e(up-to-date)h
-(information)g(can)g(b)r(e)h(found)f(on)h(the)f(W)-7
-b(orld)27 b(Wide)h(W)-7 b(eb)28 b(at)f(the)h(cxref)f(homepage,)f(reac)n
-(hed)h(via)0 4871 y(the)h(author's)f(homepage)f(h)n(ttp://www.gedank)n
-(en.demon.co.uk/.)0 4971 y(If)46 b(y)n(ou)e(wish)h(to)g(submit)h(bug)f
-(rep)r(orts)f(or)g(other)h(commen)n(ts)f(ab)r(out)h(the)h(program)d
-(then)j(email)e(the)i(author)0 5071 y(am)n(b@gedank)n(en.demon.co.uk)25
-b(and)i(put)h(cxref)g(in)g(the)f(sub)5 b(ject)28 b(line.)0
-5312 y Fj(1.14)136 b(Author)44 b(and)h(Cop)l(yrigh)l(t)0
-5494 y Fl(The)28 b(cxref)f(program)e(w)n(as)i(written)h(b)n(y)f(Andrew)
-h(M.)f(Bishop)h(in)f(1995-2004.)0 5593 y(The)h(cxref)f(program)e(is)j
-(cop)n(yrigh)n(t)e(Andrew)h(M.)h(Bishop)f(1995-2004.)0
-5693 y(The)h(cxref-cpp)f(program)e(is)j(cop)n(yrigh)n(t)e(F)-7
-b(ree)27 b(Soft)n(w)n(are)f(F)-7 b(oundation,)27 b(Inc.)p
-eop end
-%%Page: 6 6
-TeXDict begin 6 5 bop 3708 -150 a Fl(6)0 83 y(The)27
-b(cxref)f(and)h(cxref-cpp)f(programs)e(can)j(b)r(e)g(freely)f
-(distributed)h(according)e(to)i(the)g(terms)g(of)f(the)h(GNU)h(General)
-0 183 y(Public)f(License)h(\(see)f(the)h(\014le)g(`COPYING'\).)p
-eop end
-%%Page: 7 7
-TeXDict begin 7 6 bop 0 664 a Fn(Chapter)65 b(2)0 1038
-y Fm(Example)76 b(\\README.c")0 1469 y Fi(/***************)o(**)87
-1569 y($Header:)40 b(/home/amb/cxref/d)o(oc/)o(RC)o(S/R)o(EA)o(DM)o
-(E.c)d(1.4)42 b(1997/05/26)e(11:23:40)g(amb)i(Exp)h($)87
-1768 y(A)g(comment)e(for)h(the)h(file,)e(RCS)i(header)e(comments)f(are)
-i(treated)f(specially)f(when)i(first.)87 1868 y(*****************)o(/)0
-2267 y(/*+)g(A)i(#include)c(comment)g(+*/)0 2366 y(#include)g
-(<stdio.h>)0 2665 y(#include)g(<math.h>)84 b(/*+)42 b(An)h(alternative)
-c(#include)i(comment.)f(+*/)0 2964 y(/*+)i(A)i(#define)c(comment.)g
-(+*/)0 3064 y(#define)h(def1)h(1)0 3362 y(#define)f(def2)h(2)86
-b(/*+)43 b(An)f(alternative)e(#define)g(comment.)g(+*/)0
-3661 y(/*+++++++++++)87 3761 y(A)j(#define)e(with)h(args)87
-3960 y(arg1)g(The)g(first)g(arg)87 4159 y(arg2)g(The)g(second)g(arg)87
-4259 y(+++++++++++*/)0 4458 y(#define)f(def3\(arg1,arg2\))c
-(\(arg1+arg2\))0 4757 y(/*+)42 b(An)h(alternative)c(#define)i(with)h
-(args.)f(+*/)0 4956 y(#define)g(def4\(arg1)f(/*+)i(The)g(first)g(arg)86
-b(+*/,)42 b(\\)567 5056 y(arg2)g(/*+)g(The)g(second)f(arg)i(+*/\))f(\\)
-479 5156 y(\(arg1+arg2\))0 5455 y(/*+)g(An)h(example)e(typedef)f
-(comment)h(+*/)0 5554 y(typedef)g(enum)0 5654 y({)44
-5753 y(one,)521 b(/*+)42 b(one)h(value)e(+*/)1854 5970
-y Fl(7)p eop end
-%%Page: 8 8
-TeXDict begin 8 7 bop 3708 -150 a Fl(8)44 83 y Fi(two)565
-b(/*+)42 b(another)f(value)h(+*/)0 183 y(})0 282 y(type1;)0
-581 y(/*+)g(Another)f(example)g(typedef)f(comment,)h(+*/)0
-681 y(typedef)g(struct)0 780 y({)44 880 y(int)h(a;)391
-b(/*+)43 b(A)g(variable)d(in)j(a)g(struct.)e(+*/)44 980
-y(union)g(bar)87 1079 y({)131 1179 y(char)h(a;)260 b(/*+)43
-b(Each)f(element)e(+*/)131 1279 y(int)86 b(b,)260 b(/*+)43
-b(of)f(a)i(struct)d(+*/)349 1378 y(c;)260 b(/*+)43 b(or)f(a)i(union)d
-(+*/)131 1478 y(long)h(d;)260 b(/*+)43 b(can)f(have)g(a)h(comment)e
-(+*/)87 1577 y(})44 1677 y(e;)565 b(/*+)43 b(Nested)e(structs)g(and)h
-(unions)f(also)h(work.)f(+*/)0 1777 y(})0 1876 y(type2,)433
-b(/*+)43 b(a)g(type)f(that)g(is)h(a)g(struct.)d(+*/)0
-1976 y(*ptype2;)345 b(/*+)43 b(a)g(pointer)e(to)h(a)i(struct)d(type.)g
-(+*/)0 2275 y(/*+)h(A)i(leading)c(comment)h(only.)g(+*/)0
-2374 y(int)h(var1,var2;)0 2673 y(static)f(int)h(var3;)g(/*+)g(A)h
-(trailing)e(comment)f(only.)i(+*/)0 2972 y(/*+)g(A)i(variable)c(for)i
-(+*/)0 3072 y(int)g(var4,)173 b(/*+)42 b(one)g(thing.)f(+*/)174
-3171 y(var5,)173 b(/*+)42 b(a)h(second)e(thing.)g(+*/)174
-3271 y(var6;)173 b(/*+)42 b(a)h(third)f(thing.)f(+*/)0
-3470 y(/*)i(Note:)e(The)i(leading)d(comment)h(is)i(combined)d(with)i
-(each)g(of)h(the)f(trailing)e(comments.)g(*/)0 3570 y(/*)j(Note:)e(the)
-i(push)f(through)e(of)j(the)f(comment)f(above)h(on)g(the)h(',')f(and)g
-(';',)g(see)h(README.)d(*/)0 3869 y(/*+++++++++++)87
-3968 y(A)j(function)e(comment)f(\(the)i(comments)f(for)h(the)g(args)g
-(need)g(to)h(be)g(separated)c(by)k(a)g(blank)f(line\).)87
-4168 y(int)h(function1)c(The)k(return)e(value.)87 4367
-y(int)i(arg1)e(The)i(first)e(argument.)87 4566 y(int)i(arg2)e(The)i
-(second)e(argument.)87 4765 y(Some)h(more)g(comments)87
-4965 y(+none+)85 b(Note:)41 b(this)h(line)g(and)h(the)f(two)g(below)g
-(are)g(processed)e(specially.)87 5064 y(+html+)85 b(This)42
-b(comment)e(is)j(only)f(visible)f(in)i(the)f(HTML)g(output,)f(and)h
-(can)g(contain)f(HTML)h(markup.)87 5164 y(+latex+)f(This)h(comment)e
-(is)j(only)f(visible)f(in)i(the)f(\\LaTeX)f(output,)g(and)h(can)g
-(contain)f(\\LaTeX)g(markup.)87 5264 y(+++++++++++*/)0
-5463 y(int)h(function1\(int)d(arg1,int)h(arg2\))0 5562
-y({)44 5662 y(/*+)i(An)h(internal)d(comment)h(in)h(a)i(function)c(that)
-i(appears)e(as)j(a)131 5762 y(new)f(paragraph)e(at)j(the)f(end)g(of)h
-(the)g(comment.)d(+*/)p eop end
-%%Page: 9 9
-TeXDict begin 9 8 bop 3708 -150 a Fl(9)44 183 y Fi(var1=0;)44
-382 y(function2\(var3,)o(var)o(4\))o(;)0 482 y(})0 780
-y(/*+)42 b(An)h(alternative)c(function)h(comment)h(+*/)0
-980 y(int)h(function2\(int)d(arg1,)85 b(/*+)42 b(The)g(first)g
-(argument.)83 b(+*/)610 1079 y(int)43 b(arg2\))85 b(/*+)42
-b(The)g(second)f(argument.)f(+*/)0 1179 y(/*+)i(Returns)f(a)i(value)f
-(+*/)0 1279 y({)44 1378 y(int)g(\(*funcp\)\(\)=&func)o(ti)o(on1)o(;)0
-1478 y(})0 1677 y(/*)h(Note:)e(the)i(push)f(through)e(of)j(the)f
-(comment)f(above)h(on)g(the)h(',')f(and)g('\)',)g(see)h(README.)d(*/)p
-eop end
-%%Page: 10 10
-TeXDict begin 10 9 bop 0 664 a Fn(Chapter)65 b(3)0 1038
-y Fm(Cxref)77 b(Output)h(F)-19 b(or)77 b(\\README.c")0
-1501 y Fj(3.1)135 b(File)46 b(README.c)0 1683 y Ff(R)m(CS)26
-b(Header:)39 b(/home/am)m(b/cxref/do)s(c/R)m(CS/README.c)23
-b(1.4)i(1997/05/26)e(11:23:40)g(am)m(b)j(Exp)0 1808 y
-Fl(A)i(commen)n(t)f(for)g(the)h(\014le,)g(R)n(CS)g(header)f(commen)n
-(ts)g(are)f(treated)i(sp)r(ecially)f(when)h(\014rst.)0
-2024 y Fe(Included)38 b(Files)0 2177 y Fl(A)28 b(#include)g(commen)n(t)
-0 2300 y Fd(#include)41 b(<stdio.h>)0 2451 y Fl(An)28
-b(alternativ)n(e)e(#include)j(commen)n(t.)0 2574 y Fd(#include)41
-b(<math.h>)0 2791 y Fe(Prepro)s(cessor)c(de\014nitions)0
-2944 y Fl(A)28 b(#de\014ne)g(commen)n(t.)0 3069 y Fd(#define)41
-b(def1)f(1)0 3218 y Fl(An)28 b(alternativ)n(e)e(#de\014ne)i(commen)n
-(t.)0 3343 y Fd(#define)41 b(def2)f(2)0 3492 y Fl(A)28
-b(#de\014ne)g(with)g(args)0 3617 y Fd(#define)41 b(def3\()f(arg1,)h
-(arg2)f(\))0 3777 y Fg(\001)60 b Fd(arg1)1350 3783 y
-Fl(The)28 b(\014rst)f(arg)0 3901 y Fg(\001)60 b Fd(arg2)1350
-3907 y Fl(The)28 b(second)f(arg)0 4098 y(An)h(alternativ)n(e)e
-(#de\014ne)i(with)h(args.)0 4223 y Fd(#define)41 b(def4\()f(arg1,)h
-(arg2)f(\))0 4383 y Fg(\001)60 b Fd(arg1)1350 4389 y
-Fl(The)28 b(\014rst)f(arg)0 4507 y Fg(\001)60 b Fd(arg2)1350
-4513 y Fl(The)28 b(second)f(arg)0 4729 y Fe(3.1.1)112
-b(T)m(yp)s(e)38 b(de\014nitions)0 4882 y Ff(3.1.1.1)93
-b(T)m(yp)s(edef)32 b(t)m(yp)s(e1)0 5036 y Fl(An)c(example)f(t)n(yp)r
-(edef)h(commen)n(t)0 5160 y Fd(typedef)41 b(enum)f Fc(f)p
-Fd(...)p Fc(g)h Fd(type1)0 5282 y(enum)60 5382 y Fc(f)120
-5481 y Fd(one;)1224 b Fl(one)27 b(v)-5 b(alue)120 5581
-y Fd(two;)1224 b Fl(another)27 b(v)-5 b(alue)60 5680
-y Fc(g)1833 5970 y Fl(10)p eop end
-%%Page: 11 11
-TeXDict begin 11 10 bop 0 -150 a Fb(File)28 b(README.c)3066
-b Fl(11)0 83 y Ff(3.1.1.2)93 b(T)m(yp)s(e)32 b(union)g(bar)0
-236 y Fl(Nested)c(structs)f(and)h(unions)f(also)f(w)n(ork.)0
-364 y Fd(union)40 b(bar)60 464 y Fc(f)120 563 y Fd(char)g(a;)1106
-b Fl(Eac)n(h)26 b(elemen)n(t)120 663 y Fd(int)40 b(b;)1145
-b Fl(of)28 b(a)f(struct)120 763 y Fd(int)40 b(c;)1145
-b Fl(or)27 b(a)g(union)120 871 y Fd(long)40 b(d;)1106
-b Fl(can)27 b(ha)n(v)n(e)g(a)g(commen)n(t)60 970 y Fc(g)0
-1182 y Ff(3.1.1.3)93 b(T)m(yp)s(edef)32 b(t)m(yp)s(e2)0
-1335 y Fl(Another)27 b(example)h(t)n(yp)r(edef)g(commen)n(t,)f(a)g(t)n
-(yp)r(e)h(that)g(is)g(a)f(struct.)0 1460 y Fd(typedef)41
-b(struct)f Fc(f)p Fd(...)p Fc(g)h Fd(type2)0 1582 y(struct)60
-1681 y Fc(f)120 1781 y Fd(int)f(a;)1145 b Fl(A)28 b(v)-5
-b(ariable)27 b(in)g(a)h(struct.)120 1880 y Fd(union)40
-b(bar)180 1980 y Fc(f)240 2080 y Fd(char)g(a;)986 b Fl(Eac)n(h)26
-b(elemen)n(t)240 2188 y Fd(int)40 b(b;)1025 b Fl(of)28
-b(a)f(struct)240 2287 y Fd(int)40 b(c;)1025 b Fl(or)27
-b(a)g(union)240 2387 y Fd(long)40 b(d;)986 b Fl(can)27
-b(ha)n(v)n(e)g(a)g(commen)n(t)180 2487 y Fc(g)180 2586
-y Fd(e;)1242 b Fl(Nested)28 b(structs)f(and)h(unions)f(also)f(w)n(ork.)
-60 2686 y Fc(g)0 2898 y Ff(3.1.1.4)93 b(T)m(yp)s(edef)32
-b(pt)m(yp)s(e2)0 3051 y Fl(Another)27 b(example)h(t)n(yp)r(edef)g
-(commen)n(t,)f(a)g(p)r(oin)n(ter)h(to)f(a)g(struct)h(t)n(yp)r(e.)0
-3176 y Fd(typedef)41 b(struct)f Fc(f)p Fd(...)p Fc(g)p
-Fd(*)h(ptype2)0 3299 y Fl(See:)307 b(T)n(yp)r(edef)28
-b(t)n(yp)r(e2)2026 b Fa(\(Se)l(ction)29 b(3.1.1.3\))0
-3516 y Fe(3.1.2)112 b(V)-9 b(ariables)0 3669 y Ff(3.1.2.1)93
-b(V)-8 b(ariable)32 b(v)-5 b(ar1)0 3822 y Fl(A)28 b(leading)f(commen)n
-(t)g(only)-7 b(.)0 3947 y Fd(int)40 b(var1)0 4050 y Fl(Visible)28
-b(in:)83 b(README.c)2114 b Fa(\(Se)l(ction)29 b(3.1\))0
-4150 y Fl(Used)f(in:)152 b(function1\(\))947 b(README.c)764
-b Fa(\(Se)l(ction)29 b(3.1.3.1\))0 4362 y Ff(3.1.2.2)93
-b(V)-8 b(ariable)32 b(v)-5 b(ar2)0 4515 y Fl(A)28 b(leading)f(commen)n
-(t)g(only)-7 b(.)0 4639 y Fd(int)40 b(var2)0 4763 y Fl(Visible)28
-b(in:)83 b(README.c)2114 b Fa(\(Se)l(ction)29 b(3.1\))0
-4980 y Ff(3.1.2.3)93 b(V)-8 b(ariable)32 b(v)-5 b(ar4)0
-5133 y Fl(A)28 b(v)-5 b(ariable)27 b(for)g(one)g(thing.)0
-5257 y Fd(int)40 b(var4)0 5360 y Fl(Visible)28 b(in:)83
-b(README.c)2114 b Fa(\(Se)l(ction)29 b(3.1\))0 5460 y
-Fl(Used)f(in:)152 b(function1\(\))947 b(README.c)764
-b Fa(\(Se)l(ction)29 b(3.1.3.1\))p eop end
-%%Page: 12 12
-TeXDict begin 12 11 bop 0 -150 a Fb(Con)n(ten)n(ts)3343
-b Fl(12)0 83 y Ff(3.1.2.4)93 b(V)-8 b(ariable)32 b(v)-5
-b(ar5)0 236 y Fl(A)28 b(v)-5 b(ariable)27 b(for)g(a)g(second)g(thing.)0
-361 y Fd(int)40 b(var5)0 484 y Fl(Visible)28 b(in:)83
-b(README.c)2114 b Fa(\(Se)l(ction)29 b(3.1\))0 701 y
-Ff(3.1.2.5)93 b(V)-8 b(ariable)32 b(v)-5 b(ar6)0 854
-y Fl(A)28 b(v)-5 b(ariable)27 b(for)g(a)g(third)h(thing.)0
-979 y Fd(int)40 b(var6)0 1102 y Fl(Visible)28 b(in:)83
-b(README.c)2114 b Fa(\(Se)l(ction)29 b(3.1\))0 1319 y
-Ff(3.1.2.6)93 b(Lo)s(cal)32 b(V)-8 b(ariables)0 1472
-y(v)j(ar3)0 1572 y Fl(A)28 b(trailing)f(commen)n(t)g(only)-7
-b(.)0 1697 y Fd(static)41 b(int)f(var3)0 1820 y Fl(Used)28
-b(in:)152 b(function1\(\))2147 b Fa(\(Se)l(ction)29 b(3.1.3.1\))0
-2037 y Fe(3.1.3)112 b(F)-9 b(unctions)0 2190 y Ff(3.1.3.1)93
-b(Global)31 b(F)-8 b(unction)32 b(function1\(\))0 2343
-y Fl(A)c(function)g(commen)n(t)g(\(the)g(commen)n(ts)f(for)g(the)h
-(args)e(need)i(to)f(b)r(e)h(separated)f(b)n(y)g(a)g(blank)g(line\).)0
-2468 y Fd(int)40 b(function1)h(\()f(int)g(arg1,)g(int)g(arg2)g(\))0
-2636 y Fg(\001)60 b Fd(int)40 b(function1)1350 2634 y
-Fl(The)28 b(return)f(v)-5 b(alue.)0 2753 y Fg(\001)60
-b Fd(int)40 b(arg1)1350 2759 y Fl(The)28 b(\014rst)f(argumen)n(t.)0
-2877 y Fg(\001)60 b Fd(int)40 b(arg2)1350 2883 y Fl(The)28
-b(second)f(argumen)n(t.)0 3049 y(Some)g(more)g(commen)n(ts)0
-3149 y(This)h(commen)n(t)f(is)h(only)f(visible)g(in)h(the)g(L)1331
-3132 y Fk(A)1368 3149 y Fl(T)1414 3167 y(E)1460 3149
-y(Xoutput,)g(and)g(can)f(con)n(tain)g(L)2446 3132 y Fk(A)2483
-3149 y Fl(T)2529 3167 y(E)2575 3149 y(Xmarkup.)0 3248
-y(An)h(in)n(ternal)f(commen)n(t)g(in)h(a)g(function)g(that)g(app)r
-(ears)e(as)h(a)g(new)h(paragraph)d(at)i(the)h(end)g(of)g(the)g(commen)n
-(t.)0 3367 y(Calls:)246 b(function2\(\))947 b(README.c)764
-b Fa(\(Se)l(ction)29 b(3.1.3.2\))0 3467 y Fl(Used)f(in:)152
-b(function2\(\))947 b(README.c)764 b Fa(\(Se)l(ction)29
-b(3.1.3.2\))0 3567 y Fl(Refs)f(V)-7 b(ar:)113 b(v)-5
-b(ar1)1194 b(README.c)764 b Fa(\(Se)l(ction)29 b(3.1.2.1\))450
-3666 y Fl(v)-5 b(ar3)1194 b(README.c)764 b Fa(\(Se)l(ction)29
-b(3.1.2.6\))450 3774 y Fl(v)-5 b(ar4)1194 b(README.c)764
-b Fa(\(Se)l(ction)29 b(3.1.2.3\))0 3991 y Ff(3.1.3.2)93
-b(Global)31 b(F)-8 b(unction)32 b(function2\(\))0 4144
-y Fl(An)c(alternativ)n(e)e(function)j(commen)n(t)0 4269
-y Fd(int)40 b(function2)h(\()f(int)g(arg1,)g(int)g(arg2,)g(void)g(\))0
-4437 y Fg(\001)60 b Fd(int)40 b(function2)1350 4435 y
-Fl(Returns)27 b(a)h(v)-5 b(alue)0 4553 y Fg(\001)60 b
-Fd(int)40 b(arg1)1350 4559 y Fl(The)28 b(\014rst)f(argumen)n(t.)0
-4678 y Fg(\001)60 b Fd(int)40 b(arg2)1350 4684 y Fl(The)28
-b(second)f(argumen)n(t.)0 4810 y Fg(\001)60 b Fd(void)0
-4955 y Fl(Called)27 b(b)n(y:)81 b(function1\(\))947 b(README.c)764
-b Fa(\(Se)l(ction)29 b(3.1.3.1\))0 5055 y Fl(Refs)f(F)-7
-b(unc:)67 b(function1\(\))947 b(README.c)764 b Fa(\(Se)l(ction)29
-b(3.1.3.1\))p eop end
-%%Page: 13 13
-TeXDict begin 13 12 bop 0 706 a Fm(Con)-6 b(ten)g(ts)0
-1220 y Ff(1)77 b(C)31 b(Cross)g(Referencing)g(&)i(Do)s(cumen)m(ting)e
-(to)s(ol.)40 b(V)-8 b(ersion)31 b(1.6)g(-)h(cxref)996
-b(1)125 1320 y Fl(1.1)83 b(Program)25 b(Options)44 b(.)e(.)f(.)h(.)g(.)
-f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h
-(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)
-f(.)113 b(1)125 1420 y(1.2)83 b(C)28 b(Compiler)f(Replacemen)n(t)g
-(cxref-cc)37 b(.)42 b(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h
-(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)
-f(.)113 b(3)125 1519 y(1.3)83 b(Cxref)28 b(con\014guration)e(File)66
-b(.)41 b(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)
-f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h
-(.)g(.)f(.)113 b(3)125 1619 y(1.4)83 b(Program)25 b(Do)r(cumen)n
-(tation)j(Commen)n(ts)71 b(.)41 b(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f
-(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)
-g(.)f(.)113 b(3)125 1719 y(1.5)83 b(Automated)28 b(Commen)n(t)g
-(Insertion)52 b(.)41 b(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f
-(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)
-g(.)f(.)113 b(3)125 1818 y(1.6)83 b(C)28 b(Prepro)r(cessor)57
-b(.)41 b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)
-f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f
-(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)113 b(4)125 1918 y(1.7)83
-b(Cross)27 b(Referencing)22 b(.)42 b(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)
-h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h
-(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)113
-b(4)125 2017 y(1.8)83 b(L)337 2000 y Fk(A)374 2017 y
-Fl(T)420 2035 y(E)466 2017 y(XOutput)65 b(.)42 b(.)f(.)h(.)f(.)h(.)g(.)
-f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h
-(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)
-f(.)113 b(5)125 2117 y(1.9)83 b(HTML)28 b(Output)65 b(.)41
-b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h
-(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)
-f(.)h(.)f(.)h(.)g(.)f(.)113 b(5)125 2217 y(1.10)41 b(R)-7
-b(TF)29 b(Output)81 b(.)42 b(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)
-h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h
-(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)113
-b(5)125 2316 y(1.11)41 b(SGML)28 b(Output)76 b(.)41 b(.)h(.)f(.)h(.)g
-(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)
-h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g
-(.)f(.)113 b(5)125 2416 y(1.12)41 b(Example)27 b(Sp)r(ecial)h(Commen)n
-(ts)47 b(.)41 b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f
-(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)
-g(.)f(.)113 b(5)125 2516 y(1.13)41 b(F)-7 b(urther)28
-b(Information)71 b(.)42 b(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f
-(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)
-g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)113 b(5)125 2615
-y(1.14)41 b(Author)28 b(and)f(Cop)n(yrigh)n(t)54 b(.)42
-b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f
-(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)
-g(.)f(.)113 b(5)0 2798 y Ff(2)77 b(Example)31 b(\\README.c")2580
-b(7)0 2980 y(3)77 b(Cxref)32 b(Output)g(F)-8 b(or)32
-b(\\README.c")2156 b(10)125 3080 y Fl(3.1)83 b(File)28
-b(README.c)73 b(.)42 b(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h
-(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)
-h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)72 b(10)315 3180
-y(3.1.1)94 b(T)n(yp)r(e)28 b(de\014nitions)78 b(.)41
-b(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h
-(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)
-f(.)72 b(10)581 3279 y(3.1.1.1)104 b(T)n(yp)r(edef)27
-b(t)n(yp)r(e1)61 b(.)41 b(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h
-(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)
-h(.)g(.)f(.)72 b(10)581 3379 y(3.1.1.2)104 b(T)n(yp)r(e)27
-b(union)h(bar)82 b(.)42 b(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f
-(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)
-g(.)f(.)72 b(11)581 3479 y(3.1.1.3)104 b(T)n(yp)r(edef)27
-b(t)n(yp)r(e2)61 b(.)41 b(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h
-(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)
-h(.)g(.)f(.)72 b(11)581 3578 y(3.1.1.4)104 b(T)n(yp)r(edef)27
-b(pt)n(yp)r(e2)79 b(.)42 b(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f
-(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)
-g(.)f(.)72 b(11)315 3678 y(3.1.2)94 b(V)-7 b(ariables)74
-b(.)42 b(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)
-h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h
-(.)f(.)h(.)f(.)h(.)g(.)f(.)72 b(11)581 3778 y(3.1.2.1)104
-b(V)-7 b(ariable)26 b(v)-5 b(ar1)36 b(.)42 b(.)f(.)h(.)g(.)f(.)h(.)f(.)
-h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g
-(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)72 b(11)581 3877 y(3.1.2.2)104
-b(V)-7 b(ariable)26 b(v)-5 b(ar2)36 b(.)42 b(.)f(.)h(.)g(.)f(.)h(.)f(.)
-h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g
-(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)72 b(11)581 3977 y(3.1.2.3)104
-b(V)-7 b(ariable)26 b(v)-5 b(ar4)36 b(.)42 b(.)f(.)h(.)g(.)f(.)h(.)f(.)
-h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g
-(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)72 b(11)581 4076 y(3.1.2.4)104
-b(V)-7 b(ariable)26 b(v)-5 b(ar5)36 b(.)42 b(.)f(.)h(.)g(.)f(.)h(.)f(.)
-h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g
-(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)72 b(12)581 4176 y(3.1.2.5)104
-b(V)-7 b(ariable)26 b(v)-5 b(ar6)36 b(.)42 b(.)f(.)h(.)g(.)f(.)h(.)f(.)
-h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g
-(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)72 b(12)581 4276 y(3.1.2.6)104
-b(Lo)r(cal)26 b(V)-7 b(ariables)26 b(.)41 b(.)h(.)g(.)f(.)h(.)f(.)h(.)f
-(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)
-h(.)f(.)h(.)f(.)h(.)g(.)f(.)72 b(12)315 4375 y(3.1.3)94
-b(F)-7 b(unctions)56 b(.)42 b(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g
-(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)
-h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)72 b(12)581
-4475 y(3.1.3.1)104 b(Global)27 b(F)-7 b(unction)28 b(function1\(\))82
-b(.)42 b(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)
-f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)72 b(12)581 4575 y(3.1.3.2)104
-b(Global)27 b(F)-7 b(unction)28 b(function2\(\))82 b(.)42
-b(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h
-(.)f(.)h(.)f(.)h(.)g(.)f(.)72 b(12)1833 5970 y(13)p eop
-end
-%%Trailer
-
-userdict /end-hook known{end-hook}if
-%%EOF
diff -Nru cxref-1.6a.old/doc/README_c.tex cxref-1.6a/doc/README_c.tex
--- cxref-1.6a.old/doc/README_c.tex	2008-04-18 08:42:54.832397287 +0200
+++ cxref-1.6a/doc/README_c.tex	1970-01-01 01:00:00.000000000 +0100
@@ -1,303 +0,0 @@
-% This LaTeX file generated by cxref (version 1.6a).
-% cxref program (c) Andrew M. Bishop 1995,96,97,98,99,2000,01,02,03,04.
-
-% Cxref: ../src/cxref -O. -NREADME-TMP -xref -latex -html-src -rtf -sgml README.c
-% CPP  : /home/amb/cxref/src/.././cpp/cxref-cpp -cxref-cpp-defines /home/amb/cxref/src/.././cpp/cxref-cpp.defines -C -dD -dI
-
-\markboth{File README.c}{File README.c}
-\section{File README.c}
-\label{file_README.c}
-
-{\bf RCS Header: /home/amb/cxref/doc/RCS/README.c 1.4 1997/05/26 11:23:40 amb Exp }
-
-\smallskip
-
-  A comment for the file, RCS header comments are treated specially when first.
-
-
-\subsection*{Included Files}
-
- A \#include comment 
-
-\smallskip
-\begin{cxreftabi}
-{\stt \#include <stdio.h>} &\\
-\end{cxreftabi}
-
-\medskip
- An alternative \#include comment. 
-
-\smallskip
-\begin{cxreftabi}
-{\stt \#include <math.h>} &\\
-\end{cxreftabi}
-
-
-\subsection*{Preprocessor definitions}
-
- A \#define comment. 
-
-\smallskip
-{\stt \#define def1 1}
-
-\medskip
- An alternative \#define comment. 
-
-\smallskip
-{\stt \#define def2 2}
-
-\medskip
-  A \#define with args
-
-\smallskip
-{\stt \#define def3( arg1, arg2 )}
-
-\smallskip
-\begin{cxrefarglist}
-\cxrefargitem{arg1} The first arg
-\cxrefargitem{arg2} The second arg
-\end{cxrefarglist}
-
-\medskip
- An alternative \#define with args. 
-
-\smallskip
-{\stt \#define def4( arg1, arg2 )}
-
-\smallskip
-\begin{cxrefarglist}
-\cxrefargitem{arg1}  The first arg  
-\cxrefargitem{arg2}  The second arg 
-\end{cxrefarglist}
-
-
-\subsection{Type definitions}
-
-
-\subsubsection{Typedef type1}
-\label{type_type1_README.c}
-
- An example typedef comment 
-
-\smallskip
-{\stt typedef enum \{...\} type1}
-
-\smallskip
-\begin{cxreftabiia}
-\hspace*{0.0in}{\stt enum} &\\
-\hspace*{0.1in}{\stt \{} &\\
-\hspace*{0.2in}{\stt one;} &  one value  \\
-\hspace*{0.2in}{\stt two;} &  another value  \\
-\hspace*{0.1in}{\stt \}} &\\
-\end{cxreftabiia}
-
-
-\subsubsection{Type union bar}
-\label{type_union_bar_README.c}
-
- Nested structs and unions also work. 
-
-\smallskip
-\smallskip
-\begin{cxreftabiia}
-\hspace*{0.0in}{\stt union bar} &\\
-\hspace*{0.1in}{\stt \{} &\\
-\hspace*{0.2in}{\stt char a;} &  Each element  \\
-\hspace*{0.2in}{\stt int b;} &  of a struct  \\
-\hspace*{0.2in}{\stt int c;} &  or a union  \\
-\cxreftabbreak{cxreftabiia}
-\hspace*{0.2in}{\stt long d;} &  can have a comment  \\
-\hspace*{0.1in}{\stt \}} &\\
-\end{cxreftabiia}
-
-
-\subsubsection{Typedef type2}
-\label{type_type2_README.c}
-
- Another example typedef comment,   a type that is a struct. 
-
-\smallskip
-{\stt typedef struct \{...\} type2}
-
-\smallskip
-\begin{cxreftabiia}
-\hspace*{0.0in}{\stt struct} &\\
-\hspace*{0.1in}{\stt \{} &\\
-\hspace*{0.2in}{\stt int a;} &  A variable in a struct.  \\
-\hspace*{0.2in}{\stt union bar} &\\
-\hspace*{0.3in}{\stt \{} &\\
-\hspace*{0.4in}{\stt char a;} &  Each element  \\
-\cxreftabbreak{cxreftabiia}
-\hspace*{0.4in}{\stt int b;} &  of a struct  \\
-\hspace*{0.4in}{\stt int c;} &  or a union  \\
-\hspace*{0.4in}{\stt long d;} &  can have a comment  \\
-\hspace*{0.3in}{\stt \}} &\\
-\hspace*{0.3in}{\stt e;} &  Nested structs and unions also work.  \\
-\hspace*{0.1in}{\stt \}} &\\
-\end{cxreftabiia}
-
-
-\subsubsection{Typedef ptype2}
-\label{type_ptype2_README.c}
-
- Another example typedef comment,   a pointer to a struct type. 
-
-\smallskip
-{\stt typedef struct \{...\}* ptype2}
-
-\smallskip
-\begin{cxreftabii}
-See:& Typedef type2 & \cxreftype{type2}{README.c}\\
-\end{cxreftabii}
-
-
-\subsection{Variables}
-
-
-\subsubsection{Variable var1}
-\label{var_var1_README.c}
-
- A leading comment only. 
-
-\smallskip
-{\stt int var1}
-
-\smallskip
-\begin{cxreftabiii}
-Visible in:\ & README.c & \ & \cxreffile{README.c}\\
-Used in:\ & function1() & README.c & \cxreffunc{function1}{README.c}\\
-\end{cxreftabiii}
-
-
-\subsubsection{Variable var2}
-\label{var_var2_README.c}
-
- A leading comment only. 
-
-\smallskip
-{\stt int var2}
-
-\smallskip
-\begin{cxreftabiii}
-Visible in:\ & README.c & \ & \cxreffile{README.c}\\
-\end{cxreftabiii}
-
-
-\subsubsection{Variable var4}
-\label{var_var4_README.c}
-
- A variable for   one thing. 
-
-\smallskip
-{\stt int var4}
-
-\smallskip
-\begin{cxreftabiii}
-Visible in:\ & README.c & \ & \cxreffile{README.c}\\
-Used in:\ & function1() & README.c & \cxreffunc{function1}{README.c}\\
-\end{cxreftabiii}
-
-
-\subsubsection{Variable var5}
-\label{var_var5_README.c}
-
- A variable for   a second thing. 
-
-\smallskip
-{\stt int var5}
-
-\smallskip
-\begin{cxreftabiii}
-Visible in:\ & README.c & \ & \cxreffile{README.c}\\
-\end{cxreftabiii}
-
-
-\subsubsection{Variable var6}
-\label{var_var6_README.c}
-
- A variable for   a third thing. 
-
-\smallskip
-{\stt int var6}
-
-\smallskip
-\begin{cxreftabiii}
-Visible in:\ & README.c & \ & \cxreffile{README.c}\\
-\end{cxreftabiii}
-
-
-\subsubsection{Local Variables}
-
-{\bf var3}
-\label{var_var3_README.c}
-
- A trailing comment only. 
-
-\smallskip
-{\stt static int var3}
-
-\smallskip
-\begin{cxreftabiii}
-Used in:\ & function1() & \ & \cxreffunc{function1}{README.c}\\
-\end{cxreftabiii}
-
-
-\subsection{Functions}
-
-
-\subsubsection{Global Function function1()}
-\label{func_function1_README.c}
-
-  A function comment (the comments for the args need to be separated by a blank line).
-
-\smallskip
-{\stt int function1 ( int arg1, int arg2 )}
-
-\smallskip
-\begin{cxrefarglist}
-\cxrefargitem{int function1} The return value.
-\cxrefargitem{int arg1} The first argument.
-\cxrefargitem{int arg2} The second argument.
-\end{cxrefarglist}
-
-\smallskip
-  Some more comments
-
- This comment is only visible in the \LaTeX output, and can contain \LaTeX markup.
-
- An internal comment in a function that appears as a
-   new paragraph at the end of the comment. 
-
-\smallskip
-\begin{cxreftabiii}
-Calls:\ & function2() & README.c & \cxreffunc{function2}{README.c}\\
-Used in:\ & function2() & README.c & \cxreffunc{function2}{README.c}\\
-Refs Var:\ & var1 & README.c & \cxrefvar{var1}{README.c}\\
-\ & var3 & README.c & \cxrefvar{var3}{README.c}\\
-\cxreftabbreak{cxreftabiii}
-\ & var4 & README.c & \cxrefvar{var4}{README.c}\\
-\end{cxreftabiii}
-
-
-\subsubsection{Global Function function2()}
-\label{func_function2_README.c}
-
- An alternative function comment 
-
-\smallskip
-{\stt int function2 ( int arg1, int arg2, void )}
-
-\smallskip
-\begin{cxrefarglist}
-\cxrefargitem{int function2}  Returns a value 
-\cxrefargitem{int arg1}  The first argument.  
-\cxrefargitem{int arg2}  The second argument. 
-\cxrefargitem{void} \ 
-\end{cxrefarglist}
-
-\smallskip
-\begin{cxreftabiii}
-Called by:\ & function1() & README.c & \cxreffunc{function1}{README.c}\\
-Refs Func:\ & function1() & README.c & \cxreffunc{function1}{README.c}\\
-\end{cxreftabiii}
-
