Updates to User Guide, mostly having to do with Q65.

doc/user_guide/en/acknowledgements.adoc

@@ -2,18 +2,20 @@
 
 The _WSJT_ project was started by *K1JT* in 2001.  Since 2005 it has
 been an Open Source project, which now includes the programs _WSJT_,
-_MAP65_, _WSPR_, _WSJT-X_, and _WSPR-X_.  *G4WJS* (since 2013) and
+_MAP65_, _WSPR_, _WSJT-X_, and _WSPR-X_.  *G4WJS* (since 2013), *K9AN*
-*K9AN* (since 2015) have made major contributions to _WSJT-X_.
+(since 2015), and *IV3NWV* (since 2016) have made major contributions
-Together with K1JT they now form the core development team.
+to _WSJT-X_.  Together with K1JT they now form the core development
+team.  *G4WJS* and *W9MDB* have made major contributiions to _hamlib_,
+on which _WSJT-X_ depends for rig control.
 
 All code in the _WSJT_ project is licensed under the GNU Public
 License (GPL).  Many users of these programs, too numerous to mention
 here individually, have contributed suggestions and advice that have
 greatly aided the development of _WSJT_ and its sister programs.  For
 _WSJT-X_ in particular, we acknowledge contributions from *AC6SL,
-AE4JY, DJ0OT, G3WDG, G4KLA, IV3NWV, IW3RAB, K3WYC, KA6MAL, KA9Q,
+AE4JY, DF2ET, DJ0OT, G3WDG, G4KLA, IW3RAB, K3WYC, KA1GT, KA6MAL, KA9Q,
 KB1ZMX, KD6EKQ, KI7MT, KK1D, ND0B, PY2SDR, VE1SKY, VK3ACF, VK4BDJ,
-VK7MO, W4TI, W4TV, and W9MDB*.  Each of these amateurs has helped to
+VK7MO, W3DJS, W4TI, W4TV, and W9MDB*.  Each of these amateurs has helped to
 bring the program’s design, code, testing, and/or documentation to its
 present state.
 

doc/user_guide/en/introduction.adoc

@@ -5,39 +5,38 @@ radio communication using very weak signals. The first four letters in
 the program name stand for "`**W**eak **S**ignal communication by
 K1**JT**,`" while the suffix "`*-X*`" indicates that _WSJT-X_ started
 as an extended branch of an earlier program, _WSJT_, first released in
-2001.  Bill Somerville, G4WJS, and Steve Franke, K9AN, have been major
+2001.  Bill Somerville, G4WJS, Steve Franke, K9AN, and Nico Palermo,
-contributors to development of _WSJT-X_ since 2013 and 2015, respectively.
+IV3NWV, have been major contributors to development of _WSJT-X_ since
+2013, 2015, and 2016, respectively.
 
 _WSJT-X_ Version {VERSION_MAJOR}.{VERSION_MINOR} offers eleven
 different protocols or modes: *FST4*, *FT4*, *FT8*, *JT4*, *JT9*,
-*JT65*, *Q65*, *MSK144*, *WSPR*, *FST4W*, and *Echo*.  The
+*JT65*, *Q65*, *MSK144*, *WSPR*, *FST4W*, and *Echo*.  The first seven
-first seven are designed for making reliable QSOs under weak-signal
+are designed for making reliable QSOs under weak-signal
 conditions. They use nearly identical message structure and source
 encoding.  JT65 was designed for EME ("`moonbounce`") on VHF and
-higher bands and is mostly used for that purpose today.  Q65 replaces
+higher bands and is mostly used for that purpose today.  Q65 is
-an earlier mode, QRA64.  Q65 is particularly effective for tropospheric
+particularly effective for tropospheric scatter, rain scatter,
-scatter, rain scatter, ionospheric scatter, TEP, and EME on VHF and
+ionospheric scatter, TEP, and EME on VHF and higher bands, as well as
-higher bands, as well as other types of fast-fading signals.  JT9 was
+other types of fast-fading signals.  JT9 was designed for the HF and
-originally designed for the HF and lower bands.  Its submode JT9A is 1
+lower bands.  Its submode JT9A is 1 dB more sensitive than JT65 while
-dB more sensitive than JT65 while using less than 10% of the
+using less than 10% of the bandwidth.  JT4 offers a wide variety of
-bandwidth.  JT4 offers a wide variety of tone spacings and has proven
+tone spacings and has proven highly effective for EME on microwave
-highly effective for EME on microwave bands up to 24 GHz.  These four
+bands up to 24 GHz.  The "`slow`" modes use timed sequences of
-"`slow`" modes use one-minute timed sequences of alternating
+alternating transmission and reception.  JT4, JT9, and JT65 use
-transmission and reception, so a minimal QSO takes four to six minutes
+one-minute sequences, so a minimal QSO takes four to six minutes — two
-— two or three transmissions by each station, one sending in odd UTC
+or three transmissions by each station, one sending in odd UTC minutes
-minutes and the other even.  FT8 is operationally similar but four
+and the other even.  FT8 is four times faster (15-second T/R
-times faster (15-second T/R sequences) and less sensitive by a few dB.
+sequences) and less sensitive by a few dB.  FT4 is faster still (7.5 s
-FT4 is faster still (7.5 s T/R sequences) and especially well-suited
+T/R sequences) and especially well-suited for radio contesting.  FST4
-for radio contesting.  FST4 was added to _WSJT-X_ in version 2.3.0.
+is designed especially for the LF and MF bands.  Both FST4 and Q65
-It is intended especially for use on the LF and MF bands, and already
+offer a wide variety of timed sequence lengths, and Q65 a range of
-during its first few months of testing intercontinental paths have
+tone spacings for different propagation conditions.  On the HF bands,
-been spanned many times on the 2200 and 630 m bands.  Further details
+world-wide QSOs are possible with any of these modes using power
-can be found in the following section, <<NEW_FEATURES,New Features in
+levels of a few watts (or even milliwatts) and compromise antennas.
-Version 2.4.0>>.  On the HF bands, world-wide QSOs are possible with
+On VHF bands and higher, QSOs are possible (by EME, scatter, and other
-any of these modes using power levels of a few watts (or even
+propagation types) at signal levels 10 to 15 dB below those required
-milliwatts) and compromise antennas.  On VHF bands and higher, QSOs
+for CW.
-are possible (by EME, scatter, and other propagation types) at signal
-levels 10 to 15 dB below those required for CW.
 
 *MSK144*, and optionally submodes *JT9E-H* are "`fast`"
 protocols designed to take advantage of brief signal enhancements from

doc/user_guide/en/make-qso.adoc

@@ -75,8 +75,8 @@ responder to your CQ.
 
 NOTE: When *Auto-Seq* is enabled, the program de-activates *Enable Tx*
 at the end of each QSO.  It is not intended that _WSJT-X_ should make
-fully automated QSOs.  *Auto-sequencing is an operator aid, not an
+fully automated QSOs.  Auto-sequencing is an operator aid, not an
-operator replacement.*
+operator replacement.
 
 [[CONTEST_MSGS]]
 === Contest Messages
@@ -159,9 +159,9 @@ guidelines for contest logging with FT4, FT8, and MSK144:
 [[COMP-CALL]] 
 === Nonstandard Callsigns
 
-*FST4, FT4, FT8, MSK144, and Q65*
+*Modes with 77-bit message payloads: FST4, FT4, FT8, MSK144, and Q65*
 
-Compound callsigns like xx/K1ABC or K1ABC/x and special event
+Compound callsigns like PJ4/K1ABC or K1ABC/3 and special event
 callsigns like YW18FIFA are supported for normal QSOs but not for 
 contest-style messages.  Model QSOs look something like this:
 
@@ -195,7 +195,7 @@ the types of information that can be included in a message.  It
 prevents including your locator in standard messages, which
 necessarily impairs the usefulness of tools like PSK Reporter.
 
-*JT4, JT9, and JT65*
+*Modes with 72-bit message payloads: JT4, JT9, and JT65*
 
 In the 72-bit modes, compound callsigns are handled in one of two
 possible ways:

doc/user_guide/en/protocols.adoc

@@ -175,19 +175,20 @@ separation is 110250/4096 = 26.92 Hz multiplied by n for JT65A, with n
 Q65 is intended for scatter, EME, and other extreme weak-signal
 applications.  Forward error correction (FEC) uses a specially
 designed (65,15) block code with six-bit symbols.  Two symbols are
-“punctured” from the code, yielding an effective (63,13) code with a
+“punctured” from the code and not transmitted, thereby yielding an
-payload of k = 13 information symbols conveyed by n = 63 channel
+effective (63,13) code with a payload of k = 13 information symbols
-symbols.  The punctured symbols consist of a 12-bit CRC computed from
+conveyed by n = 63 channel symbols.  The punctured symbols consist of
-the 13 information symbols.  The CRC is used to reduce the
+a 12-bit CRC computed from the 13 information symbols.  The CRC is
-false-decode rate to a very low value.  A 22-symbol pseudo-random
+used to reduce the false-decode rate to a very low value.  A 22-symbol
-sequence spread throughout a transmission is sent as “tone 0” and used
+pseudorandom sequence spread throughout a transmission is sent as
-for synchronization.  The total number of channel symbols in a Q65
+“tone 0” and used for synchronization.  The total number of channel
-transmission is thus 63 + 22 = 85.
+symbols in a Q65 transmission is thus 63 + 22 = 85.  Q65 offers T/R
-
+sequence lengths of 15, 30, 60, 120, and 300 s, and submodes A - E
-For each T/R sequence length, submodes A - E have tone spacings and
+have tone spacings 1, 2, 4, 8, and 16 times the symbol rate.  Submode
-occupied bandwidths 1, 2, 4, 8, and 16 times those specified in the
+designations include a number for sequence length and a letter for
-above table.  Full submode designations include a number for sequence
+tone spacing, as in Q65-15A, Q65-120C, etc.  Occupied bandwidths are
-length and a letter for tone spacing, as in Q65-15A, Q65-120C, etc.
+65 times the tone spacing, ranging from 19 Hz (Q65-300A) to a maximum
+of 1733 Hz (Q65-15C, Q65-30D, and Q65-60E).  
 
 [[WSPR_PROTOCOL]]
 ==== WSPR

doc/user_guide/en/transceiver-setup.adoc

@@ -26,13 +26,7 @@ TIP: The PC audio mixer normally has two sliders, one for each
 
 - If your transceiver offers more than one bandwidth setting in USB
   mode, it may be advantageous to choose the widest one possible, up
-  to about 5 kHz.  This choice has the desirable effect of allowing
+  to about 5 kHz. 
-  the *Wide Graph* (waterfall and 2D spectrum) to display the
-  conventional JT65 and JT9 sub-bands simultaneously on most HF bands.
-  Further details are provided in the <<TUTORIAL,Basic Operating
-  Tutorial>>.  A wider displayed bandwidth may also be helpful at VHF
-  and above, where FT8, JT4, JT65, and Q65 signals may be found over
-  much wider ranges of frequencies.
 
 - If you have only a standard SSB filter you won’t be able to display
   more than about 2.7 kHz bandwidth.  Depending on the exact dial

doc/user_guide/en/vhf-features.adoc

@@ -1,15 +1,15 @@
 _WSJT-X_ supports a number of features designed for use on the VHF and
 higher bands.  These features include:
 
-- *FT4*, designed especially for contesting
+- *FT4*, for contesting
 
-- *FT8*, designed for making fast QSOs with weak, fading signals
+- *FT8*, for fast QSOs with weak, fading signals
 
-- *JT4*, particularly useful for EME on the microwave bands
+- *JT4*, for EME on the microwave bands
 
-- *JT9 fast modes*, useful for scatter propagation on VHF bands
+- *JT9 fast modes*, for scatter propagation on VHF bands
 
-- *JT65*, widely used for EME on VHF and higher bands
+- *JT65*, for EME on VHF and higher bands
 
 - *Q65*, for ionospheric scatter, tropospheric scatter, rain scatter, 
 TEP, and EME
@@ -175,24 +175,22 @@ image::JT65B.png[align="center",alt="JT65B"]
 
 === Q65
 
-Q65 is designed for propagation paths that produce fast fading
+Q65 is designed for fast-fading signals: tropospheric scatter, rain
-signals: tropospheric scatter, rain scatter, ionospheric scatter,
+scatter, ionospheric scatter, trans-equatorial propagation (TEP), EME,
-trans-equatorial propagation (TEP), EME, and the like.  The following
+and the like.  The following screen shot shows a series of ionospheric
-screen shot shows a series of ionospheric scatter QSOs using submode
+scatter QSOs using submode Q65-30A on the 6 meter band.  The received
-Q65-30A on the 6 meter band.  The received signals were barely audible
+signals were barely audible most of the time.
-most of the time.
 
 image::Q65_6m_ionoscatter.png[align="center",alt="Q65"]
 
-The Q65 decoder makes no use of a callsign database.  Instead, it
+The Q65 decoder takes advantage of _a priori_ (AP) information such as
-takes advantage of _a priori_ (AP) information such as one's own
+the encoded forms of one's own callsign and the message word `CQ`.  In
-callsign and the message word `CQ`.  In normal usage, as a QSO
+normal usage, as a QSO progresses AP information increases to include
-progresses the available AP information increases to include the
+the callsign of the station being worked and perhaps his/her 4-digit
-callsign of the station being worked and perhaps also his/her 4-digit
 grid locator.  The decoder takes advantage of whatever AP information
-is available.  
+is currently available.
 
-For Q65 EME QSOs, particularly on the microwave bands, some operators
+For Q65 EME QSOs on the microwave bands, some operators
 use short-form messages consisting of a single tone.  To activate
 automatic generation of these messages, check the box labeled *Sh*.
 This also enables the generation of a single tone at 1000Hz by
@@ -318,11 +316,12 @@ image::echo_144.png[align="center",alt="Echo 144 MHz"]
 
 Until the advent of Q65, digital EME has mostly been done using JT65A
 on the 50 MHz band, JT65B on 144 and 432 MHz, and JT65C on 1296 MHz.
-On higher microwave bands typical choices have been JT65C or one of
+On higher microwave bands typical choices have been JT65C, one of the
-the wider QRA64 or JT4 submodes, depending on the expected amount of
+wider JT4 submodes, or QRA64, depending on the expected amount of
-Doppler spread.  We now recommend a suitable submodes of Q65 for EME
+Doppler spread.  We now recommend a suitable submode of Q65 (which has
-on all bands: for example, Q65-60A on 50 and 144 MHz, -60B on
+replaced QRA64) for EME on any VHF or higher band: for example,
-432 MHz, -60C on 1296 MHz, and -60D on 10 GHz.
+Q65-60A on 50 and 144 MHz, Q65-60B on 432 MHz, Q65-60C on 1296 MHz,
+and Q65-60D on 10 GHz.
 
 JT4, JT65, and Q65 offer *Message Averaging* -- the summation of
 subsequent transmissions that convey the same message -- to enable