Many updates to User Guide, mostly to reflect changes in "click behavior".

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

doc/user_guide/en/make-qso.adoc

@@ -76,11 +76,11 @@ fully automated QSOs.
 
 === VHF Contest Mode
 
-A special *VHF Contest Mode* can be activated for FT8 and MSK144 modes
+A special *NA VHF Contest* mode can be activated for FT8 and MSK144
-by checking a box on the *Settings | Advanced* tab.  This mode is
+modes by checking a box on the main window.  This mode is configured
-configured especially for VHF contests in which four-character grid
+especially for contests in which four-character grid locators are the
-locators are the required exchange.  When *Contest Mode* is active,
+required exchange.  When *NA VHF Contest* mode is active, the standard
-the standard QSO sequence looks like this:
+QSO sequence looks like this:
 
  CQ K1ABC FN42
                       K1ABC W9XYZ EN37

doc/user_guide/en/tutorial-example1.adoc

@@ -16,10 +16,10 @@ image::main-ui.png[align="center",alt="Main UI and Wide Graph"]
 
 Decoding takes place at the end of a receive sequence and proceeds in
 two steps.  The first decode is done at the selected Rx frequency,
-indicated by the U-shaped green marker on the waterfall scale.
+indicated by the U-shaped green marker on the waterfall frequency
-Results appear in both the left (*Band Activity*) and right (*Rx
+scale.  Results appear in both the left (*Band Activity*) and right
-Frequency*) text windows on the main screen. The program then finds
+(*Rx Frequency*) text windows on the main screen. The program then
-and decodes all signals in the selected mode over the displayed
+finds and decodes all signals in the selected mode over the displayed
 frequency range. The red marker on the waterfall scale indicates your
 Tx frequency.
 
@@ -51,8 +51,8 @@ Call* and *DX Grid* entry fields.
 ** The *Tx even* box is checked or cleared appropriately, so that you
 will transmit in the proper (odd or even) minutes.
 
-** The Rx and Tx frequency markers are moved to the frequency of the
+** The Rx frequency marker is moved to the frequency of the CQing
-CQing station.
+station.
 
 ** The *Gen Msg* ("`generated message`") radio button at bottom right 
 of the main window is selected.
@@ -61,23 +61,19 @@ of the main window is selected.
 *Setup* menu, *Enable Tx* would be activated and a transmission would
 start automatically at the proper time.
 
-- Double-click on the decoded message `K1JT N5KDV EM41`,
+** You can modify the double-click behavior by holding down the
-highlighted in red.  Results will be similar to those in the
+*Shift* key to move only the Tx frequency or the *Ctrl* key to move
-previous step, except the Tx frequency (red marker) is not
+both Rx and Tx frequencies.
-moved.  Such messages are usually in response to your own CQ, or from
-a tail-ender, and you probably want your Tx frequency to stay where it
-was.
 
-- By holding down the *Ctrl* key when double-clicking on a decoded
+- Double-click on the decoded message `K1JT N5KDV EM41`, highlighted
-line you can cause both Tx and Rx frequencies to be moved.  This
+in red.  Results will be similar to those in the previous step. The Tx
-behavior can also be forced by checking *Lock Tx=Rx*.
+frequency (red marker) is not moved unless *Shift* or *Ctrl* is held
+down.  Messages highlighted in red are usually in response to your own
+CQ or from a tail-ender, and you probably want your Tx frequency to
+stay where it was.
 
-- Double-click on the message from KF4RWA in either window. He is
+- You can prevent your Tx frequency from being changed by checking the
-sending `73` to K1JT, signifying that the QSO is over.  Most likely
+box *Lock Tx Freq*.
-you want to send 73 to him, so the message `KF4RWA K1JT 73` is
-automatically generated and selected for your next transmission.
-(Alternatively, you might choose to send a free-text message or to
-call CQ again.)
 
 - Click somewhere on the waterfall to set Rx frequency (green marker
 on waterfall scale).

doc/user_guide/en/tutorial-example2.adoc

@@ -1,7 +1,7 @@
 // Status=review
 .Main Window:
 - Select *JT9+JT65* on the *Mode* menu.
-- Toggle the *Tx mode* button to read *Tx JT65*, and set the Tx and Rx
+- Toggle the *Tx mode* button to read *Tx JT65 #*, and set the Tx and Rx
 frequencies to 1718 Hz.
 - Double-click on *Erase* to clear both text windows.
 
@@ -75,18 +75,21 @@ JT9 message from IZ0MIT:
 [width="80%",align="center",cols="^10,2*^8,2*^10,54",options="header"]
 |===
 |UTC|dB|DT|Freq|Mode|Message
-|+2343+|+-7+|+0.3+|+3196+|+@+|+WB8QPG IZ0MIT -11+
+|+2343+|+-8+|+0.3+|+3196+|+@+|+WB8QPG IZ0MIT -11+
 |===
 
 - Scroll back in the *Band Activity* window and double-click on the
-message `CQ DL7ACA JO40`. The program will set *Tx mode* to JT65 and Tx
+message `CQ DL7ACA JO40`. The program will set *Tx mode* to JT65 and
-and Rx frequencies to that of DL7ACA, 975 Hz.  If you had checked
+the Rx frequency to that of DL7ACA, 975 Hz.  If you hold down the
-*Double-click on call sets Tx Enable* on the *Setup* menu, the program
+*Ctrl* key, both Rx and Tx frequencies will be moved.  If you had
-would configure itself to start a QSO with DL7ACA.
+checked *Double-click on call sets Tx Enable* on the *Setup* menu, the
+program would configure itself to begin a transmission and start a QSO
+with DL7ACA.
 
-- Double-click on the decoded JT65 message `CQ TA4A KM37`.  The program
+- Hold *Ctrl* down and double-click on the decoded JT65 message `CQ
-will set Tx mode to JT9 and the Rx and Tx frequencies to 3567 Hz.  The
+TA4A KM37`.  The program will set Tx mode to JT9 and the Rx and Tx
-program is now configured properly for a JT9 QSO with TA4A.
+frequencies to 3567 Hz.  The program is now configured properly for a
+JT9 QSO with TA4A.
 
 .Reopen the First Sample File:
 - Select *File | Open* and navigate to `...\save\samples\130418_1742.wav`.

doc/user_guide/en/tutorial-example3.adoc

@@ -25,34 +25,33 @@ image::ft8_decodes.png[align="left"]
 frequency marker will jump to your selected frequency, and the Rx
 frequency control on the main window will be updated accordingly.
 
-- Do the same thing with the Shift key held down.  Now the red Tx
+- Do the same thing with the *Shift* key held down.  Now the red Tx
 frequency marker and its associated control on the main window will
 follow your frequency selections.
 
-- Do the same thing with the Ctrl key held down.  Now the both colored 
+- Do the same thing with the *Ctrl* key held down.  Now the both colored 
 markers and both spinner controls will follow your selections.
 
 - Double-clicking at any frequency on the waterfall does all the
 things just described and also invokes the decoder in a small range
-around that frequency.  To decode a particular signal, double-click
+around the Rx frequency.  To decode a particular signal, double-click
 near the left edge of its waterfall trace.
 
 - Now double-click on any of the the lines of decoded text in the main
-window.  Unless you have *My Call* set to K1JT or KY7M on the
+window.  All three lines will show the same behavior, setting Rx
-*Settings -> General* tab, all three lines will show the same
+frequency to that of the selected message and leaving Tx frequency
-behavior, setting both RxFreq and TxFreq to the frequency of the
+unchanged.  To change both Rx and Tx frequencies, hold *Ctrl* down
-selected message.  However, if MyCall is set to K1JT then clicking on
+when double-clicking.
-a message directed to K1JT will move only the Rx frequency setting.
+
-This behavior is desirable so that you will not inadvertently change
+NOTE: To avoid QRM from competing callers, it is frequently desirable
-your Tx frequency to that of a tail-ender who called you somewhere
+to answer a CQ on a different frequency from that of the CQing
-else in the FT8 subband.
+station.  Choose a Tx frequency that appears to be not in use.  The
+same is true when you tail-end another QSO.
 
 NOTE: The FT8 decoder can often copy several overlapping signals at
-nearly the same frequency.  However, in crowded band conditions you
+nearly the same frequency.  Keyboard shortcuts *Shift+F11* and
-will often find it advantageous to move off the frequency of the
+*Shift+F12* provide an easy way to move your Tx frequency down or up
-station you are calling.  Keyboard shortcuts *Shift+F11* and
+in 60 Hz steps.
-*Shift+F12* provide an easy way to move your Tx frequency in 60 Hz
-steps.
 
 NOTE: Further helpful tips on FT8 operating procedures are available
 {ft8_tips}.  Thanks to ZL2IFB!

doc/user_guide/en/tutorial-wide-graph-settings.adoc

@@ -9,5 +9,5 @@
 - *Gain* and *Zero* sliders for waterfall and spectrum set near midscale
 - *Spec* = 25%
 
-- Use the mouse to adjust the width of the *Wide Graph* so that its
+- Use the mouse to grab the left or right edge of the *Wide Graph*, and
-upper frequency limit is about 2400 Hz.
+adjust its width so that the upper frequency limit is about 2400 Hz.