More editing of v1.6.0 User Guide.

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

doc/common/links.adoc

@@ -2,14 +2,14 @@
 Link file to hold all links
 File Location: ./doc/common/links.adoc
 Usage example: include::../common/links.adoc[]
-Syntax: [link-id] [link] [displayed test]
+Syntax: [link-id] [link] [displayed text]
 
 Example:
 :pskreporter: http://pskreporter.info/pskmap.html[PSK Reporter]
 
 [link-id] = :pskreporter:
 [link] http://pskreporter.info/pskmap.html
-[displayed test] PSK Reporter
+[displayed text] PSK Reporter
 
 Perform searches from the doc root directory: C:\JTSDK-DOC\doc
 Search: grep -rl --exclude-dir="*\.svn" {pskreporter} .
@@ -56,13 +56,16 @@ d). Edit lines as needed. Keeping them in alphabetic order help see dupes.
 :fmt_arrl: http://www.arrl.org/frequency-measuring-test[ARRL FMT Info]
 :fmt_group: https://groups.yahoo.com/neo/groups/FMT-nuts/info[FMT Group]
 :fmt_k5cm: http://www.k5cm.com/[FMT Event Info]
+:fmt_wspr: http://www.physics.princeton.edu/pulsar/K1JT/FMT_User.pdf[here]
 :gnu_gpl: http://www.gnu.org/licenses/gpl-3.0.txt[GNU General Public License]
 :homepage: http://physics.princeton.edu/pulsar/K1JT/[WSJT Home Page]
 :hrd: http://www.hrdsoftwarellc.com/[Ham Radio Deluxe]
+:jt4eme: http://physics.princeton.edu/pulsar/K1JT/WSJT-X_for_JT4_v6.pdf[here]
 :jt65protocol: http://physics.princeton.edu/pulsar/K1JT/JT65.pdf[QEX]
 :jtalert: http://hamapps.com[JT-ALERT-X]
 :kvasd-installer: http://physics.princeton.edu/pulsar/K1JT/kv-installer.txt[here]
 :launchpadki7mt: https://launchpad.net/~ki7mt[KI7MT PPA's]
+:log4om: http://www.log4om.com[Log4OM]
 :msys_url: http://sourceforge.net/projects/mingwbuilds/files/external-binary-packages/[MSYS Download]
 :ntpsetup: http://www.satsignal.eu/ntp/setup.html[Network Time Protocol Setup]
 :osx_instructions: http://physics.princeton.edu/pulsar/K1JT/OSX_Readme[here]

doc/user_guide/acknowledgements.adoc

@@ -8,8 +8,8 @@ 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, G4KLA, G4WJS, K3WYC, KA6MAL, KA9Q, KB1ZMX, KI7MT, KK1D,
+AE4JY, DJ0OT, G4KLA, G4WJS, K3WYC, K9AN, KA6MAL, KA9Q, KB1ZMX, KI7MT,
-PY2SDR, VK3ACF, VK4BDJ, W4TI, W4TV, and W9MDB*.  Each of these
+KK1D, PY2SDR, VK3ACF, VK4BDJ, W4TI, W4TV, and W9MDB*.  Each of these
 amateurs has helped to bring the program’s design, code, and
 documentation to its present state.
 
@@ -23,5 +23,5 @@ Collection from the Free Software Foundation, the "clang" compiler
 from LLVM at the University of Illinois, and the Qt Project from Digia
 PLC.  Other important resources include the FFTW library by Matteo
 Frigo and Steven G. Johnson; SLALIB, the Positional Astronomy Library
-by P. T.  Wallace; and a high-precision planetary emperis and
+by P. T.  Wallace; and a high-precision planetary ephemeris and
 associated software from NASA's Jet Propulsion Laboratory.

doc/user_guide/command-reference.adoc

@@ -1,14 +0,0 @@
-// Status=review
-// Needs updating: GB Added 03-NOV-2015
-
-// add other sections here
-
-[[COMMAND_REF_LOGGING]]
-.Choose any desired options from this group:
-
-* Prompt me to log QSO
-* Convert mode to RTTY
-* db reports to comments
-* Clear DX call and grid after logging
-
-// more sections here

doc/user_guide/controls-functions-center.adoc

@@ -21,12 +21,17 @@ to left.)  Check the box *Lock Tx=Rx* to make the frequencies always
 track one another.  The on-the-air frequency of your lowest JT9 or
 JT65 tone is the sum of dial frequency and audio Tx frequency.
 
+IMPORTANT: In general we do not recommend using *Lock Tx=Rx* since it
+encourages poor radio etiquette when running a frequency.  With *Lock
+Tx=Rx* checked, your own frequency will move around following your
+callers.
+
 * The *Report* control lets you change a signal report that has been
 inserted automatically. Most reports will fall in the range –26 to +10
 dB.  Remember that JT65 reports saturate at an upper limit of -1
 dB.
 
-IMPORTANT: When signals are close to or above 0 dB, you and your QSO
+IMPORTANT: Consider reducing power if your QSO partner reports your
-partner should probably reduce power.  The WSJT modes are supposed to
+signal above -5 dB.  The WSJT modes are supposed to be weak signal
-be weak signal modes!
+modes!
 

doc/user_guide/faq.adoc

@@ -37,20 +37,6 @@ decreasing *Bins/Pixel*, increasing *Start*, or reducing the width of
 the *Wide Graph*.  You might also choose to re-center the filter
 passband, if such control is available.
 
-My rig has only a single SSB filter, about 2700 Hz bandwidth.  Can I use split mode?::
-
-Set _Split Operation_ to *Rig* (or if necessary, *Fake It*) on the
-*Settings | Radio* tab.  To operate primarily in the JT9 frequency
-range, check the *{plus}2 kHz* box. VFO-A will be moved up by that
-amount, e.g., to 14.078 MHz on 20 meters.  The JT9 sub-band now falls
-between about 500 Hz and 2000Hz on the waterfall display.  As
-described above, VFO-B will be adjusted so as to keep your Tx audio
-always between 1500 and 2000 Hz.  To operate JT65, simply uncheck the
-*{plus}2 kHz* option.  If your rig has an IF shift control or
-equivalent (``passband tuning''), you can operate as if you had 4 kHz
-Rx bandwidth and use the IF shift control to focus on any 2.7 kHz
-portion of the JT65 and JT9 sub-bands.
-
 How should I configure _WSJT-X_ to run multiple instances?::
 
 Start _WSJT-X_ from a command-prompt window, passing each instance a

doc/user_guide/introduction.adoc

@@ -12,7 +12,7 @@ QSOs under extreme weak-signal conditions. They use nearly identical
 message structure and source encoding.  JT65 was designed for EME
 (“moonbounce”) on the VHF/UHF bands and has also proven very effective
 for worldwide QRP communication on the HF bands.  JT9 is optimized for
-the LF, MF, and lower HF bands.  It is about 2 dB more sensitive than
+the LF, MF, and lower HF bands.  It is 2 dB more sensitive than
 JT65 while using less than 10% of the bandwidth.  JT4 offers a wide
 variety of tone spacings and has proved very effective for EME on
 microwave bands up to 24 GHz.  All three of these modes use one-minute
@@ -34,12 +34,15 @@ internet access can automatically upload their reception reports to a
 central database called {wsprnet} that provides a mapping facility,
 archival storage, and many other features.
 
+Echo mode allows you to detect and measure your own lunar echoes,
+ even when they are far below the threshold of audibility.
+
 _WSJT-X_ provides spectral displays for passbands up to 5 kHz,
 flexible rig control for nearly all modern radios used by amateurs,
 and a wide variety of special aids such as automatic Doppler control
-for EME QSOs.  The program runs equally well on Windows, Macintosh,
+for EME QSOs and echo testing.  The program runs equally well on
-and Linux systems, and installation packages are available for all
+Windows, Macintosh, and Linux systems, and installation packages are
-three platforms.
+available for all three platforms.
 
 _WSJT-X_ is an open-source project released under the {gnu_gpl}
 (GPL). If you have programming or documentation skills or would like

doc/user_guide/logging.adoc

@@ -2,8 +2,14 @@ A basic logging facility in _WSJT-X_ saves QSO information to flies
 named +wsjtx.log+ (in comma-separated text format) and +wsjtx_log.adi+
 (in standard ADIF format).  These files can be imported directly into
 other programs, for example spreadsheets and popular logging prgrams.
-More elaborate logging capabilities are supported in cooperation with
+As described in the <<INSTALL,Installation>> and <<PLATFORM,Platform
-{jtalert}, {hrd}, or the {dxlsuite}.
+Dependencies>> sections, different operating systems may place your
+local log files in different locations.  You can always navigate to
+them directly by selecting *Open log directory* from the *File* menu.
+
+More elaborate logging capabilities are supported by third party
+applications like {jtalert}, which can log QSOs automatically to other
+applications including {hrd}, {dxlsuite}, and {log4om}.  
 
 The program option *Show DXCC entity and worked before status*
 (selectable on the *Settings | General* tab) is intended mostly for

doc/user_guide/make-qso.adoc

@@ -44,7 +44,7 @@ for decodability are around –24 dB for JT65, –26 dB for JT9.
 Users often add some friendly chit-chat at the end of a QSO.
 Free-format messages such as ``TNX ROBERT 73'' or ``5W VERT 73 GL''
 are supported, up to a maximum of 13 characters, including spaces.  In
-general you should avoid the character / in free-text nessages, as the
+general you should avoid the character / in free-text messages, as the
 program may then try to interpret your construction as part of a
 compound callsign.  It should be obvious that the JT9 and JT65
 protocols are not designed or well suited for extensive conversations
@@ -148,9 +148,9 @@ will be generated that best suit your needs.
 
 === Pre-QSO Checklist
 
-Before attempting your first QSO with JT9 or JT65, be sure to go
+Before attempting your first QSO with one of the WSJT modes, be sure
-through the <<TUTORIAL,Basic Operating Tutorial>> above, as well as the following
+to go through the <<TUTORIAL,Basic Operating Tutorial>> above as well
-checklist:
+as the following checklist:
 
 - Your callsign and grid locator set to correct values
 

doc/user_guide/new_features.adoc

@@ -3,20 +3,26 @@
 For quick reference, here's a short list of features and capabilities
 added to _WSJT-X_ since Version 1.5.0:
 
-- *WSPR* mode, including automatic coordinated band-hopping and an
+- *WSPR* mode, including coordinated automatic band-hopping and a
 two-pass decoder that can decode overlapping signals.
 
-- EME-inspired features including *JT4* (submodes *A-G*), *Echo* mode,
+- EME-motivated features including *JT4* (submodes *A-G*), *Echo*
-and automatic *Doppler tracking*.  (Note that submodes *JT65B* and
+mode, and automatic *Doppler tracking*.  The JT4 decoder is more
-*JT65C* are also present in Version 1.6, but the high-sensitivity
+sensitive than that in the latest WSJT, and message averaging is fully
-decoder required for EME is not yet included.)
+automated.  (Note that submodes *JT65B* and *JT65C* are also present
+in Version 1.6, but the high-sensitivity decoder required for EME is
+not yet included.)
 
 - Tools for accurate *frequency calibration* of your radio, so you can
-be automatically ``on frequency'' to within about 1 Hz.
+be automatically on-frequency to within about 1 Hz.
 
 - Mode-specific working frequencies accessible from the drop-down
 band selector.
 
+- Many corrections of balky rig-control features implemented through
+the hamlib library, and removal of a few unreliable features peculiar
+to particular radios.
+ 
 === Future releases
 
 Much work has already been done on what will become Version 1.7 of

doc/user_guide/settings-audio.adoc

@@ -11,6 +11,9 @@ 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 transmitting them over the air.
 
+IMPORTANT: If necessary, be sure that your audio device in configured to
+sample at 48000 Hz, 16 bits.
+
 - _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.
@@ -21,4 +24,3 @@ program for automatic tracking of the Sun or Moon, as well as
 predicted Doppler shift for the specified EME path.  The file is
 updated once per second.
 
-

doc/user_guide/settings-frequencies.adoc

@@ -22,7 +22,8 @@ the desired mode (or leave the Mode selection blank).  Then click
 configuration.
 
 _Frequency Calibration_: If you have calibrated your radio with the
-technique described (...here...), enter the measured values for
+technique described {fmt_wspr}, or simply by measuring against WWV or
+another reliable frequency reference, enter the measured values for
 Intercept and Slope.  Frequency values sent to the radio and received
 from it will then be adjusted accordingly so that frequencies displayed
 by _WSJT-X_ will be correct.

doc/user_guide/settings-reporting.adoc

@@ -2,9 +2,7 @@
 [[FIG_CONFIG_RPT]]
 image::images/reporting.png[align="center",alt="Reporting Screen"]
 
-- _Logging_: Choose any desired options from this group.  For detailed
+- _Logging_: Choose any desired options from this group.
-descriptions of their effects, see 
-<<COMMAND_REF_LOGGING,Logging Command Reference>> section.
 
 - _Network Services_: Check *Enable PSK Reporter Spotting* to send
 reception reports to the {pskreporter} mapping facility.

doc/user_guide/system-requirements.adoc

@@ -8,6 +8,6 @@
   device for T/R switching, or CAT control, or VOX, as required for 
   your radio-to-computer connections
 - Audio input and output devices supported by the operating system and 
-  capable of 48 kHz sample rate
+  configured for sample rate 48000 Hz.
 - Audio or equivalent USB connections between transceiver and computer  
 - A means for synchronizing the computer clock to UTC within ±1 second

doc/user_guide/transceiver-setup.adoc

@@ -54,3 +54,10 @@ will be a good level for audio drive.
 digital slider labeled *Pwr* at the right edge of the main window.
 
 * Toggle the *Tune* button once more to stop your test transmission. 
+
+IMPORTANT: Windows Vista and later incorrectly 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 CODECs, as well as various other audio interfaces.)  If using such
+a device, be sure to set the mic level in the Recording Device
+Properties to 0 dB.

doc/user_guide/utilities.adoc

@@ -1,29 +1,56 @@
 // Status=review
 
-Utility programs *+jt9code+* and *+jt65code+* let you explore the
+The _WSJT-X_ packages include program *+rigctl-wsjtx[.exe]+*, which
-conversion of user-level messages into channel symbols or ``tone
+can be used to send CAT sequences to a rig from the command line, or
-numbers,'' and back again.  These programs can be useful to someone
+from a batch file or shell script; and program *+rigctld-wsjtx[.exe]+*,
-designing a beacon generator for JT9 or JT65, for understanding the
+which allows other compatible applications to share a CAT connection
+to a rig.  These program versions include the latest Hamlib rig
+drivers -- the same ones used by _WSJT-X_ itself.
+
+Additional utility programs *+jt4code+*, *+jt9code+*, and *+jt65code+*
+let you explore the conversion of user-level messages into channel
+symbols or ``tone numbers,'' and back again.  These programs can be
+useful to someone designing a beacon generator, for understanding the
 permissible structure of transmitted messages, and for studying
 behavior of the error-control codes.
 
+Channel-symbol values for JT4 run from 0 to 3.  The total number of
+symbols in a transmitted message is 206.  To run +jt4code+, enter the
+program name followed by a JT4 message enclosed in quotes.  In Windows
+the command and program output might look like this:
+
+ C:\WSJTX> jt4code "G0XYZ K1ABC FN42"
+      Message                 Decoded                Err? Type
+ -------------------------------------------------------------------
+  1.  G0XYZ K1ABC FN42        G0XYZ K1ABC FN42            1: Std Msg
+
+ Channel symbols
+  2 0 0 1 3 2 0 2 3 1 0 3 3 2 2 1 2 1 0 0 0 2 0 0 2 1 1 2 0 0
+  2 0 2 0 2 0 2 0 2 3 0 3 1 0 3 1 0 3 0 1 1 1 1 1 0 1 0 0 2 3
+  2 2 3 0 2 1 3 3 3 3 2 0 2 1 2 3 0 0 2 3 1 1 1 0 3 1 2 0 3 2
+  0 2 3 3 0 1 2 1 2 1 0 1 0 1 1 1 1 3 0 3 0 3 2 3 3 0 3 0 1 0
+  3 3 3 0 0 3 2 1 3 2 3 1 3 3 2 2 0 2 3 3 2 1 1 0 2 2 3 3 1 2
+  3 1 1 2 1 1 1 0 2 1 2 0 2 3 1 2 3 1 2 2 1 2 0 0 3 3 1 1 1 1
+  2 0 3 3 0 2 2 2 3 3 0 0 0 1 2 3 3 2 1 1 1 3 2 3 0 3
+
 Channel-symbol values for JT9 run from 0 to 8, with 0 representing the
 sync tone.  The total number of symbols in a transmitted message is
-85.  To run +jt9code+, enter the program name followed by a JT9
+85.  Enter the program name followed by a JT9 message enclosed in
-message enclosed in quotes.  In Windows the command and program output
+quotes:
-might look like this:
 
  C:\WSJTX> jt9code "G0XYZ K1ABC FN42"
- Message:   G0XYZ K1ABC FN42
+      Message                 Decoded                Err? Type
- Channel symbols:
+ -------------------------------------------------------------------
+  1.  G0XYZ K1ABC FN42        G0XYZ K1ABC FN42            1: Std Msg
+
+ Channel symbols
   0 0 7 3 0 3 2 5 4 0 1 7 7 7 8 0 4 8 8 2 2 1 0 1 1 3 5 4 5 6
   8 7 0 6 0 1 8 3 3 7 8 1 1 2 4 5 8 1 5 2 0 0 8 6 0 5 8 5 1 0
   5 8 7 7 2 0 4 6 6 6 7 6 0 1 8 8 5 7 2 5 1 5 0 4 0
- Decoded message: G0XYZ K1ABC FN42
 
 For the corresponding program *+jt65code+* only the
 information-carrying channel symbols are shown, and the symbol values
-range from 0 to 63.  Sync synbols lie two tone intervals below data
+range from 0 to 63.  Sync symbols lie two tone intervals below data
 tone 0, and the sequential locations of sync symbols are described in
 the <<JT65PRO,JT65 Protocol>> section of this Guide.
 
@@ -32,13 +59,16 @@ displays the packed message of 72 bits, shown here as 12 six-bit
 symbol values, followed by the channel symbols:
 
  C:\WSJTX> jt65code "G0XYZ K1ABC FN42"
- Message:   G0XYZ K1ABC FN42
+      Message                 Decoded                Err? Type
- Packed message, 6-bit symbols:  61 36 45 30  3 55  3  2 14  5 33 40
+ ----------------------------------------------------------------------
- Information-carrying channel symbols:
+  1.  G0XYZ K1ABC FN42        G0XYZ K1ABC FN42            1:    Std Msg
+
+ Packed message, 6-bit symbols  61 36 45 30  3 55  3  2 14  5 33 40
+
+ Information-carrying channel symbols
     56 40  8 40 51 47 50 34 44 53 22 53 28 31 13 60 46  2 14 58 43
     41 58 35  8 35  3 24  1 21 41 43  0 25 54  9 41 54  7 25 21  9
     62 59  7 43 31 21 57 13 59 41 17 49 19 54 21 39 33 42 18  2 60
- Decoded message: G0XYZ K1ABC FN42
 
 For an illustration of the power of the strong error-control coding in
 JT9 and JT65, try looking at the channel symbols after changing a
@@ -46,14 +76,19 @@ single character in the message.  For example, change the grid locator
 from +FN42+ to +FN43+ in the JT65 message:
 
  C:\Users\joe\wsjt\wsjtx_install>jt65code "G0XYZ K1ABC FN43"
- Message:   G0XYZ K1ABC FN43
+      Message                 Decoded                Err? Type
- Packed message, 6-bit symbols:  61 36 45 30  3 55  3  2 14  5 33 41
+ ----------------------------------------------------------------------
- Information-carrying channel symbols:
+  1.  G0XYZ K1ABC FN43        G0XYZ K1ABC FN43            1:    Std Msg
+
+ Packed message, 6-bit symbols  61 36 45 30  3 55  3  2 14  5 33 41
+
+ Information-carrying channel symbols
     25 35 47  8 13  9 61 40 44  9 51  6  8 40 38 34  8  2 21 23 30
     51 32 56 39 35  3 50 48 30  8  5 40 18 54  9 24 30 26 61 23 11
      3 59  7  7 39  1 25 24  4 50 17 49 52 19 34  7  4 34 61  2 61
- Decoded message: G0XYZ K1ABC FN43
 
 You will discover that every possible JT65 message differs from every
 other possible JT65 message in at least 52 of the 63
 information-carrying channel symbols.
+
+

doc/user_guide/vhf-features.adoc

@@ -1,12 +1,13 @@
 === VHF Setup
 
 V1.6.0 is the first _WSJT-X_ version to include features specifically
-designed for use on VHF and higher bands.  These features include *JT4*,
+designed for use on VHF and higher bands.  These features include
-a mode particularly useful for EME on the microwave bands; *Echo* mode,
+*JT4*, a mode particularly useful for EME on the microwave bands;
-for detecting and measuring your own lunar echoes; and automatic
+*Echo* mode, for detecting and measuring your own lunar echoes; and
-*Doppler tracking* for the EME path.  (Note that sub-modes JT65B and
+automatic *Doppler tracking* for the EME path.  The accuracy of
-JT65C are present in v1.6.0, but are not yet fully implemented for EME
+Doppler calculations is better than 1 Hz at 10 GHz.  (Note that
-purposes.)
+sub-modes JT65B and JT65C are present in v1.6.0, but are not yet fully
+implemented for EME purposes.)
 
 - To activate the VHF-and-up features check the box labeled _Enable
   VHF/UHF/Microwave features_ on the *Settings | General* tab.
@@ -32,23 +33,30 @@ image::images/VHF_controls.png[align="center",alt="VHF Controls"]
 
 - On the *View* menu, select *Astronomical data* to display a window
 with important information for tracking the Moon and performing
-automatic Doppler control.
+automatic Doppler control.  Check the box labeled _Doppler tracking_
+to ensure that the right-hand portion of the window is visible.
 
 image::images/Astronomical_data.png[align="center",alt="Astronomical data"]
 
 IMPORTANT: Note that two different types of Doppler control are provided.  
 
 - Select _Full Doppler to DX Grid_ if you know your QSO partner's locator
-and he/she is not using Doppler control.
+and he/she will not be using any Doppler control.
 
 - Select _Constant frequency on Moon_ to correct for your own (one-way)
 Doppler shift to or from the Moon.  If your QSO partner does the same
 thing, both stations will have the required Doppler compensation.
 Moreover, anyone else using this option will hear both of you
 without the need for manual frequency changes.  The hypothetical ``man
-in the moon'' will copy all of you on the selected nominal frequency:
+in the moon'' will copy all of you on the selected nominal frequency.
-in the example depicted above, this is 100 kHz above the stated band
+
-edge, e.g., 10368.100 MHz for the 10 GHz band.
+- In the example depicted above, the moon-based nominal frequency is
+100 kHz above the stated band edge, or 10368.100 MHz for the 10 GHz
+band.  The home station two-way self Doppler shift is +6193 Hz, so the
+one-way shift is +3096.5 Hz.  Therefore, the receive frequency is set
+to 10,360.103097 Hz.  When a transmission is started, the frequency
+is reset to 3096.5 Hz below the nomial frequency.
+
 
 - Spinner controls at top right of the Astronomical Data window let you
 set a working frequency above the nominal band edge. The frequency above
@@ -63,19 +71,19 @@ Higher spacings are used on the higher microwave bands, to allow for
 larger Doppler spreads. For example, JT4F is generally used for EME on
 the 10 GHz band.  
 
-- If using a transverter, set the appropriate offset on the
+- If using a transverter, set the appropriate offset on the *Settings
-*Settings | Frequencies* tab.  Offset is defined as (desired
+| Frequencies* tab.  Offset is defined as (desired transceiver dial
-transceiver dial reading) minus (desired on-the-air frequency).  For
+reading) minus (desired on-the-air frequency).  For example, when
-example, when using a 144 MHz radio at 10368 MHz, 
+using a 144 MHz radio at 10368 MHz, offset = (144 - 10368) =
-offset = (144 - 10368) = -10224.000.  Right-click anywhere inside the 
+-10224.000.  If the band is already in the table, you can edit the
-_Station Information_ box, select the desired band, and enter the 
+offset by double clicking on the offset field itself.  Otherwise a new
-offset number.
+band can be added by right clicking in the table and selecting _Insert_.
 
 image::images/Add_station_info.png[align="center",alt="Station information"]
 
 - The JT4 decoder in _WSJT-X_ includes optional facilities for
-averaging over successive trandmissions and also correlation decoding,
+averaging over successive transmissions and also correlation decoding,
-sometimesknown as ``Deep Search''.  The *Decode* menu appears to
+sometimes known as ``Deep Search''.  The *Decode* menu appears to
 provide options to set different decoding behavior.  However, in JT4 mode
 this program version always behaves as if you have selected _Include
 correlation_.
@@ -87,9 +95,8 @@ activate automatic generation of these messages, check the box labeled
 _Sh_ on the main window.
 
 IMPORTANT: Many additional hints for using JT4 and Echo mode on the
-EME path are available here:
+EME path are available {jt4eme}.  (Thanks to G3WDG for preparing this 
-http://physics.princeton.edu/pulsar/K1JT/WSJT-X_for_JT4_v6.pdf. Thanks
+useful document.)
-to G3WDG for preparing this document!.
 
 === Echo Mode
 
@@ -99,7 +106,7 @@ from the *Mode* menu, aim your antenna at the moon, pick a clear
 frequency, and toggle click *Tx Enable*. _WSJT-X_ will then cycle
 through the following loop every 6 seconds:
 
-1. Transmit a fixed tone for 2.3 s
+1. Transmit a 1500 Hz fixed tone for 2.3 s
 2. Wait about 0.2 s for start of the return echo
 3. Record the received signal for 2.3 s
 4. Analyze, average, and display the results

doc/user_guide/wsjtx-main.adoc

@@ -61,10 +61,11 @@ include::install-from-source.adoc[]
 [[CONFIG]] 
 == Settings
 
-Select *Settings* from the *File* menu or by typing *F2* (on
+Select *Settings* from the *File* menu or by typing *F2*.  (On
-Macintosh, *Command* or *Cmd*).  The following sections describe setup
+Macintosh select *Preferences* from the WSJT-X menu, or use the
-optiions available on each of seven tabs selectable near the top of the
+keyboard *Command* or *Cmd* key.)  The following sections describe
-window.
+setup optiions available on each of seven tabs selectable near the top
+of the window.
 
 [[GENERAL]]
 === General
@@ -137,8 +138,7 @@ include::vhf-features.adoc[]
 include::make-qso.adoc[]
 
 [[COMMAND_REF]]
-== Command Reference
+== On-Screen Controls
-include::command-reference.adoc[]
 
 [[CONTROLS_WIDE]]
 === Wide Graph