Don't call mskrtd if 1st or 2nd half of the 7168 samples are all zero.

Also more UserGuide edits...


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

doc/user_guide/en/install-windows.adoc

@@ -3,15 +3,16 @@
 Download and execute the package file {win32}, following these
 instructions:
 
-- Install _WSJT-X_ into its own directory such as `C:\WSJTX` or
-`C:\WSJT\WSJTX` rather than the conventional location
+- Install _WSJT-X_ into its own directory, for example `C:\WSJTX` or
+`C:\WSJT\WSJTX`, rather than the conventional location
 `C:\Program Files\WSJTX`.
 
 - All program files relating to _WSJT-X_ will be stored in the chosen
 installation directory and its subdirectories. 
 
 - Logs and other writeable files will normally be found in the 
-directory `C:\Users\<username>\AppData\Local\WSJT-X`.
+directory +
+`C:\Users\<username>\AppData\Local\WSJT-X`.
 
 IMPORTANT: Your computer may be configured so that this directory is
 "`invisible`".  It's there, however, and accessible.  An alternative

doc/user_guide/en/vhf-features.adoc

@@ -1,59 +1,59 @@
-[[VHF_SETUP]]
-=== VHF Setup
-
-_WSJT-X_ v1.7 builds on the features for VHF and higher bands first
-introduced in v1.6.  These features now include:
+_WSJT-X_ v1.7 introduces a number of new features designed for use
+on the VHF and higher bands.  These features now include:
 
 - *JT4*, a mode particularly useful for EME on the microwave bands
 
-- *QRA64*, a mode for EME using a "`Q-ary Repeat Accumulate`" code --
-a low-density partity-check (LDPC) code with a 64-character symbol
+- *JT9* fast modes, useful for scatter propagation on VHF bands
+
+- *QRA64*, a mode for EME using a "`Q-ary Repeat Accumulate`" code,
+a low-density partity-check (LDPC) code using a 64-character symbol
 alphabet
 
 - *MSK144*, a mode for meteor scatter using a binary LDPC code and
-Offset Quadrature Phase-Shift Keying (OQPSK), a waveform also
-describable as Minimum Shift Keying (MSK)
+Offset Quadrature Phase-Shift Keying (OQPSK).  The resulting waveform
+is sometimes called Minimum Shift Keying (MSK).
 
 - *ISCAT*, intended for aircraft scatter and other types of scatter
 propagation
 
 - *Echo* mode, for detecting and measuring your own lunar echoes
 
-- Automatic *Doppler tracking* for the EME path.  This is increasingly
-important on bands above 1.2 GHz.
+- *Doppler tracking*, which becomes increasingly important for EME
+on bands above 1.2 GHz.
 
-- Optional *Auto-sequencing* of messages for the fast modes.
+- *Auto-sequencing* of transmitted messages for the fast modes with
+forward error control
+
+[[VHF_SETUP]]
+=== VHF Setup
 
 To activate the VHF-and-up features:
 
-- Check the box labeled *Enable VHF/UHF/Microwave features* on the
+- Check *Enable VHF/UHF/Microwave features* and *Single decode* on the
 *Settings | General* tab.
 
-- In most cases you will also want to check *Single decode*.
-
-- If you will be doing EME, check the box *Decode at t = 52 s*
-to allow for the EME path delay on received signals.
+- For EME, check *Decode at t = 52 s* to allow for the extra path
+delay on received signals.
 
 - If you will use automatic Doppler tracking and your radio accepts
-frequency-setting commands while transmitting, check the box *Allow Tx
+frequency-setting commands while transmitting, check *Allow Tx
 frequency changes while transmitting*.  Transceivers known to permit
 such changes include the IC-735, IC-756 Pro II, IC-910-H, FT-817,
-FT-847, FT-857, FT-897, TS-590S, TS-590SG, TS-2000 (with Rev 9
-firmware upgrade), Flex 1500 and 5000, HPSDR, Anan-10, Anan-100, and
-KX3. On the *Radio* tab select *Split Operation* (use either *Rig* or
-*Fake It*; you may need to experiment with both options to find one
-that works best with your radio).
+FT-847, FT-857, FT-897, TS-590S, TS-590SG, TS-2000 (with Rev 9 or
+later firmware upgrade), Flex 1500 and 5000, HPSDR, Anan-10, Anan-100,
+and KX3.
 
-- If your radio does not accept commands to change frequency while
+IMPORTANT: If your radio does not accept commands to change frequency while
 transmitting, Doppler tracking will be approximated by making a single
 Tx frequency adjustment before a transmission starts, using a value
 computed for the middle of the Tx period.
 
-- The main window will reconfigure itself as necessary to display
-controls supporting the features of each mode.  For example, in JT4 mode
-the central part of the main window looks something like this:
+- On the *Radio* tab select *Split Operation* (use either *Rig* or
+*Fake It*; you may need to experiment with both options to find one
+that works best with your radio).
 
-image::VHF_controls.png[align="center",alt="VHF Controls"]
+The main window will reconfigure itself as necessary to display
+controls supporting the features of each mode.
 
 - If you are using transverters, set appropriate frequency offsets on
 the *Settings | Frequencies* tab.  Offset is defined as (transceiver
@@ -68,8 +68,8 @@ image::Add_station_info.png[align="center",alt="Station information"]
 
 - On the *View* menu, select *Astronomical data* to display a window
 with important information for tracking the Moon and performing
-automatic Doppler control.  Check the box labeled *Doppler tracking*
-to ensure that the right-hand portion of the window is visible.
+automatic Doppler control.  The right-hand portion of the window is
+invisible until you check *Doppler tracking*.
 
 image::Astronomical_data.png[align="center",alt="Astronomical data"]
 
@@ -79,35 +79,39 @@ Three different types of Doppler tracking are provided:
 and he/she will not be using any Doppler control.
 
 - Select *Receive only* to enable EME Doppler tracking of your receive
-frequency to a specific locator; your Tx frequency will remain fixed.
+frequency to a specific locator. Your Tx frequency will remain fixed.
 
 - 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`" would copy all of you on the selected nominal frequency.
+without the need for manual frequency changes.
 
 === JT4
 
-- Select *JT4* from the *Mode* menu.
+JT4 is highly effective for EME on the microwave bands, 2.3 GHz
+and above.
 
-- 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, submode JT4F is generally used
-for EME on the 10 GHz band.
+- Select *JT4* from the *Mode* menu.  The central part of the main
+window will look something like this:
 
-- The JT4 decoder in _WSJT-X_ includes optional capabilities for
-averaging over successive transmissions, and correlation decoding,
-also known as "`Deep Search`".  Either or both of these options may
-be selected from the *Decode* menu.
+image::VHF_controls.png[align="center",alt="VHF Controls"]
+
+- Select the desired *Submode*, which determines the spacing of
+transmitted tones. Wider spacings are used on the higher microwave
+bands to allow for larger Doppler spreads. For example, submode JT4F
+is generally used for EME on the 5.7 and 10 GHz bands.
+
+- For EME QSOs some operators use short-form JT4 messages consisting
+of a single tone.  To activate automatic generation of these messages,
+check the box labeled *Sh*.
+
+- Select *Deep* from the *Decode* menu.  You may also choose to enable
+averaging over successive transmissions and/or correlation decoding,
+also known as "`Deep Search`".
 
 image::decoding_depth.png[align="center",alt="Decoding Depth"]
 
-- By convention, EME with JT4 can use "`short form`" messages
-consisting of a single tone.  To activate automatic generation of
-these messages, check the box labeled *Sh* on the main window.
-
 IMPORTANT: Additional hints for using JT4 and Echo mode on the
 EME path have been compiled by G3WDG and are available here: {jt4eme}.
 

doc/user_guide/en/wsjtx-main.adoc

@@ -39,9 +39,10 @@ include::system-requirements.adoc[]
 [[INSTALL]]
 == Installation
 
-Installation packages for Windows, Linux, and OS X are found on the
-the {homepage}. Click on the _WSJT-X_ link at the left margin, and
-then select the appropriate package for your operating system.
+Installation packages for released versions on Windows, Linux, and OS
+X are found on the the {homepage}. Click on the _WSJT-X_ link at the
+left margin and select the appropriate package for your operating
+system.
 
 [[INSTALL_WIN]]
 === Windows
@@ -109,13 +110,12 @@ include::transceiver-setup.adoc[]
 [[TUTORIAL]]
 == Basic Operating Tutorial
 
-<<TUT_MAIN,Sections 6.1>> through <<TUT_EX2,6.4>> introduce the basic
-user controls and program behavior of _WSJT-X_.  We suggest that new
-users should go through the full HF-oriented tutorial, preferably
-while at your radio.  Details on the standard message structure used
-for making two-way QSOs are found in <<MAKE_QSOS,Section 7>>, followed
-by sections covering <<WSPR,WSPR mode>> and features for
-<<VHF_AND_UP,VHF and above>>.
+<<TUT_MAIN,Sections 6.1>> through <<TUT_EX2,6.4>> introduce basic user
+controls and program behavior of _WSJT-X_.  We suggest that new users
+should go through the full HF-oriented tutorial, preferably while at
+your radio.  Subsequent sections cover additional details on
+<<MAKE_QSOS,Making QSOs>>, <<WSPR,WSPR mode>> and <<VHF_AND_UP,VHF+
+Features>>.
 
 [[TUT_MAIN]]
 === Main Window Settings

doc/user_guide/en/wspr.adoc

@@ -6,10 +6,10 @@ used in WSPR mode.
 
 image::WSPR.png[align="center",alt="WSPR mode"]
 
-- Use the mouse to set the width and height of the main window as
-desired.
+- Use the mouse to drag the width and height of the main window to the
+desired size.
 
-- Select an active WSPR frequency (for example, 10.1387 MHz).
+- Select an active WSPR frequency (for example, 10.1387 or 14.0956 MHz).
 
 - Click *Monitor* to start a WSPR receiving period.
 

lib/hspec.f90

@@ -76,6 +76,11 @@ subroutine hspec(id2,k,nutc0,ntrpdepth,nrxfreq,ntol,bmsk144,ingain,   &
   if(bmsk144) then
      if(k.ge.7168) then
         tsec=(k-7168)/12000.0
+        k0=k-7168
+        tt1=sum(float(abs(id2(k0:k0+3583))))
+        k0=k-3584
+        tt2=sum(float(abs(id2(k0:k0+3583))))
+        if(tt.eq.0.0 .or. tt2.eq.0) print*,k,k/12000.0
         call mskrtd(id2(k-7168+1:k),nutc0,tsec,ntol,nrxfreq,ndepth,   &
              mycall,hiscall,bshmsg,line1)
      endif