M Joonas Pihlaja's cleanup patches for XML-Docbook masters.

29 files changed, 170 insertions, 169 deletions

diff --git a/doc/explan_bits.h.xml b/doc/explan_bits.h.xml
index 722f0383..6a26c2f0 100644
--- a/doc/explan_bits.h.xml
+++ b/doc/explan_bits.h.xml
@@ -5,18 +5,18 @@
 <colspec colname='c2'></colspec>
 <spanspec spanname='s1' namest='c1' nameend='c2'></spanspec>
 
-<tbody>
-<row>
-  <entry><para>This file only contains macros that convert data variables from the native format of the device output (MSB-first or LSB-first) into a standard form for <function>gpsd</function> use. This makes data parsing consistent regardless of the underlying format. If the device driver file makes no deliberate selection, the default is to assume the device emits data in big-endian (network byte) order.</para></entry>
-</row>
-</tbody>
-
 <tfoot>
 <row>
   <entry spanname='s1' align='left'>Notes based on <function>$Id: bits.h 4030 2006-11-30 07:29:25Z esr $</function></entry>
 </row>
 </tfoot>
 
+<tbody>
+<row>
+  <entry><para>This file only contains macros that convert data variables from the native format of the device output (MSB-first or LSB-first) into a standard form for <function>gpsd</function> use. This makes data parsing consistent regardless of the underlying format. If the device driver file makes no deliberate selection, the default is to assume the device emits data in big-endian (network byte) order.</para></entry>
+</row>
+</tbody>
+
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_dgnss.c.xml b/doc/explan_dgnss.c.xml
index 12d50f90..2337bfa5 100644
--- a/doc/explan_dgnss.c.xml
+++ b/doc/explan_dgnss.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: dgnss.c 3771 2006-11-02 05:15:20Z esr $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>bool dgnss_url(char *name)</function></entry>
@@ -38,12 +44,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: dgnss.c 3771 2006-11-02 05:15:20Z esr $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_dgpsip.c.xml b/doc/explan_dgpsip.c.xml
index bf7b4316..4c5a5312 100644
--- a/doc/explan_dgpsip.c.xml
+++ b/doc/explan_dgpsip.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: dgpsip.c 3771 2006-11-02 05:15:20Z esr $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>int dgpsip_open(struct gps_context_t *context, const char *dgpsserver)</function></entry>
@@ -30,12 +36,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: dgpsip.c 3771 2006-11-02 05:15:20Z esr $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_driver_proto.c.xml b/doc/explan_driver_proto.c.xml
index 626d9866..78982a93 100644
--- a/doc/explan_driver_proto.c.xml
+++ b/doc/explan_driver_proto.c.xml
@@ -5,18 +5,18 @@
 <colspec colname='c2'></colspec>
 <spanspec spanname='s1' namest='c1' nameend='c2'></spanspec>
 
-<tbody>
-<row>
-  <entry><para>This is a dummy file to use as a skeleton for writing a new driver. The driver is heavily commented, so refer to the source code.</para></entry>
-</row>
-</tbody>
-
 <tfoot>
 <row>
   <entry spanname='s1' align='left'>Notes based on <function>$Id: driver_proto.c 4373 2007-06-01 22:30:43Z esr $</function></entry>
 </row>
 </tfoot>
 
+<tbody>
+<row>
+  <entry><para>This is a dummy file to use as a skeleton for writing a new driver. The driver is heavily commented, so refer to the source code.</para></entry>
+</row>
+</tbody>
+
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_drivers.c.xml b/doc/explan_drivers.c.xml
index 12340391..ce25650e 100644
--- a/doc/explan_drivers.c.xml
+++ b/doc/explan_drivers.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: drivers.c 4373 2007-06-01 22:30:43Z esr $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>ssize_t generic_get(struct gps_device_t *session)</function></entry>
@@ -42,12 +48,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: drivers.c 4373 2007-06-01 22:30:43Z esr $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_geoid.c.xml b/doc/explan_geoid.c.xml
index 071e9579..06e4b948 100644
--- a/doc/explan_geoid.c.xml
+++ b/doc/explan_geoid.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: geoid.c 4257 2007-01-18 03:56:43Z ckuethe $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>static double bilinear(double x1, double y1, double x2, double y2, double x, double y, double z11, double z12, double z21, double z22)</function></entry>
@@ -34,12 +40,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: geoid.c 4257 2007-01-18 03:56:43Z ckuethe $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_gps.h.xml b/doc/explan_gps.h.xml
index 43651c0e..5e6c72a1 100644
--- a/doc/explan_gps.h.xml
+++ b/doc/explan_gps.h.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: gps.h 4369 2007-06-01 19:23:17Z esr $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>struct gps_fix_t {}</function></entry>
@@ -26,12 +32,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: gps.h 4369 2007-06-01 19:23:17Z esr $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_gpsd.c.xml b/doc/explan_gpsd.c.xml
index 51b816bc..dca184e8 100644
--- a/doc/explan_gpsd.c.xml
+++ b/doc/explan_gpsd.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: gpsd.c 4418 2007-09-12 02:47:38Z ckuethe $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>static void onsig(int sig)</function></entry>
@@ -106,12 +112,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: gpsd.c 4418 2007-09-12 02:47:38Z ckuethe $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_gpsd.h.xml b/doc/explan_gpsd.h.xml
index 20ff8fab..55b368f4 100644
--- a/doc/explan_gpsd.h.xml
+++ b/doc/explan_gpsd.h.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: gpsd.h-tail 4383 2007-06-03 21:11:37Z ckuethe $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry spanname='s1' align='left'><para>This file is created at <function>configure</function> time by combining <function>gpsd.h-head</function>, certain configuration options from the auto-generated file <function>gpsd_configure.h</function> and <function>gpsd.h-tail</function>. This file (<function>gpsd.h</function>) should not be edited directly, neither should <function>gpsd.h-head</function>. You should only edit <function>gpsd.h-tail</function> as needed.</para></entry>
@@ -33,12 +39,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: gpsd.h-tail 4383 2007-06-03 21:11:37Z ckuethe $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_gpsd_dbus.c.xml b/doc/explan_gpsd_dbus.c.xml
index ef87deaa..15784cd0 100644
--- a/doc/explan_gpsd_dbus.c.xml
+++ b/doc/explan_gpsd_dbus.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: gpsd_dbus.c 3666 2006-10-26 23:11:51Z ckuethe $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>int initialize_dbus_connection(void)</function></entry>
@@ -22,12 +28,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: gpsd_dbus.c 3666 2006-10-26 23:11:51Z ckuethe $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_gpsutils.c.xml b/doc/explan_gpsutils.c.xml
index aac06e84..bf205a8b 100644
--- a/doc/explan_gpsutils.c.xml
+++ b/doc/explan_gpsutils.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: gpsutils.c 4108 2006-12-08 11:48:31Z esr $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>void gps_clear_fix(struct gps_fix_t *fixp)</function></entry>
@@ -70,12 +76,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: gpsutils.c 4108 2006-12-08 11:48:31Z esr $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_isgps.c.xml b/doc/explan_isgps.c.xml
index 45deb281..7849c39b 100644
--- a/doc/explan_isgps.c.xml
+++ b/doc/explan_isgps.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: isgps.c 4065 2006-12-04 05:31:59Z esr $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>static unsigned char parity_array[]</function></entry>
@@ -38,12 +44,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: isgps.c 4065 2006-12-04 05:31:59Z esr $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_libgps.c.xml b/doc/explan_libgps.c.xml
index ffb2944a..9eb39f99 100644
--- a/doc/explan_libgps.c.xml
+++ b/doc/explan_libgps.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: libgps.c 4377 2007-06-02 14:52:38Z esr $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>char *deg_to_str( enum deg_str_type type,  double f)</function></entry>
@@ -74,12 +80,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: libgps.c 4377 2007-06-02 14:52:38Z esr $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_libgpsd_core.c.xml b/doc/explan_libgpsd_core.c.xml
index 8da9c69f..9c327245 100644
--- a/doc/explan_libgpsd_core.c.xml
+++ b/doc/explan_libgpsd_core.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: libgpsd_core.c 4284 2007-01-27 07:27:42Z ckuethe $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>int gpsd_switch_driver(struct gps_device_t *session, char* typename)</function></entry>
@@ -82,12 +88,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: libgpsd_core.c 4284 2007-01-27 07:27:42Z ckuethe $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_libgpsmm.cpp.xml b/doc/explan_libgpsmm.cpp.xml
index 41627d45..5ad73403 100644
--- a/doc/explan_libgpsmm.cpp.xml
+++ b/doc/explan_libgpsmm.cpp.xml
@@ -5,18 +5,18 @@
 <colspec colname='c2'></colspec>
 <spanspec spanname='s1' namest='c1' nameend='c2'></spanspec>
 
-<tbody>
-<row>
-  <entry><para>C++ class wrapper for the <function>libgps</function> C binding.</para></entry>
-</row>
-</tbody>
-
 <tfoot>
 <row>
   <entry spanname='s1' align='left'>Notes based on <function>$Id: libgpsmm.cpp 4219 2007-01-05 17:44:07Z ckuethe $</function></entry>
 </row>
 </tfoot>
 
+<tbody>
+<row>
+  <entry><para>C++ class wrapper for the <function>libgps</function> C binding.</para></entry>
+</row>
+</tbody>
+
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_libgpsmm.h.xml b/doc/explan_libgpsmm.h.xml
index c13b3d9e..f54092c2 100644
--- a/doc/explan_libgpsmm.h.xml
+++ b/doc/explan_libgpsmm.h.xml
@@ -5,18 +5,18 @@
 <colspec colname='c2'></colspec>
 <spanspec spanname='s1' namest='c1' nameend='c2'></spanspec>
 
-<tbody>
-<row>
-  <entry><para>Headers for <function>libgpsmm.cpp</function>.</para></entry>
-</row>
-</tbody>
-
 <tfoot>
 <row>
   <entry spanname='s1' align='left'>Notes based on <function>$Id: libgpsmm.h 3666 2006-10-26 23:11:51Z ckuethe $</function></entry>
 </row>
 </tfoot>
 
+<tbody>
+<row>
+  <entry><para>Headers for <function>libgpsmm.cpp</function>.</para></entry>
+</row>
+</tbody>
+
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_netlib.c.xml b/doc/explan_netlib.c.xml
index f5a2d7b9..7021eeda 100644
--- a/doc/explan_netlib.c.xml
+++ b/doc/explan_netlib.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: netlib.c 4376 2007-06-02 06:29:26Z esr $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>int netlib_connectsock(const char *host, const char *service, const char *protocol)</function></entry>
@@ -22,12 +28,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: netlib.c 4376 2007-06-02 06:29:26Z esr $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_nmea_parse.c.xml b/doc/explan_nmea_parse.c.xml
index 1d6aa6b7..766ada40 100644
--- a/doc/explan_nmea_parse.c.xml
+++ b/doc/explan_nmea_parse.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: nmea_parse.c 4373 2007-06-01 22:30:43Z esr $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>static void do_lat_lon(char *field[], struct gps_data_t *out)</function></entry>
@@ -74,12 +80,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: nmea_parse.c 4373 2007-06-01 22:30:43Z esr $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_ntpshm.c.xml b/doc/explan_ntpshm.c.xml
index cf74c769..b39bbba8 100644
--- a/doc/explan_ntpshm.c.xml
+++ b/doc/explan_ntpshm.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: ntpshm.c 4412 2007-08-21 15:48:02Z ckuethe $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>static struct shmTime *getShmTime(int unit)</function></entry>
@@ -38,12 +44,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: ntpshm.c 4412 2007-08-21 15:48:02Z ckuethe $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_ntrip.c.xml b/doc/explan_ntrip.c.xml
index 27e42269..a109f47d 100644
--- a/doc/explan_ntrip.c.xml
+++ b/doc/explan_ntrip.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: ntrip.c 3771 2006-11-02 05:15:20Z esr $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>static char *ntrip_field_iterate(char *start, char *prev, const char *eol)</function></entry>
@@ -46,12 +52,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: ntrip.c 3771 2006-11-02 05:15:20Z esr $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_packet.c.xml b/doc/explan_packet.c.xml
index 29b23afc..03d8a705 100644
--- a/doc/explan_packet.c.xml
+++ b/doc/explan_packet.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: packet.c 4377 2007-06-02 14:52:38Z esr $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>static void nextstate(struct gps_packet_t *lexer, unsigned char c)</function></entry>
@@ -30,7 +36,7 @@
 </row>
 <row>
   <entry><function>ssize_t packet_parse(struct gps_packet_t *lexer, size_t fix)</function></entry>
-  <entry><para>Call the <function>nextstate()</function> function to process the available data and set the recognition state correctly.<para>When a packet is matched to a driver, call <function>packet_accept()</function> and <function>packet_discard()</function> to handle the packet. If it is not matched, call <function>packet_discard()</function> and set the state to <quote>GROUND_STATE</quote></para> Return the number of characters handled.</para></entry>
+  <entry><para>Call the <function>nextstate()</function> function to process the available data and set the recognition state correctly.</para><para>When a packet is matched to a driver, call <function>packet_accept()</function> and <function>packet_discard()</function> to handle the packet. If it is not matched, call <function>packet_discard()</function> and set the state to <quote>GROUND_STATE</quote></para><para>Return the number of characters handled.</para></entry>
 </row>
 <row>
   <entry><function>ssize_t packet_get(int fd, struct gps_packet_t *lexer)</function></entry>
@@ -46,12 +52,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: packet.c 4377 2007-06-02 14:52:38Z esr $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_packet_names.h.xml b/doc/explan_packet_names.h.xml
index 0e8da905..a09bd637 100644
--- a/doc/explan_packet_names.h.xml
+++ b/doc/explan_packet_names.h.xml
@@ -5,18 +5,18 @@
 <colspec colname='c2'></colspec>
 <spanspec spanname='s1' namest='c1' nameend='c2'></spanspec>
 
-<tbody>
-<row>
-  <entry><para>This is a file generated by the <quote>make</quote> process from <function>packet_states.h</function>. It takes all the state names in that file and surrounds them with speech marks. These values are read into a table of packet names, <function>state_table[]</function>, in <function>packet.c</function>.</para></entry>
-</row>
-</tbody>
-
 <tfoot>
 <row>
   <entry spanname='s1' align='left'>Notes based on <function>$Id: packet_names.h 4299 2007-03-11 19:51:22Z ckuethe $</function></entry>
 </row>
 </tfoot>
 
+<tbody>
+<row>
+  <entry><para>This is a file generated by the <quote>make</quote> process from <function>packet_states.h</function>. It takes all the state names in that file and surrounds them with speech marks. These values are read into a table of packet names, <function>state_table[]</function>, in <function>packet.c</function>.</para></entry>
+</row>
+</tbody>
+
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_packet_states.h.xml b/doc/explan_packet_states.h.xml
index df3e9e60..4b401fae 100644
--- a/doc/explan_packet_states.h.xml
+++ b/doc/explan_packet_states.h.xml
@@ -2,18 +2,18 @@
 <informaltable frame='all' pgwide='1'>
 <tgroup cols='1'>
 
-<tbody>
-<row>
-  <entry><para>This is a list of every possible state generated by every driver. The inclusion of each driver's states is controlled by <function>#ifdef</function> blocks, so we only include the states for drivers selected for compilation. These form an enumeration list in <function>packet.c</function> which indexes the <function>state_table[]</function> array mentioned in <function>packet_names.h</function>.</para></entry>
-</row>
-</tbody>
-
 <tfoot>
 <row>
   <entry spanname='s1' align='left'>Notes based on <function>$Id: packet_states.h 4299 2007-03-11 19:51:22Z ckuethe $</function></entry>
 </row>
 </tfoot>
 
+<tbody>
+<row>
+  <entry><para>This is a list of every possible state generated by every driver. The inclusion of each driver's states is controlled by <function>#ifdef</function> blocks, so we only include the states for drivers selected for compilation. These form an enumeration list in <function>packet.c</function> which indexes the <function>state_table[]</function> array mentioned in <function>packet_names.h</function>.</para></entry>
+</row>
+</tbody>
+
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_report.c.xml b/doc/explan_report.c.xml
index 83fbd1d0..1474bd6a 100644
--- a/doc/explan_report.c.xml
+++ b/doc/explan_report.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: report.c 3666 2006-10-26 23:11:51Z ckuethe $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>void gpsd_report(int errlevel UNUSED, const char *fmt, ... )</function></entry>
@@ -18,12 +24,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: report.c 3666 2006-10-26 23:11:51Z ckuethe $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_rtcm.c.xml b/doc/explan_rtcm.c.xml
index 24146bf4..c354f7c8 100644
--- a/doc/explan_rtcm.c.xml
+++ b/doc/explan_rtcm.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: rtcm.c 4364 2007-05-31 08:43:23Z esr $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>void rtcm_unpack(struct rtcm_t *tp, char *buf)</function></entry>
@@ -46,12 +52,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: rtcm.c 4364 2007-05-31 08:43:23Z esr $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_serial.c.xml b/doc/explan_serial.c.xml
index aa4fc5ae..46e32212 100644
--- a/doc/explan_serial.c.xml
+++ b/doc/explan_serial.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: serial.c 4405 2007-07-27 16:16:09Z ckuethe $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>void gpsd_tty_init(struct gps_device_t *session)</function></entry>
@@ -55,12 +61,6 @@ Set the HUPCL flag in the original data, write the old data to the port, close t
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: serial.c 4405 2007-07-27 16:16:09Z ckuethe $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_subframe.c.xml b/doc/explan_subframe.c.xml
index 3e186dcd..085fbc07 100644
--- a/doc/explan_subframe.c.xml
+++ b/doc/explan_subframe.c.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: subframe.c 3770 2006-11-02 05:07:11Z esr $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>void gpsd_interpret_subframe(struct gps_device_t *session,unsigned int words[])</function></entry>
@@ -18,12 +24,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: subframe.c 3770 2006-11-02 05:07:11Z esr $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_timebase.h.xml b/doc/explan_timebase.h.xml
index 307bdf43..6c1aec7a 100644
--- a/doc/explan_timebase.h.xml
+++ b/doc/explan_timebase.h.xml
@@ -11,6 +11,12 @@
 </row>
 </thead>
 
+<tfoot>
+<row>
+  <entry spanname='s1' align='left'>Notes based on <function>$Id: timebase.h 4040 2006-12-01 03:41:42Z esr $</function></entry>
+</row>
+</tfoot>
+
 <tbody>
 <row>
   <entry><function>LEAP_SECONDS</function></entry>
@@ -26,12 +32,6 @@
 </row>
 </tbody>
 
-<tfoot>
-<row>
-  <entry spanname='s1' align='left'>Notes based on <function>$Id: timebase.h 4040 2006-12-01 03:41:42Z esr $</function></entry>
-</row>
-</tfoot>
-
 </tgroup>
 </informaltable>
 </sect1>
diff --git a/doc/explan_wrapup.xml b/doc/explan_wrapup.xml
index 74958499..2030a0a1 100644
--- a/doc/explan_wrapup.xml
+++ b/doc/explan_wrapup.xml
@@ -1,4 +1,5 @@
 <sect1 id="signoff">
+<title>Signoff</title>
 <para>Mick Durkin
 &lt;mick.durkin@saunalahti.fi&gt;</para>
 <para>Helsinki</para>