User guide updates

doc/common/links.adoc

@@ -12,14 +12,14 @@ Example:
 [displayed text] PSK Reporter
 
 Perform searches from the doc root directory: doc
-Search: grep -rl --exclude-dir="*\.svn" {pskreporter} .
+Search: grep -rl --exclude-dir="*\.git" {pskreporter} .
-	grep -rl --exclude-dir="*\.svn" PSK Reporter .
+	grep -rl --exclude-dir="*\.git" PSK Reporter .
-	grep -rl --exclude-dir="*\.svn" {devsvn} .
+	grep -rl --exclude-dir="*\.git" {devrepo} .
-        grep -rl --exclude-dir="*\.svn" {kvasd} .
+        grep -rl --exclude-dir="*\.git" {kvasd} .
-        grep -rl --exclude-dir="*\.svn" {ntpsetup} .
+        grep -rl --exclude-dir="*\.git" {ntpsetup} .
 
-Include links.adoc: grep -rl --exclude-dir="*\.svn" pskreporter .
+Include links.adoc: grep -rl --exclude-dir="*\.git" pskreporter .
-Exclude links.adoc: grep -rl --exclude-dir="*\.svn" {pskreporter} .
+Exclude links.adoc: grep -rl --exclude-dir="*\.git" {pskreporter} .
 
 Note(s):
 a). Don't forget a space then "." at the end.
@@ -54,8 +54,8 @@ d). Edit lines as needed. Keeping them in alphabetic order help see dupes.
 :raspbian: http://physics.princeton.edu/pulsar/K1JT/wsjtx_{VERSION}_armhf.deb[wsjtx_{VERSION}_armhf.deb]
 :debian: http://www.debian.org/[Debian]
 :dev_guide: http://www.physics.princeton.edu/pulsar/K1JT/wsjtx-doc/wsjt-dev-guide.html[Dev-Guide]
-:devsvn1: http://sourceforge.net/p/wsjt/wsjt/HEAD/tree/[Devel-SVN]
+:devsvn: http://sourceforge.net/p/wsjt/wsjt/HEAD/tree/[Devel-SVN]
-:devsvn: http://sourceforge.net/p/wsjt/wsjt/HEAD/tree/[SourceForge]
+:devrepo: https://sourceforge.net/p/wsjt/wsjtx/ci/master/tree/[SourceForge]
 :dimension4: http://www.thinkman.com/dimension4/[Thinking Man Software]
 :download: http://physics.princeton.edu/pulsar/K1JT/wsjtx.html[Download Page]
 :dxatlas: http://www.dxatlas.com/[Afreet Software, Inc.]
@@ -80,6 +80,7 @@ d). Edit lines as needed. Keeping them in alphabetic order help see dupes.
 :lunarEchoes: http://physics.princeton.edu/pulsar/K1JT/LunarEchoes_QEX.pdf[QEX]
 :msk144: http://physics.princeton.edu/pulsar/k1jt/MSK144_Protocol_QEX.pdf[QEX]
 :msys_url: http://sourceforge.net/projects/mingwbuilds/files/external-binary-packages/[MSYS Download]
+:n1mm_logger: https://n1mm.hamdocs.com/tiki-index.php[N1MM Logger+]
 :ntpsetup: http://www.satsignal.eu/ntp/setup.html[Network Time Protocol Setup]
 :osx_instructions: http://physics.princeton.edu/pulsar/K1JT/OSX_Readme[Mac OS X Install Instructions]
 :ppa: http://en.wikipedia.org/wiki/Personal_Package_Archive[PPA]
@@ -88,6 +89,7 @@ d). Edit lines as needed. Keeping them in alphabetic order help see dupes.
 :sourceforge: https://sourceforge.net/user/registration[SourceForge]
 :sourceforge-jtsdk: https://sourceforge.net/projects/jtsdk[SourceForge JTSDK]
 :ubuntu_sdk: https://launchpad.net/~ubuntu-sdk-team/+archive/ppa[Ubuntu SDK Notice]
+:writelog: https://writelog.com/[Writelog]
 :wsjt_yahoo_group: https://groups.yahoo.com/neo/groups/wsjtgroup/info[WSJT Group]
 :wsjtx: http://physics.princeton.edu/pulsar/K1JT/wsjtx.html[WSJT-X]
 :wspr0_guide: http://www.physics.princeton.edu/pulsar/K1JT/WSPR0_Instructions.TXT[WSPR0 Guide]
@@ -111,9 +113,9 @@ d). Edit lines as needed. Keeping them in alphabetic order help see dupes.
 :svn: http://subversion.apache.org/packages.html#windows[Subversion]
 :win32: http://physics.princeton.edu/pulsar/K1JT/wsjtx-{VERSION}-win32.exe[wsjtx-{VERSION}-win32.exe]
 :wsjt-devel: https://lists.sourceforge.net/lists/listinfo/wsjt-devel[here]
-:wsjt_svn: http://sourceforge.net/p/wsjt/wsjt/HEAD/tree/[WSJT Source Repository]
+:wsjt_repo: https://sourceforge.net/p/wsjt/wsjt_orig/ci/master/tree/[WSJT Source Repository]
 :wspr_code: http://physics.princeton.edu/pulsar/K1JT/WSPRcode.exe[WSPRcode.exe]
-:wspr_svn: http://sourceforge.net/p/wsjt/wsjt/HEAD/tree/branches/wspr/[WSPR Source Repository]
+:wspr_svn: https://sourceforge.net/p/wsjt/wspr/ci/master/tree/[WSPR Source Repository]
 
 // MAIL-TO links
 :alex_efros: mailto:powerman@powerman.name[Alex Efros]

doc/user_guide/en/controls-functions-center.adoc

@@ -36,6 +36,8 @@ inserted automatically. Typical reports for the various modes fall in
 the range –30 to +20 dB.  Remember that JT65 reports saturate at an
 upper limit of -1 dB.
 
++
+
 TIP: Consider reducing power if your QSO partner reports your
 signal above -5 dB in one of the _WSJT-X_ slow modes.  These are
 supposed to be weak signal modes!

doc/user_guide/en/controls-functions-left.adoc

@@ -28,6 +28,8 @@ if the rig is detected to be in *Split* mode.  The circle becomes red
 if you have requested CAT control but communication with the radio has
 been lost.
 
++
+
 TIP: Many Icom rigs cannot be queried for split status, current VFO or
 split transmit frequency. When using _WSJT-X_ with such radios you
 should not change the current VFO, split status or dial frequency

doc/user_guide/en/controls-functions-main-window.adoc

@@ -36,6 +36,8 @@ the original frequency.
 * *Erase* clears the right-hand decoded text window. 
 Double-clicking *Erase* clears both text windows.
 
++
+
 TIP: Right-clicking on either text window brings up a context menu
 with several options (including *Erase*) which operate on that window
 alone.

doc/user_guide/en/controls-functions-messages.adoc

@@ -56,6 +56,8 @@ spaces) in the *Free Msg* box.
 pre-stored macro.  Pressing *Enter* on a modified message here
 automatically adds that message to the table of stored macros.
 
++
+
 TIP: During a transmission the actual message being sent always
 appears in the first box of the status bar (bottom left of the main
 screen).

doc/user_guide/en/controls-functions-status-bar.adoc

@@ -21,3 +21,5 @@ the elapsed fraction of a Tx or Rx sequence.  Finally, if the Watchdog
 lower right-hand corner displays the number of minutes remaining
 before timeout.
 
+TIP: Temporary status messages may occasionally be displayed here for
+a few seconds when background processing completes.

doc/user_guide/en/cooperating-programs.adoc

@@ -37,3 +37,11 @@ current band, as well as other options.
 logging applications Aether, MacLoggerDX, RUMlog or RUMlogNG.  It
 checks QSO and QSL status of the call and DXCC entity, as well as many
 other features.
+
+* {n1mm_logger} is a free full feature contest logging application. It
+  is only available for Windows. _WSJT-X_ can send logged QSO
+  information to it via a network connection.
+
+* {writelog} is a non-free full feature contest logging
+  application. It is only available for Windows. _WSJT-X_ can send
+  logged QSO information to it via a network connection.

doc/user_guide/en/faq.adoc

@@ -47,6 +47,22 @@ location for each instance of _WSJT-X_.
  wsjtx --rig-name=TS2000
  wsjtx --rig-name=FT847
 
+I occasionally get Rig Control Errors if I adjust my Icom rig's VFO. What's wrong?::
+
+By default most Icom transceivers have *CI-V Tranceive Mode" enabled,
+this will cause unsolicited CAT traffic from the rig that disrupts CAT
+control by a PC. Disable this option in the rig's menu.
+
+I want to control my transceiver with another application as well as _WSJT-X_, is that possible?::
+
+This only possible to do reliably via some kind of rig control server,
+that server must be able to accept both _WSJT-X_ and the other
+application(s) as clients. Using a dumb serial port splitter like the
+VSPE tool is not supported, it may work but it is not reliable due to
+unmanaged CAT control collisions. Applications like the _Hamlib Rig
+Control Server (rigctld)_, _{omnirig}_, and _{dxlsuite} Commander_ are
+potentially suitable and _WSJT-X_ can act as a client to them all.
+
 Rig control through _OmniRig_ seems to fail when I click *Test CAT*. What can I do about it?::
 
 _Omni-Rig_ apparently has a bug that appears when you click *Test

doc/user_guide/en/install-from-source.adoc

@@ -1,10 +1,10 @@
 // Status=review
 
 Source code for _WSJT-X_ is available from a public repository at
-{devsvn}. To compile the program you will need to install at least the
+{devrepo}. To compile the program you will need to install at least the
 following packages:
 
-- Subversion 1.8 or later
+- Git
 - Qt 5.2 or later
 - g++ 4.8 or later
 - gfortran 4.8 or later
@@ -14,13 +14,15 @@ following packages:
 Source code for _WSJT-X_ v{VERSION} can be downloaded with the command:
 
 =====
-svn co svn://svn.code.sf.net/p/wsjt/wsjt/tags/wsjtx-{VERSION}
+git clone git://git.code.sf.net/p/wsjt/wsjtx
+cd wsjtx
+git checkout wsjtx-{VERSION}
 =====
 
 and for the current development branch,
 
 =====
-svn co svn://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx
+git clone git://git.code.sf.net/p/wsjt/wsjtx
 =====
 
 If you are interested in contributing to the development and

doc/user_guide/en/install-linux.adoc

@@ -2,6 +2,16 @@
 
 Debian, Ubuntu, and other Debian-based systems including Raspbian:
 
+NOTE: The project team release binary installer packages for Linux
+when a new _WSJT-X_ release is announced, note that these are built to
+target one contemporary version of a Linux distribution. Although
+these may work on newer Linux versions or even different
+distributions, it is unlikely that they will work on older
+versions. Check the notes provided with the release for details of the
+targeted Linux distributions and versions. If the binary package is
+not compatible with your Linux distribution or version you must build
+the application from sources.
+
 * 32-bit: {debian32}
 - To install:
 +
@@ -33,9 +43,9 @@ sudo dpkg -P wsjtx
 You may also need to execute the following command in a terminal:
 
 [example]
-sudo apt install libqt5multimedia5-plugins libqt5serialport5 libfftw3-single3
+sudo apt install libqt5multimedia5-plugins libqt5serialport5 libqt5sql5-sqlite libfftw3-single3
 
-Fedora, Red Hat, and other rpm-based systems:
+Fedora, CentOS, Red Hat, and other rpm-based systems:
 
 * 32-bit: {fedora32}
 - To install:

doc/user_guide/en/install-mac.adoc

@@ -6,7 +6,7 @@ installation notes.
 
 If you have already installed a previous version, you can retain it by
 changing its name in the *Applications* folder (say, from _WSJT-X_ to
-_WSJT-X_1.8_).  You can then proceed to the installation phase.
+_WSJT-X_1.9_).  You can then proceed to the installation phase.
 
 Take note also of the following:
 

doc/user_guide/en/install-windows.adoc

@@ -16,19 +16,23 @@ directory +
 
 TIP: Your computer may be configured so that this directory is
 "`invisible`".  It's there, however, and accessible.  An alternative
-(shortcut) directory name is `%LOCALAPPDATA%\WSJT-X\`.
+(shortcut) directory name is `"%LOCALAPPDATA%\WSJT-X\"`.
 
 - The built-in Windows facility for time synchronization is usually
 not adequate. We recommend the program _Meinberg NTP_ (see {ntpsetup}
 for downloading and installation instructions) or _Dimension 4_ from
-{dimension4}.
+{dimension4}. Recent versions of Windows 10 are now shipped with a
+more capable Internet time synchronization service that is suitable if
+configured appropriately.
 
 - _WSJT-X_ expects your sound card to do its raw sampling at 48000 Hz.
 To ensure that this will be so when running under recent versions of
-Windows, open the system's *Sound* control panel and select in turn the
+Windows, open the system's *Sound* control panel and select in turn
-*Recording* and *Playback* tabs. Click on *Properties*, then
+the *Recording* and *Playback* tabs. Click on *Properties*, then
-*Advanced*, and select *16 bit, 48000 Hz (DVD Quality)*.
+*Advanced*, and select *16 bit, 48000 Hz (DVD Quality)*. Switch of all
+audio enhancement features for these devices.
 
 - You can uninstall _WSJT-X_ by clicking its *Uninstall* link in the
-Windows *Start* menu, or by using *Uninstall a Program* on the
+Windows *Start* menu, or by using *Uninstall a Program* on the Windows
-Windows Control Panel.
+Control Panel Programs and Features option or in Settings Apps on
+Windows 10.

doc/user_guide/en/introduction.adoc

@@ -7,29 +7,30 @@ K1**JT**,`" while the suffix "`-X`" indicates that _WSJT-X_ started as
 an extended and experimental branch of the program
 _WSJT_.
 
-_WSJT-X_ Version 2.0 offers nine different protocols or modes: *FT8*,
+_WSJT-X_ Version {VERSION_MAJOR}.{VERSION_MINOR} offers nine different
-*JT4*, *JT9*, *JT65*, *QRA64*, *ISCAT*, *MSK144*, *WSPR*, and *Echo*.
+protocols or modes: *FT8*, *JT4*, *JT9*, *JT65*, *QRA64*, *ISCAT*,
-The first five are designed for making reliable QSOs under extreme
+*MSK144*, *WSPR*, and *Echo*.  The first five are designed for making
-weak-signal conditions. They use nearly identical message structure
+reliable QSOs under extreme weak-signal conditions. They use nearly
-and source encoding.  JT65 and QRA64 were designed for EME
+identical message structure and source encoding.  JT65 and QRA64 were
-("`moonbounce`") on the VHF/UHF bands and have also proven very
+designed for EME ("`moonbounce`") on the VHF/UHF bands and have also
-effective for worldwide QRP communication on the HF bands.  QRA64 has
+proven very effective for worldwide QRP communication on the HF bands.
-a number of advantages over JT65, including better performance on the
+QRA64 has a number of advantages over JT65, including better
-very weakest signals.  We imagine that over time it may replace JT65
+performance on the very weakest signals.  We imagine that over time it
-for EME use.  JT9 was originally designed for the LF, MF, and lower HF
+may replace JT65 for EME use.  JT9 was originally designed for the LF,
-bands.  Its submode JT9A is 2 dB more sensitive than JT65 while using
+MF, and lower HF bands.  Its submode JT9A is 2 dB more sensitive than
-less than 10% of the bandwidth.  JT4 offers a wide variety of tone
+JT65 while using less than 10% of the bandwidth.  JT4 offers a wide
-spacings and has proven highly effective for EME on microwave bands up
+variety of tone spacings and has proven highly effective for EME on
-to 24 GHz.  These four "`slow`" modes use one-minute timed sequences
+microwave bands up to 24 GHz.  These four "`slow`" modes use
-of alternating transmission and reception, so a minimal QSO takes four
+one-minute timed sequences of alternating transmission and reception,
-to six minutes — two or three transmissions by each station, one
+so a minimal QSO takes four to six minutes — two or three
-sending in odd UTC minutes and the other even.  FT8 is operationally
+transmissions by each station, one sending in odd UTC minutes and the
-similar but four times faster (15-second T/R sequences) and less
+other even.  FT8 is operationally similar but four times faster
-sensitive by a few dB.  On the HF bands, world-wide QSOs are possible
+(15-second T/R sequences) and less sensitive by a few dB.  On the HF
-with any of these modes using power levels of a few watts (or even
+bands, world-wide QSOs are possible with any of these modes using
-milliwatts) and compromise antennas.  On VHF bands and higher, QSOs
+power levels of a few watts (or even milliwatts) and compromise
-are possible (by EME and other propagation types) at signal levels 10
+antennas.  On VHF bands and higher, QSOs are possible (by EME and
-to 15 dB below those required for CW.
+other propagation types) at signal levels 10 to 15 dB below those
+required for CW.
 
 *ISCAT*, *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

@@ -156,8 +156,8 @@ has been received in full in the recent past.  Otherwise it will be
 displayed as < . . . >.  These restrictions are honored automatically
 by the algorithm that generates default messages for minimal QSOs.
 Except for the special cases involving /P or /R used in VHF
-contesting, _WSJT-X 2.0_ offers no support for two nonstandard
+contesting, _WSJT-X {VERSION_MAJOR}.{VERSION_MINOR}_ offers no support
-callsigns to work each other.
+for two nonstandard callsigns to work each other.
 
 *JT4, JT9, JT65, and QRA64*
 

doc/user_guide/en/measurement_tools.adoc

@@ -20,6 +20,8 @@ tab, delete any default frequencies for *FreqCal* mode that are not
 relevant for your location.  You may want to replace some of them with
 reliably known frequencies receivable at your location.
 
++
+
 TIP: We find major-city AM broadcast stations generally serve well as
 frequency calibrators at the low frequency end of the spectrum.  In
 North America we also use the standard time-and-frequency broadcasts

doc/user_guide/en/new_features.adoc

@@ -1,4 +1,4 @@
-=== New in Version 2.0
+=== New in Version {VERSION}
 
 For quick reference, here's a short list of features and capabilities
 added to _WSJT-X_ since Version 1.9.1:
@@ -11,7 +11,7 @@ added to _WSJT-X_ since Version 1.9.1:
 
 * New logging features for contesting
 
-* Integration with N1MM+ and WriteLog for contesting
+* Integration with {n1mm_logger} and {writelog} for contesting
 
 * Improved support for compound and nonstandard callsigns
 
@@ -31,6 +31,9 @@ IMPORTANT: Note that for FT8 and MSK144 there is no backward
 compatibility with WSJT-X 1.9.1 and earlier.  Everyone using these
 modes should upgrade to WSJT-X 2.0 by January 1, 2019.
 
+IMPORTANT: _WSJT-X_ Version 2.0 drops support for Apple Mac OS X 10.9
+(Mavericks). It is possible to build from source for this operating
+system version but the DMG installer package requires 10.10 or later.
 
 
 === Documentation Conventions
@@ -50,10 +53,10 @@ consequences.
 === How You Can Contribute
 
 _WSJT-X_ is part of an open-source project released under the
-{gnu_gpl} (GPL). If you have programming or documentation skills or
+{gnu_gpl} (GPLv3). If you have programming or documentation skills or
 would like to contribute to the project in other ways, please make
 your interests known to the development team.  The project's
-source-code repository can be found at {devsvn}, and communication
+source-code repository can be found at {devrepo}, and communication
 among the developers takes place on the email reflector {devmail}.
 Bug reports and suggestions for new features, improvements to the
 _WSJT-X_ User Guide, etc., may also be sent to the {wsjt_yahoo_group}

doc/user_guide/en/settings-advanced.adoc

@@ -27,6 +27,8 @@ receiver's effective noise bandwidth.
 a larger delay between execution of a command to enable PTT and onset
 of Tx audio.  
 
++
+
 IMPORTANT: For the health of your T/R relays and external
 preamplifier, we strongly recommend using a hardware sequencer and
 testing to make sure that sequencing is correct.

doc/user_guide/en/settings-audio.adoc

@@ -4,18 +4,21 @@ image::settings-audio.png[align="center",alt="_WSJT-X_ Audio Configuration Scree
 
 Select the *Audio* tab to configure your sound system.
 
-- _Soundcard_: Select the audio devices to be used for *Input* and
+* _Soundcard_: Select the audio devices to be used for *Input* and
 *Output*.  Usually the *Mono* settings will suffice, but in special
 cases you can choose *Left*, *Right*, or *Both* stereo channels.
 
-- Be sure that your audio device is configured to sample at 48000 Hz,
+** Be sure that your audio device is configured to sample at 48000 Hz,
 16 bits.
 
++
 
 IMPORTANT: If you select the audio output device that is also your
 computer's default audio device, be sure to turn off all system sounds
 to prevent inadvertently transmitting them over the air.  
 
++
+
 NOTE: Windows Vista and later may configure audio devices using
 the Texas Instruments PCM2900 series CODEC for microphone input rather
 line input.  (This chip is used in many radios with built-in USB
@@ -23,18 +26,20 @@ CODECs, as well as various other audio interfaces.)  If you are using
 such a device, be sure to set the mic level in the Recording Device
 Properties to 0 dB.
 
-- _Save Directory_: _WSJT-X_ can save its received audio sequences as
++
+
+* _Save Directory_: _WSJT-X_ can save its received audio sequences as
 `.wav` files.  A default directory for these files is provided; you
 can select another location if desired.
 
-- _AzEl Directory_: A file named `azel.dat` will appear in the
+* _AzEl Directory_: A file named `azel.dat` will appear in the
 specified directory.  The file contains information usable by another
 program for automatic tracking of the Sun or Moon, as well as
 calculated Doppler shift for the specified EME path.  The file is
 updated once per second whenever the <<ASTRODATA,Astronomical Data>>
 window is displayed.
 
-- _Remember power settings by band_: Checking either of these will
+* _Remember power settings by band_: Checking either of these will
 cause _WSJT-X_ to remember the *Pwr* slider setting for that operation
 on a band-by-band basis.  For example, when *Tune* is checked here and
 you click the *Tune* button on the main window, the power slider will

doc/user_guide/en/settings-colors.adoc

@@ -1,10 +1,47 @@
 image::colors.png[align="center",alt="Colors Screen"]
 
-_WSJT-X_ uses colors to highlight decoded CQ messages of particular
+.Decode Highlighting
-interest.  Check the box *Show DXCC, grid, and worked-before status*
+
-on the *Settings | General* tab, and any boxes of interest to you on
+* _WSJT-X_ uses colors to highlight decoded CQ messages of particular
-the *Colors* tab.  You can drag any line up or down to raise or lower
+  interest.  Check the box *Show DXCC, grid, and worked-before status*
-its logical priority.  Right-click any line to set a new foreground or
+  on the *Settings | General* tab, and any boxes of interest to you on
-background color.  Foreground and background colors are applied
+  the *Colors* tab.  You can drag any line up or down to raise or
-separately, and careful choices of foreground, background, and
+  lower its logical priority.  Right-click any line to set a new
-priority can provide two indications of worked-before status.
+  foreground or background color.  Foreground and background colors
+  are applied separately, and careful choices of foreground,
+  background, and priority can provide two indications of
+  worked-before status.
+
+* Press the *Reset Highlighting* button to reset all of the color
+  settings to default values.
+
+* Check *Highlight by Mode* if you wish worked before status to be per
+  <<INTRO,mode>>.
+
+* Worked before status is calculated from your _WSJT-X_ ADIF
+  <<LOGGING, Logging>> file, you may replace ADIF log file with one
+  exported from your station logging application, *Rescan ADIF Log*
+  rebuilds the _WSJT-X_ worked before indexes using the current ADIF
+  log file.
+
++
+
+TIP: The _WSJT-X_ ADIF file records must contain the "CALL" field.
+     The "BAND", and "MODE", and "GRIDSQUARE" fields are optional
+     depending on your DXing objectives. DXCC entity, continent, CQ,
+     and ITU Zone data for call prefixes and certain well known
+     overrides are derived from the cty.dat database which is bundled
+     with _WSJT-X_ (See <<LOGGING,Logging>> for details).
+
+.Logbook of The World User Validation
+
+Stations who are known to have uploaded their logs to the ARRL LoTW
+QSL matching service can be highlighted. The data used to determine
+this is available on line.
+
+* *Fetch Now* will download a fresh dataset from the *Users CSV file
+   URL*. The LoTW team normally update this data weekly.
+
+* Adjust *Age of of last upload less than* to set the period within
+  which a station must have uploaded their log to LoTW to trigger
+  highlighting.

doc/user_guide/en/settings-radio.adoc

@@ -6,66 +6,91 @@ _WSJT-X_ offers CAT (Computer Aided Transceiver) control of relevant
 features of most modern transceivers.  To configure the program for
 your radio, select the *Radio* tab.
 
-- Select your radio type from the drop-down list labeled *Rig*, or
+* Select your radio type from the drop-down list labeled *Rig*, or
-*None* if you do not wish to use CAT control.
+  *None* if you do not wish to use CAT control.
 
-- Alternatively, if you have configured your station for control by
+** Alternatively, if you have configured your station for control by
-*DX Lab Suite Commander*, *Ham Radio Deluxe*, *Hamlib NET rigctl*, or
+   *DX Lab Suite Commander*, *Flrig*, *Ham Radio Deluxe*, *Hamlib NET
-*Omni-Rig*, you may select one of those program names from the *Rig*
+   rigctl*, or *Omni-Rig*, you may select one of those program names
-list.  In these cases the entry field immediately under _CAT Control_
+   from the *Rig* list.  In these cases the entry field immediately
-will be relabeled as *Network Server*.  Leave this field blank to
+   under _CAT Control_ will be relabeled as *Network Server*.  Leave
-access the default instance of your control program, running on the
+   this field blank to access the default instance of your control
-same computer. If the control program runs on a different computer
+   program, running on the same computer. If the control program runs
-and/or port, specify it here.  Hover the mouse pointer over the entry
+   on a different computer and/or port, specify it here.  Hover the
-field to see the required formatting details.
+   mouse pointer over the entry field to see the required formatting
+   details.
 
-- Select *Omni-Rig Rig 1* or *Omni-Rig Rig 2* to connect to an
+** Select *Omni-Rig Rig 1* or *Omni-Rig Rig 2* to connect to an
-_Omni-Rig_ server running on the same computer.  Note that _Omni-Rig_
+   _Omni-Rig_ server installed on the same computer. _Omni-Rig_ will
-is available only under Windows.
+   be started automatically by _WSJT-X_.
 
-- Set *Poll Interval* to the desired interval for _WSJT-X_ to query
++
-your radio.  For most radios a small number (say, 1 – 3 s) is
-suitable.
 
-- _CAT Control_: To have _WSJT-X_ control the radio directly rather
+NOTE: _Omni-Rig_ is available only under Windows.
-than though another program, make the following settings:
 
-* Select the *Serial Port* used to communicate with your radio. 
+* Set *Poll Interval* to the desired interval for _WSJT-X_ to query
+  your radio.  For most radios a small number (say, 1 – 3 s) is
+  suitable.
 
-* _Serial Port Parameters_: Set values for *Baud Rate*, *Data Bits*,
+* _CAT Control_: To have _WSJT-X_ control the radio directly rather
-*Stop Bits*, and *Handshake* method.  Consult your radio's user guide
+  than though another program, make the following settings:
-for the proper parameter values.
 
-* _Force Control Lines_: A few station setups require the CAT serial
+** Select the *Serial Port* or *Network Server* including the service
-port’s *RTS* and/or *DTR* control lines to be forced high or
+  port number used to communicate with your radio.
-low. Check these boxes only if you are sure they are needed (for
-example, to power the radio serial interface).
 
-- _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 (which may be the same one as used for
-CAT control).
 
-- _Transmit Audio Source_: some radios permit you to choose the
+NOTE: A special value of *USB* is available for custom USB devices
-connector that will accept Tx audio.  If this choice is enabled,
+      like those used by some SDR kits. This is not the same a virtual
-select *Rear/Data* or *Front/Mic*.
+      serial port provided by USB connected transcivers and CAT
+      interfaces, for those use the COM or serial port name that
+      refers to them.
 
-- _Mode_: _WSJT-X_ uses upper sideband mode for both transmitting and
+** _Serial Port Parameters_: Set values for *Baud Rate*, *Data Bits*,
-receiving.  Select *USB*, or choose *Data/Pkt* if your radio offers
+  *Stop Bits*, and *Handshake* method.  Consult your radio's user
-such an option and uses it to enable the rear-panel audio line input.
+  *guide for the proper parameter values.
-Some radios also offer wider and/or flatter passbands when set to
-*Data/Pkt* mode.  Select *None* if you do not want _WSJT-X_ to change
-the radio's Mode setting.
 
-- _Split Operation_: Significant advantages result from using *Split*
++
-mode (separate VFOs for Rx and Tx) if your radio supports it.  If it
+
-does not, _WSJT-X_ can emulate such behavior.  Either method will
+NOTE: CAT interfaces that require handshaking will be non-responsive
-result in a cleaner transmitted signal, by keeping the Tx audio always
+      until the correct *Handshake* setting is applied.
-in the range 1500 to 2000 Hz so that audio harmonics cannot pass
+
-through the Tx sideband filter.  Select *Rig* to use the radio's Split
+** _Force Control Lines_: A few station setups require the CAT serial
-mode, or *Fake It* to have _WSJT-X_ adjust the VFO frequency as
+  port’s *RTS* and/or *DTR* control lines to be forced high or
-needed, when T/R switching occurs.  Choose *None* if you do not
+  low. Check these boxes *only* if you are sure they are needed (for
-wish to use split operation.
+  example, to power the radio serial interface).
+
+* _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 (which may be the same one as used for CAT
+  control).
+
++
+
+NOTE: When using a proxy application for rig control, *CAT* is usually
+      the correct option for _PTT Method_ assuming the proxy
+      application is capable of keying your transceiver idependently.
+
+* _Transmit Audio Source_: some radios permit you to choose the
+  connector that will accept Tx audio.  If this choice is enabled,
+  select *Rear/Data* or *Front/Mic*.
+
+* _Mode_: _WSJT-X_ uses upper sideband mode for both transmitting and
+  receiving.  Select *USB*, or choose *Data/Pkt* if your radio offers
+  such an option and uses it to enable the rear-panel audio line
+  input.  Some radios also offer wider and/or flatter passbands when
+  set to *Data/Pkt* mode.  Select *None* if you do not want _WSJT-X_
+  to change the radio's Mode setting.
+
+* _Split Operation_: Significant advantages result from using *Split*
+  mode (separate VFOs for Rx and Tx) if your radio supports it.  If it
+  does not, _WSJT-X_ can emulate such behavior.  Either method will
+  result in a cleaner transmitted signal, by keeping the Tx audio
+  always in the range 1500 to 2000 Hz so that audio harmonics cannot
+  pass through the Tx sideband filter.  Select *Rig* to use the
+  radio's Split mode, or *Fake It* to have _WSJT-X_ adjust the VFO
+  frequency as needed, when T/R switching occurs.  Choose *None* if
+  you do not wish to use split operation.
 
 When all required settings have been made, click *Test CAT* to test
 communication between _WSJT-X_ and your radio.  The button should turn

doc/user_guide/en/transceiver-setup.adoc

@@ -2,53 +2,63 @@
 .Receiver Noise Level
 
 - If it is not already highlighted in green, click the *Monitor*
-button to start normal receive operation.  
+  button to start normal receive operation.
 
 - Be sure your transceiver is set to *USB* (or *USB Data*) mode.
 
 - Use the receiver gain controls and/or the computer's audio mixer
-controls to set the background noise level (scale at lower left of
+  controls to set the background noise level (scale at lower left of
-main window) to around 30 dB when no signals are present.  It is
+  main window) to around 30 dB when no signals are present.  It is
-usually best to turn AGC off or reduce the RF gain control to minimize
+  usually best to turn AGC off or reduce the RF gain control to
-AGC action.
+  minimize AGC action.
+
++
+
+TIP: The PC audio mixer normally has two sliders, one for each
+     application attached which should be set to maximum (0dB FS) as
+     it cannot help with distortion from overly high or low input
+     levels from your receiver and another *Master* level which is
+     analogue attenuator on the sound card before the Analogue to
+     Digital Converter (ADC). The *Master* level can be used to adjust
+     the signal level received by _WSJT-X_.
 
 .Bandwidth and Frequency Setting
 
 - If your transceiver offers more than one bandwidth setting in USB
-mode, it may be advantageous to choose the widest one possible, up to
+  mode, it may be advantageous to choose the widest one possible, up
-about 5 kHz.  This choice has the desirable effect of allowing the
+  to about 5 kHz.  This choice has the desirable effect of allowing
-*Wide Graph* (waterfall and 2D spectrum) to display the conventional
+  the *Wide Graph* (waterfall and 2D spectrum) to display the
-JT65 and JT9 sub-bands simultaneously on most HF bands.  Further
+  conventional JT65 and JT9 sub-bands simultaneously on most HF bands.
-details are provided in the <<TUTORIAL,Basic Operating Tutorial>>.  A
+  Further details are provided in the <<TUTORIAL,Basic Operating
-wider displayed bandwidth may also be helpful at VHF and above, where
+  Tutorial>>.  A wider displayed bandwidth may also be helpful at VHF
-FT8, JT4, JT65, and QRA64 signals may be found over much wider ranges
+  and above, where FT8, JT4, JT65, and QRA64 signals may be found over
-of frequencies.
+  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
+  more than about 2.7 kHz bandwidth.  Depending on the exact dial
-frequency setting, on HF bands you can display the full sub-band
+  frequency setting, on HF bands you can display the full sub-band
-generally used for one mode.
+  generally used for one mode.
 
 - Of course, you might prefer to concentrate on one mode at a time,
-setting your dial frequency to (say) 14.074 for FT8, 14.076 for JT65,
+  setting your dial frequency to (say) 14.074 for FT8, 14.076 for
-or 14.078 for JT9.  Present conventions have the nominal JT9 dial
+  JT65, or 14.078 for JT9.  Present conventions have the nominal JT9
-frequency 2 kHz higher than the JT65 dial frequency on most bands, and
+  dial frequency 2 kHz higher than the JT65 dial frequency on most
-the FT8 frequency 2 kHz lower.
+  bands, and the FT8 frequency 2 kHz lower.
 
 .Transmitter Audio Level
 
-* Click the *Tune* button on the main screen to switch the
+* Click the *Tune* button on the main screen to switch the radio into
-radio into transmit mode and generate a steady audio tone. 
+  transmit mode and generate a steady audio tone.
 
 * Listen to the generated audio tone using your radio’s *Monitor*
-facility. The transmitted tone should be perfectly smooth, with no
+  facility. The transmitted tone should be perfectly smooth, with no
-clicks or glitches.  Make sure that this is true even when you
+  clicks or glitches.  Make sure that this is true even when you
-simultaneously use the computer to do other tasks such as email, web
+  simultaneously use the computer to do other tasks such as email, web
-browsing, etc.
+  browsing, etc..
 
 * Adjust the *Pwr* slider (at right edge of main window) downward from
-its maximum until the RF output from your transmitter falls slightly.
+  its maximum until the RF output from your transmitter falls
-This is generally a good level for audio drive.
+  slightly.  This is generally a good level for audio drive.
 
 * Toggle the *Tune* button once more or click *Halt Tx* to stop your
-test transmission.
+  test transmission.

doc/user_guide/en/tutorial-example1.adoc

@@ -64,6 +64,8 @@ so that a transmission will start automatically at the proper time.
 *Shift* key to move only the Tx frequency or the *Ctrl* key to move
 both Rx and Tx frequencies.
 
++
+
 NOTE: You can prevent your Tx frequency from being changed by checking the
 box *Hold Tx Freq*.
 

doc/user_guide/en/tutorial-example2.adoc

@@ -50,6 +50,8 @@ image::decodes.png[align="center"]
 earlier, in <<TUT_EX1,Example 1>>.  _WSJT-X_ automatically determines
 the mode of each JT9 or JT65 message.
 
++
+
 TIP: When you double-click on a signal in the waterfall it will be
 properly decoded even if on the "`wrong`" side of the *JT65 nnnn JT9*
 marker.  The Tx mode automatically switches to that of the decoded

doc/user_guide/en/tutorial-example3.adoc

@@ -43,16 +43,16 @@ frequency to that of the selected message and leaving Tx frequency
 unchanged.  To change both Rx and Tx frequencies, hold *Ctrl* down
 when double-clicking.
 
-NOTE: To avoid QRM from competing callers, it is frequently desirable
+TIP: To avoid QRM from competing callers, it is frequently desirable
 to answer a CQ on a different frequency from that of the CQing
 station.  The same is true when you tail-end another QSO.  Choose a Tx
 frequency that appears to be not in use.  You might want to check the
 box *Hold Tx Freq*.
 
-NOTE: Keyboard shortcuts *Shift+F11* and *Shift+F12* provide an easy
+TIP: Keyboard shortcuts *Shift+F11* and *Shift+F12* provide an easy
 way to move your Tx frequency down or up in 60 Hz steps.
 
-NOTE: An online {ft8_tips} by ZL2IFB offers many helpful tips on
+TIP: An online {ft8_tips} by ZL2IFB offers many helpful tips on
 operating procedures.
 
 .FT8 DXpedition Mode:

doc/user_guide/en/tutorial-main-window.adoc

@@ -6,6 +6,8 @@
 
 - Set the audio frequencies to *Tx 1224 Hz* and *Rx 1224 Hz*.  
 
++
+
 TIP: Sliders and spinner controls respond to *Arrow* key presses
 and *Page Up/Down* key presses, with the *Page* keys moving the
 controls in larger steps.  You can also type numbers directly into

doc/user_guide/en/vhf-features.adoc

@@ -1,5 +1,6 @@
-_WSJT-X_ v1.9 suppports a number of features designed for use
+_WSJT-X_ v{VERSION_MAJOR}.{VERSION_MINOR} suppports a number of
-on the VHF and higher bands.  These features include:
+features designed for use on the VHF and higher bands.  These features
+include:
 
 - *FT8*, a mode designed for making fast QSOs with weak, fading
 signals
@@ -276,6 +277,8 @@ this number is well below 100% you may increase the decoding depth
 from *Fast* to *Normal* or *Deep*, and increase *F Tol* from 100 to
 200 Hz.
 
++
+
 NOTE: Most modern multi-core computers can easily handle the optimum
 parameters *Deep* and *F Tol 200*.  Older and slower machines may not
 be able to keep up at these settings; at the *Fast* and *Normal*
@@ -303,6 +306,7 @@ enclosed in <> angle brackets, as in the following model QSO
  <W9XYZ K1ABC> RRR
                     <K1ABC W9XYZ> 73
 
++
 
 NOTE: There is little or no advantage to using MSK144 *Sh*
 messages at 50 or 70 MHz.  At these frequencies, most pings are long

doc/user_guide/en/wsjtx-main.adoc

@@ -1,5 +1,5 @@
 // This is a comment line, anything with // is ignored at process time.
-= _WSJT-X 2.0_ User Guide
+= _WSJT-X {VERSION_MAJOR}.{VERSION_MINOR}_ User Guide
 Joseph H Taylor, Jr, K1JT
 :revnumber: {VERSION}
 // For web-pages, adding :badges: is ok, but is a security issue for

doc/user_guide/en/wspr.adoc

@@ -11,6 +11,8 @@ desired size.
 
 - Select an active WSPR frequency (for example, 10.1387 or 14.0956 MHz).
 
++
+
 IMPORTANT: If you will transmit in the 60 m band, be sure to choose a
 frequency that conforms with your local regulations.