Add User Guide text on WSPR band-hopping.

git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@6109 ab8295b8-cf94-4d9e-aec4-7959e3be5d79

doc/common/license.adoc

@@ -1,5 +1,5 @@
 include::./links.adoc[]
-_{prog}_ is free software: you can redistribute it and/or modify
+_{prog}_ is free software: you may redistribute and/or modify it
 under the terms of the GNU General Public License as published by
 the Free Software Foundation, either version 3 of the License, or
 (at your option) any later version.

doc/user_guide/controls-functions-wide-graph.adoc

@@ -42,9 +42,6 @@ is the average spectrum since the start of the present UTC minute.
 *Linear Avg* is useful in JT4 mode, especially when short-form
 messages are used.
 
-for JT9 or JT65; it is intended for use
-with the yet-to-be implemented JT4 mode.)
-
 - Four sliders control reference levels and scaling for waterfall
 colors and the spectrum plot.  Values around midscale are usually
 about right, depending on the input signal level, the chosen palette,

doc/user_guide/new_features.adoc

@@ -27,18 +27,10 @@ particular radios have been removed.
 
 Much work has already been done on Version 1.7 of _WSJT-X_.  (Up to
 now this branch has been called v1.6.1.)  More than 100 people have
-been building this version for themselves, as development progresses,
+been building this version for themselves as development progresses,
-and reporting on their experiences.  The next release will likely have
+and reporting on their experiences.  The next release will offer
-the following features not present in Version 1.6.0, and perhaps
+several ``fast modes'' intended for meteor and ionospheric scatter,
-others as well:
+including a new FEC-enhanced mode called *JTMSK*.  It will also have a
-
+significantly improved JT65 decoder, especially advantageous when used
-- *JTMSK* mode, intended for meteor scatter, ionospheric scatter,
+in crowded HF bands.  Starting with Version 1.7, _WSJT-X_ will no
-aircraft scatter, and the like.  Unlike the FSK441, ISCAT, and JTMS
+longer use the patented, closed-source Koetter-Vardy algorithm.
-modes present in the older program _WSJT_, *JTMSK* uses forward error
-correction and structured messages identical to those in JT4, JT9, and
-JT65.
-
-- A significantly improved decoder for JT65, especially advantageous
-when used in crowded HF bands.  Starting with Version 1.7, _WSJT-X_
-will no longer use the patented, closed-source Koetter-Vardy
-algorithm.

doc/user_guide/wsjtx-main.adoc

@@ -131,7 +131,6 @@ include::tutorial-example2.adoc[]
 == WSPR Mode
 include::wspr.adoc[]
 
-
 [[VHF_AND_UP]]
 == VHF+ Features
 include::vhf-features.adoc[]

doc/user_guide/wspr.adoc

@@ -19,7 +19,54 @@ transmitting) and activate the *Enable Tx* button.
 
 - Select your Tx power (in dBm) from the drop-down list.
 
-- To enable automatic band-hopping, check the indicated box and click
+=== Band Hopping
-*Schedule* to select the bands you will use at each time of day.
+WSPR mode allows those with CAT-controlled radios to investigate
+propagation on many bands without user intervention.  Coordinated
+hopping enables a sizable group of stations around the world to move
+together from band to band, thereby maximizing the chances of
+identifying open propagation paths.
+
+- To enable automatic band-hopping, check the *Band Hopping* box on
+the main window.
+
+- Click *Schedule* to open the *WSPR Band Hopping* window, and select
+the bands you wish to use at each time of day.
 
 image::images/band_hopping.png[align="center",alt="Band Hopping"]
+
+- Band-switching occurs after each 2-minute interval.  Preferred bands
+are identified with time slots in a repeating 20-minute cycle,
+according to the following table:
+
+[width="73%",cols="11,10*^",align="center",options="header"]
+|======================================================================
+|*Band:*       |160 | 80 | 60 | 40 | 30 | 20 | 17 | 15 | 12 | 10
+|*UTC minute:* | 00 | 02 | 04 | 06 | 08 | 10 | 12 | 14 | 16 | 18
+|              | 20 | 22 | 24 | 26 | 28 | 30 | 32 | 34 | 36 | 38
+|              | 40 | 42 | 44 | 46 | 48 | 50 | 52 | 54 | 56 | 58
+|======================================================================
+
+- If the preferred band is not active according to your band-hopping
+schedule, a band will be selected at random from among the active
+bands.
+
+- If the box labeled *Tune* is checked for a particular band, _WSJT-X_
+transmits an unmodulated carrier for several seconds just after
+switching to that band and before the normal Rx or Tx period
+starts. This feature can be used to activate an automatic antenna
+tuner (ATU) to tune a multi-band antenna to the newly selected band.
+
+- Depending on your station and antenna setup, band changes might
+require other switching besides retuning your radio. To make this
+possible in an automated way, whenever _WSJT-X_ executes a successful
+band-change command to a CAT-controlled radio, it looks for a file
+named +user_hardware.bat+, +user_hardware.cmd+, +user_hardware.exe+,
+or +user_hardware+ in the working directory. If one of these is found,
+_WSJT-X_ tries to execute the command
+
+ user_hardware nnn 
+
+- In the above command +nnn+ is the band-designation wavelength in
+meters. You will need to write your own program, script, or batch file
+to do the necessary switching at your station.
+