Final (?) additions to WSJT-X User Guide for v1.6.0. Close reading

is now strongly encouraged!  We "go to press" soon!


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

doc/CMakeLists.txt

@@ -60,7 +60,7 @@ set (UG_SRCS
   user_guide/tutorial-wide-graph-settings.adoc
   user_guide/tx-rx.adoc
   user_guide/utilities.adoc
-  user_guide/vhf-and-up.adoc
+  user_guide/vhf-features.adoc
   user_guide/wsjtx-main.adoc
   user_guide/wspr.adoc
   )

doc/user_guide/new_features.adoc

@@ -1,13 +1,15 @@
+=== New in Version 1.6
+
 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
-improved sensitivity two-pass decoder.
+two-pass decoder that can decode overlapping signals.
 
 - EME-inspired features including *JT4* (submodes *A-G*), *Echo* mode,
-and *automatic Doppler tracking*.  Note that submodes *JT65B* and
+and automatic *Doppler tracking*.  (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.
+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.
@@ -15,3 +17,17 @@ be automatically ``on frequency'' to within about 1 Hz.
 - Mode-specific working frequencies accessible from the drop-down
 band selector.
  
+=== Future releases
+
+Much work has already been done on what will become Version 1.7 of
+_WSJT-X_.  (Up to now it has been called v1.6.1.)  A number of people
+have been building this version for themselves, as development
+progresses, and reporting on their experiences.  The next release will
+almost certainly have the following features not present in
+Version 1.6.0:
+
+- *JTMSK* mode, intended for meteor scatter, ionospheric scatter,
+aircraft scatter, and the like.  Unlike the FSK441, ISCAT, and JTMS
+modes present in the older program _WSJT_, JTMSK includes strong
+forward error correction and uses structured messages identical to
+those in JT4, JT9, and JT65.

doc/user_guide/vhf-and-up.adoc

@@ -1,90 +0,0 @@
-=== 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*,
-a mode particularly useful for EME on the microwave bands; *Echo* mode,
-for detecting and measuring your own lunar echoes; and automatic
-*Doppler tracking* for the EME path.  (Note that sub-modes JT65B and
-JT65C are present in v1.6.0, but are not yet fully implemented for EME
-purposes.)
-
-- Check the box labeled _Enable VHF/UHF/Microwave features_ on the
-*Settings | General* tab to activate the VHF-and-up features.  
-
-- If you will be doing EME, check the box _Decode at t = 52 s_
-to allow for the EME path delay.
-
-- If you will use automatic Doppler tracking, check the box 
-_Allow Tx frequency changes while transmitting_.  Also select
-_Split Operation_ (either _Rig_ or _Fake It_: you might need
-to experiment with both) on the *Radio* tab.
-
-IMPORTANT: Not all transceivers permit computer adjustments
-of Tx frequency while transmitting.  Among those that do are the
-IC735, IC756 Pro II, IC910-H, FT-847, TS-2000 (with Rev 9 firmware
-upgrade), Flex 1500 and 5000, HPSDR, Anan-10, Anan-100, and KX3.
-
-- When operating in appropriate modes the main window will reconfigure
-itself to include controls supporting the additional features.  For
-example, in JT4 mode the central part of the main window will look
-something like this:
-
-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.
-
-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.
-
-- 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.
-Better still, 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 example depicted above, this is 100 kHz above the stated band
-edge, e.g., 10368.100 MHz for the 10 GHz band.
-
-- Spinner controls at top right of the Astronomical Data window let you
-set a working frequency above the nominal band edge. The frequency above
-band edge is the sum of these two controls (kHz + Hz).
-
-=== EME with JT4
-
-- Select *JT4* from the *Mode* menu.
-
-- Select the desired submode, which determines the tone spacing.
-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
-*Settings | Frequencies* tab.  Offset is defined as (desired
-transceiver dial reading) minus (desired on-the-air frequencty).  For
-example, for a 144 MHz radio and 10368 MHz, 
-offset = (144 - 10368) = -10224.000.  Right-click anywhere inside the 
-_Station Information_ box, select the desired band, and enter the 
-offset number.
-
-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 correlation decoding.  Select
-your desired decoding depth from the *Decode* menu.
-
-image::images/decoding_depth.png[align="center",alt="Decoding Depth"]
-
-- By convention, EME with JT4 can use ``short form'' messages.  To
-activate automatic generation of these messages, check the box labeled
-_Sh_ on the main window.
-
-IMPORTANT: Many additional details and hints for JT4 EME operation
-are available here: 
-http://physics.princeton.edu/pulsar/K1JT/WSJT-X_for_JT4_v6.pdf 
-(thanks to G3WDG!).

doc/user_guide/vhf-features.adoc

@@ -0,0 +1,123 @@
+=== 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*,
+a mode particularly useful for EME on the microwave bands; *Echo* mode,
+for detecting and measuring your own lunar echoes; and automatic
+*Doppler tracking* for the EME path.  (Note that 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.
+
+- If you will be doing EME, check the box _Decode at t = 52 s_
+to allow for the EME path delay on received signals.
+
+- If you will use automatic Doppler tracking, check the box _Allow Tx
+frequency changes while transmitting_.  On the *Radio* tab select
+_Split Operation_ (use either _Rig_ or _Fake It_: you might need to
+experiment with both).
+
+IMPORTANT: Not all transceivers permit computer adjustments of Tx
+frequency while transmitting.  Among those that do are the IC-735,
+IC-756 Pro II, IC-910-H, FT-847, TS-2000 (with Rev 9 firmware
+upgrade), Flex 1500 and 5000, HPSDR, Anan-10, Anan-100, and KX3.
+
+- The main window reconfigures itself as necessary to include controls
+supporting features of each mode.  For example, in JT4 mode the
+central part of the main window will look like this:
+
+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.
+
+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.
+
+- 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 example depicted above, this is 100 kHz above the stated band
+edge, e.g., 10368.100 MHz for the 10 GHz band.
+
+- Spinner controls at top right of the Astronomical Data window let you
+set a working frequency above the nominal band edge. The frequency above
+band edge is the sum of the numbers in these two controls (kHz + Hz).
+
+=== EME with JT4
+
+- Select *JT4* from the *Mode* menu.
+
+- Select the desired submode, which determines the tone spacing.
+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
+*Settings | Frequencies* tab.  Offset is defined as (desired
+transceiver dial reading) minus (desired on-the-air frequency).  For
+example, when using a 144 MHz radio at 10368 MHz, 
+offset = (144 - 10368) = -10224.000.  Right-click anywhere inside the 
+_Station Information_ box, select the desired band, and enter the 
+offset number.
+
+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,
+sometimesknown 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_.
+
+image::images/decoding_depth.png[align="center",alt="Decoding Depth"]
+
+- By convention, EME with JT4 can use ``short form'' messages.  To
+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:
+http://physics.princeton.edu/pulsar/K1JT/WSJT-X_for_JT4_v6.pdf. Thanks
+to G3WDG for preparing this document!.
+
+=== Echo Mode
+
+*Echo* mode allows you to make sensitive measurements of your own
+lunar echoes, even when they are too weak to be heard. Select *Echo*
+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
+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
+5. Repeat from step 1
+
+To make a sequence of echo tests:
+
+- Select *Echo* from the *Mode* menu.
+
+- On the Astronomical Data window check _Doppler tracking_ and
+_Constant frequency on the Moon_
+
+- Choose your desired test frequency using the _Frequency above nominal
+band edge_ controls.
+
+- Click *Enable Tx* on the main window to start a sequence of 6-second
+cycles.
+
+- _WSJT-X_ calculates and compensates for Doppler shift automatically.
+Your return echo should always appear at the center of the plot area
+on the Echo Graph window.

doc/user_guide/wsjtx-main.adoc

@@ -27,7 +27,6 @@ include::../common/links.adoc[]
 include::introduction.adoc[]
 
 [[NEW_FEATURES]]
-== New in Version 1.6
 include::new_features.adoc[]
 
 [[SYSREQ]]
@@ -131,7 +130,7 @@ include::wspr.adoc[]
 
 [[VHF_AND_UP]]
 == VHF Features
-include::vhf-and-up.adoc[]
+include::vhf-features.adoc[]
 
 [[MAKE_QSOS]]
 == Making QSOs