Integrate support for automatic reconnect on connection drop.

1 files changed, 13 insertions, 3 deletions

diff --git a/libgps.xml b/libgps.xml
index d54277f9..465b69db 100644
--- a/libgps.xml
+++ b/libgps.xml
@@ -76,9 +76,9 @@ interface that goes through
 and is intended for concurrent use by several applications, and one
 low-level interface that speaks directly with the serial or USB device
 to which the GPS is attached. This page describes the high-level
-interface is safe for multiple applications to use simultaneously; it
-is probably the one you want.  The low-level interface is documented
-at
+interface that is safe for multiple applications to use
+simultaneously; it is probably the one you want.  The low-level
+interface is documented at
 <citerefentry><refentrytitle>libgps</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
 
 <para>Calling <function>gpsd_open()</function> initializes a GPS-data
@@ -106,6 +106,11 @@ user has issued an 'R' or 'W' command with
 to the client.  If the third argument is non-NULL, it is used as a
 hook function to be called on each line of streamed data. </para>
 
+<para>The <function>gpsd_query()</function> and
+<function>gpsd_poll()</function> functions attempt to reconnect to the
+daemon if the connection to it has been lost
+(<errorname>EBADF</errorname> error).</para>
+
 <para>Several member groups within the GPS-data structure have
 last-modified timestamps and change-flag members associated with them;
 these get updated on each query or poll as well.
@@ -127,6 +132,11 @@ released when it is garbage-collected.</para>
 </para>
 </refsect1>
 
+<refsect1 id='bugs'><title>BUGS</title>
+<para>The C reconnect support uses the <varname>errno</varname> global, 
+and is therefore not thread-safe in the presence of frequent reconnects.</para>
+</refsect1>
+
 <refsect1 id='author'><title>AUTHOR</title>
 <para>Eric S. Raymond &lt;esr@thyrsus.com&gt;.</para>
 </refsect1>