Changes to WSJT-X User Guide for v1.5.

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

doc/user_guide/controls-functions-center.adoc

@@ -9,7 +9,7 @@ image::images/misc-controls-center.png[align="center",alt="Misc Controls Center"
 * Check *Tx even* to transmit in even-numbered UTC minutes.  Uncheck
 this box to transmit in the odd minutes.  This selection is made
 automatically when you double-click on a decoded text line, as
-described in the <<X5,Basic Operating Tutorial>>.
+described in the <<TUTORIAL,Basic Operating Tutorial>>.
 
 * The Tx and Rx audio frequencies are usually set automatically by
 double-clicking on decoded text or a signal in the waterfall.  They 

doc/user_guide/controls-functions-left.adoc

@@ -25,9 +25,10 @@ square contains the character S if the rig is detected to be in
 *Split* mode.  The square becomes red if you have requested CAT
 control but communication with the radio has been lost.
 
-IMPORTANT: Many Icom rigs cannot be queried for split status, so you
-should not change the split status using rig controls when using
-_WSJT-X_.
+IMPORTANT: Many Icom rigs cannot be queried for split status, current
+VFO or split transmit frequency.  Consequently you should not change
+the current VFO, split status or frequency using controls on the radio
+when using _WSJT-X_.
 
 * If *DX Grid* contains a valid Maidenhead locator, the corresponding
 great-circle azimuth and distance from your location are displayed.

doc/user_guide/install-linux.adoc

@@ -9,13 +9,13 @@
 - Uninstall:  +sudo dpkg -P wsjtx+
 ** You may also need to execute the following commands in a terminal:
 
-* For Ubuntu 15.04 and similar systems:
-+
-=====
-sudo apt-get install libqt5multimedia5-plugins libqt5serialport5
+ sudo apt-get install libqt5multimedia5-plugins libqt5serialport5 
+ sudo apt-get install libfftw3-single3
 
-sudo apt-get install libfftw3-single3 libqt5opengl5 
-=====
+* For Ubuntu 15.04 and similar systems:
+
+ sudo apt-get install libqt5multimedia5-plugins libqt5serialport5
+ sudo apt-get install libfftw3-single3 libqt5opengl5 
 
 * For Fedora, Red Hat, and other rpm-based systems:
 ** 32-bit: {fedora32}
@@ -25,13 +25,15 @@ sudo apt-get install libfftw3-single3 libqt5opengl5
 - To install: +sudo rpm -i wsjtx-{VERSION}-x86_64.rpm+
 - Uninstall: +sudo rpm -e wsjtx+
 ** You may also need to execute the following commands in a terminal:
-+
-=====
-sudo yum install fftw-libs-single qt5-qtmultimedia qt5-qtserialport 
-=====
 
-* Linux users must install a companion program called *kvasd*.  
-Instructions for a simple, quick menu-driven installation may be 
-found {kvasd-installer}.
+ sudo yum install fftw-libs-single qt5-qtmultimedia qt5-qtserialport 
+
+* All Linux users should install a companion program called +kvasd+,
+the Koetter-Vardy algebraic soft-decision Reed Solomon decoder.  
+Execute the following commands from a terminal:
+
+ sudo add-apt-repository ppa:ki7mt/kvasd-installer
+ sudo apt-get update
+ sudo apt-get install kvasd-installer
+ kvasd-installer
 
-// Add instructions about ntpd and sound setup ?

doc/user_guide/settings-general.adoc

@@ -11,4 +11,4 @@ self-explanatory after you have made some QSOs using _WSJT-X_.  You
 may return to set these options to your preferences later.  
 
 IMPORTANT: If you are using a callsign with an add-on prefix or suffix,
-be sure to read the section <<COMP_CALL,Compound Callsigns>>.
+be sure to read the section <<COMP-CALL,Compound Callsigns>>.

doc/user_guide/settings-radio.adoc

@@ -36,13 +36,14 @@ than though another program, make the following settings:
 *Stop Bits*, and *Handshake* method.  Consult your radio's user guide
 for the proper parameter values.
 
-* _Force Control Lines_: A few station setups require the serial
-port's *RTS* and/or *DTR* control lines to be forced high.  Check
-these boxes only if you are sure they are needed.
+* _Force Control Lines_: A few station setups require the CAT serial
+port’s *RTS* and/or *DTR* control lines to be forced high or
+low. Check these boxes only if you are sure they are needed.
 
 - _PTT Method_: select *VOX*, *CAT*, *DTR*, or *RTS* as the desired
 method for T/R switching.  If your choice is *DTR* or *RTS*, select
-the desired serial port.
+the desired serial port (which may be the same one as used for
+CAT control).
 
 - _Transmit Audio Source_: some radios permit you to choose the
 connector that will accept Tx audio.  If this choice is enabled,

doc/user_guide/tutorial-main-window.adoc

@@ -10,3 +10,7 @@ up/down arrows.
 
 - Select *Tab 2* (below the *Decode* button) to choose the alternative
 set of controls for generating and selecting Tx messages.
+
+IMPORTANT: Sliders and spin-box controls respond to arrow key presses
+and Page Up/Down key presses, with the Page keys moving the controls
+in larger steps.

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

@@ -5,10 +5,10 @@
 - *Start* = 200
 - *N Avg* = 5
 - *Zero* = 0
-- *Gain* = 0,
+- *Gain* = 0
 - *Palette* = Digipan
 - *Flatten* = checked
 - Select *Cumulative* for data display.
 
 - Use the mouse to adjust the width of the *Wide Graph* so that its
-upper frequency limit is about 2400 Hz.
+upper frequency limit is about 2400 Hz.

doc/user_guide/wsjtx-main.adoc

@@ -130,11 +130,11 @@ include::controls-functions-wide-graph.adoc[]
 include::controls-functions-main-window.adoc[]
 
 [[CONTROLS_LEFT]]
-=== Misc Controls Left
+=== Controls Left
 include::controls-functions-left.adoc[]
 
 [[CONTROLS_CENTER]]
-=== Misc Controls Center
+=== Controls Center
 include::controls-functions-center.adoc[]
 
 [[CONTROLS_MSGS]]