diff options
author | Eric S. Raymond <esr@thyrsus.com> | 2011-03-09 11:08:10 -0500 |
---|---|---|
committer | Eric S. Raymond <esr@thyrsus.com> | 2011-03-09 11:08:10 -0500 |
commit | 73416d9f6d4cd0dfd48fc54c6a2dbaf0d1e7aa75 (patch) | |
tree | 18f374ad2276c2d70b726f857ee475035ec26f00 /www | |
parent | c05acb38412a8e98878243db88a7baf6dcc1cb55 (diff) | |
download | gpsd-73416d9f6d4cd0dfd48fc54c6a2dbaf0d1e7aa75.tar.gz |
Documentation update.
Diffstat (limited to 'www')
-rw-r--r-- | www/client-howto.txt | 15 |
1 files changed, 8 insertions, 7 deletions
diff --git a/www/client-howto.txt b/www/client-howto.txt index bfbb7a7e..204ef755 100644 --- a/www/client-howto.txt +++ b/www/client-howto.txt @@ -1,6 +1,6 @@ = GPSD Client HOWTO = Eric S. Raymond <esr@thyrsus.com> -v1.6, February 2011 +v1.7, March 2011 This document is mastered in asciidoc format. If you are reading it in HTML, you can find the original at @@ -340,9 +340,9 @@ Send wire-protocol commands to the daemon. Deprecated and unstable. |gps_stream() |gpsmm.stream() |gps.stream() | Set watch policy. What you should use instead of send(). |gps_waiting() |gpsmm.waiting() |gps.waiting() | -Nonblocking check to see in input is waiting. +Blocking check with timeout to see in input is waiting. |gps_read() |gpsmm.read() |gps.read() | -Blocking read for data from the daemon. +Nonblocking read for data from the daemon. |gps_close() |gpsmm.~gpsmm() |gps.close() | Close the daemon socket and end the session. |gps_enable_debug() |gpsmm_enable_debug() | | @@ -491,15 +491,16 @@ In major versions before 5: * gps_open() didn't take a third argument; instead, it returned malloc storage. -* The 'read()' method in various bindings was named 'poll()' and had - a different return convention. The name 'poll()' will at some point - be reintroduced as an interface to the wire-protocol POLL command. +* The 'read()' method in various bindings was named 'poll()', blocked + waiting for input, and had a different return convention. The name + 'poll()' will at some point be reintroduced as an interface to the + wire-protocol POLL command. * Clients needed to define a gpsd_report() function for client-side logging if they didn't want code in netlib.c and libgps_core.c to occasionally send messages to stderr. This requirement is now gone. -* There was a set_raw_hook() method ion the C and Python bindings, now gone. +* There was a set_raw_hook() method in the C and Python bindings, now gone. Clients can simply look at the response buffer. See http://gpsd.berlios.de/future.html#api_cleanup[Client API Cleanup] |