Add and document some client-side instrumentation.

1 files changed, 8 insertions, 0 deletions

diff --git a/gps.xml b/gps.xml
index 561cf4cf..a5d3e956 100644
--- a/gps.xml
+++ b/gps.xml
@@ -22,6 +22,7 @@
 <cmdsynopsis>
   <command>xgps</command>  
       <arg choice='opt'><replaceable>X-options</replaceable></arg>
+      <arg choice='opt'>-d <replaceable>debug-level</replaceable></arg>
       <arg choice='opt'>-h </arg>
       <arg choice='opt'>-V </arg>
       <arg choice='opt'>-speedunits <group choice='req'><arg>mph</arg><arg>kph</arg><arg>knots</arg></group></arg>
@@ -38,6 +39,7 @@
 <cmdsynopsis>
   <command>xgpsspeed</command> <arg choice='opt'>-rv</arg> 
       <arg choice='opt'><replaceable>X-options</replaceable></arg>
+      <arg choice='opt'>-d <replaceable>debug-level</replaceable></arg>
       <arg choice='opt'>-h </arg> 
       <arg choice='opt'>-V </arg> <arg
       choice='opt'>-nc <replaceable>X-color</replaceable></arg> <arg
@@ -53,6 +55,8 @@
 </cmdsynopsis>
 <cmdsynopsis>
   <command>cgps</command>  
+      <arg choice='opt'><replaceable>X-options</replaceable></arg>
+      <arg choice='opt'>-d <replaceable>debug-level</replaceable></arg>
       <arg choice='opt'>-h </arg>
       <arg choice='opt'>-V </arg>
       <arg choice='opt'>-speedunits <group choice='req'><arg>mph</arg><arg>kph</arg><arg>knots</arg></group></arg>
@@ -117,6 +121,10 @@ degrees and is the default.  The value 'm' produces degrees and
 decimal minutes.  The value 's' produces degrees, minutes, and decimal
 seconds.</para>
 
+<para> The <option>-d</option> option, when present, sets a debug
+level; it is primarily for usee by GPSD developers.  It enables
+various progress messages to standard error.</para>
+
 <para>An optional argument to any client may specify a server to get
 data from; a colon-separated suffix is taken as a port number. If
 there is a second colon-separated suffix, that is taken as a device