[gpsd-dev] [PATCH 1/4] Updating documentation of contrib/

[Sanjeev Gupta]

skyview.php no longer works, since GPSD NG, (2.90)
---
 contrib/README | 22 ++++++++++++++--------
 1 file changed, 14 insertions(+), 8 deletions(-)

diff --git a/contrib/README b/contrib/README
index 849bae4..ef5e2dc 100644
--- a/contrib/README
+++ b/contrib/README
@@ -8,13 +8,6 @@ with a log file. These utilities are not particularly clever - 
they
 merely slurp a tty's output into a file, or spray the contents of a
 file out of a tty.
 
-skyview.php is used to generate pictures of your skyview, and may be
-used to help determine if a given antenna placement is appropriate for
-some purpose. This tool requires about 24hrs worth of "Y" messages and
-outputs an image of accumulated SV position and signal strength. It is
-sometimes entertaining to "see" occulted SVs using multipath. You must
-have the PHP-GD library installed to use this script.
-
 ashctl might be used to reset an uncooperative Ashtech receiver to
 a usable state. For whatever reason sometimes they do not respond to
 a protocol switch command; this spams the receiver with configuration
@@ -44,7 +37,7 @@ to create a snapshot of the current sat view.
 
 ntpoffset generate an estimate of your GPS's offset from a peerstats
 file.  For instructions on how to use this script, see the GPSD Time
-Service HOWTO in this distrubution.
+Service HOWTO in this distrubution, in the www/ subdirectory.
 
 ppscheck watches a specified serial device for changes in handshake lines
 CD, RI, and CTS by running ioctl(...., TIOCMIWAIT, ...) in a loop.  When it
@@ -52,3 +45,16 @@ sees a state change it emits a timestamped line of output 
dumping the state
 of the handshake signals. It's useful for checking whether a device is
 emitting 1PPS.  There is troubleshooting advice in the header comment.
   
+------
+The files below do not work with current versions of gpsd.
+
+[The GPSD protocol changed in 2.90, and messages emitted are no longer
+of the form that this script expects.]
+
+skyview.php is used to generate pictures of your skyview, and may be
+used to help determine if a given antenna placement is appropriate for
+some purpose. This tool requires about 24hrs worth of "Y" messages and
+outputs an image of accumulated SV position and signal strength. It is
+sometimes entertaining to "see" occulted SVs using multipath. You must
+have the PHP-GD library installed to use this script.
+
-- 
2.1.4