Starting to update the User Guide to describe features new to v1.6.

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

doc/CMakeLists.txt

@@ -85,7 +85,7 @@ set (UG_IMGS
   user_guide/images/decode-menu.png
   user_guide/images/main-ui-1.5.png
   user_guide/images/r3666-main-ui-80.png
-  user_guide/images/settings-ui.png
+  user_guide/images/settings-general.png
   user_guide/images/wide-graph-controls.png
   user_guide/images/decodes.png
   user_guide/images/main-ui-controls.png
@@ -93,7 +93,7 @@ set (UG_IMGS
   user_guide/images/setup-menu.png
   user_guide/images/file-menu.png
   user_guide/images/misc-controls-center.png
-  user_guide/images/r4148-freq-ui.png
+  user_guide/images/settings-frequencies.png
   user_guide/images/special-mouse-commands.png
   user_guide/images/psk-reporter.png
   user_guide/images/jtalert.png

doc/user_guide/introduction.adoc

@@ -6,38 +6,47 @@ the program name stand for “Weak Signal communication by K1JT,” while
 the suffix “-X” indicates that _WSJT-X_ started as an extended (and
 experimental) branch of the program _WSJT_.
 
-_WSJT-X_ currently offers two protocols or “modes,” JT65 and JT9.
+_WSJT-X_ offers four protocols or “modes”: JT4, JT9, JT65 and WSPR.
-Both are designed for making reliable, confirmed QSOs under extreme
+The first three are designed for making reliable, confirmed QSOs under
-weak-signal conditions. They use nearly identical message structure
+extreme weak-signal conditions. They use nearly identical message
-and source encoding.  JT65 was designed for EME (“moonbounce”) on the
+structure and source encoding.  JT65 was designed for EME
-VHF/UHF bands and has also proven very effective for worldwide QRP
+(“moonbounce”) on the VHF/UHF bands and has also proven very effective
-communication on the HF bands.  JT9 is optimized for the LF, MF, and
+for worldwide QRP communication on the HF bands.  JT9 is optimized for
-lower HF bands.  It is about 2 dB more sensitive than JT65
+the LF, MF, and lower HF bands.  It is about 2 dB more sensitive than
-while using less than 10% of the bandwidth. Both modes use one-minute
+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
 timed sequences of alternating transmission and reception, so a
 minimal QSO takes four to six minutes — two or three transmissions by
 each station, one sending in odd UTC minutes and the other even. On
-the HF bands, world-wide QSOs are possible with power levels of a few
+the HF bands, world-wide QSOs are possible using power levels of a few
-watts and compromise antennas.
+watts and compromise antennas.  On VHF bands and higher, QSOs are
+possible (by EME and other propagation methods) at signal levels 10 to
+15 dB below those required for CW.
 
-_WSJT-X_ can display a passband as large as 5 kHz and provides
+WSPR (pronounced “whisper”) stands for Weak Signal Propagation
-dual-mode reception of both JT65 and JT9 signals. If your receiver can
+Reporter.  The WSPR protocol was designed for probing potential
-be configured with at least 4 kHz bandwidth in USB mode, you can set
+propagation paths using low-power transmissions. WSPR messages
-the dial frequency to one of the standard JT65 frequencies — for
+normally carry the transmitting station’s callsign, grid locator, and
-example, 14.076 MHz for the 20-meter band — and display the full JT65
+transmitter power in dBm, and they can be decoded at signal-to-noise
-and JT9 sub-bands simultaneously on the waterfall. You can then make
+ratios as low as -28 dB in a 2500 Hz bandwidth.  WSPR users with
-QSOs in both modes using nothing more than mouse clicks.
+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.
 
-Plans for future program development call for _WSJT-X_ and _WSJT_ to
+_WSJT-X_ provides spectral displays for passbands up to 5 kHz,
-merge together. _WSJT-X_ will gradually acquire additional modes
+flexible rig control for nearly all modern radios used by amateurs,
-such as JT4 that are now supported in _WSJT_. The entire
+and a wide variety of special aids such as automatic Doppler control
-WSJT-related effort is an open-source project, released under the 
+for EME QSOs.  The program runs equally well on Windows, Macintosh,
-{gnu_gpl} (GPL). If you have programming or
+and Linux systems, and installation packages are available for all
-documentation skills or would like to contribute to the project in
+three platforms.
-other ways, please make your interests known to the development team.
+
-The project’s source-code repository can be found at {devsvn}, and
+_WSJT-X_ is an open-source project released under the {gnu_gpl}
-most communication among the developers takes place on the email
+(GPL). If you have programming or documentation skills or would like
-reflector {devmail}.  User-level questions and answers, and general
+to contribute to the project in other ways, please make your interests
-communication among users is found on the {wsjt_yahoo_group} email
+known to the development team.  The project’s source-code repository
-reflector.
+can be found at {devsvn}, and most communication among the developers
+takes place on the email reflector {devmail}.  User-level questions
+and answers, and general communication among users is found on the
+{wsjt_yahoo_group} email reflector.
 

doc/user_guide/settings-frequencies.adoc

@@ -1,24 +1,32 @@
 // Status=review
 
 [[FIG_BAND_SETTINGS]]
-image::images/r4148-freq-ui.png[align="center",alt="Frequency Screen"]
+image::images/settings-frequencies.png[align="center",alt="Frequency Screen"]
 
-_Working Frequencies_: By default the *Frequency* table lists the
+_Working Frequencies_: By default the *Working Frequency* table
-currently recommended dial frequencies for JT65. JT9 frequencies
+contains a list of currently recommended dial frequencies for each
-generally start 2 kHz higher.  You can modify the frequency table as
+mode.  You can modify the frequency table as desired.
-desired.
 
 - To change an existing entry, click to select it, type a desired
 frequency in MHz, and hit *Enter* on the keyboard. The program will
 format your frequency value appropriately and add a band designator.
 
 - To add a new entry, right-click anywhere on the frequency table and
-select *Insert*.  Enter a frequency in MHz in the popup box, then
+select *Insert*.  Enter a frequency in MHz in the popup box and select
-click *OK*.  The table may include more than one frequency for a given
+the desired mode (or leave the Mode selection blank).  Then click
-band.
+*OK*.  The table may include more than one frequency for a given band.
 
 - To delete an entry, right-click it and select *Delete*.
 
+- Click the *Reset* button to return the table to its default
+configuration.
+
+_Frequency Calibration_: If you have calibrated your radio with the
+technique described (...here...), 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.
+
 _Station Information_: You can save *Band*, *Offset* and *Antenna
 Description* information for your station.  The antenna information
 will be included in reception reports sent to {pskreporter}.  By

doc/user_guide/settings-general.adoc

@@ -1,6 +1,6 @@
 // Status=review
 [[FIG_CONFIG_STATION]]
-image::images/settings-ui.png[align="center",alt="Settings Window"]
+image::images/settings-general.png[align="center",alt="Settings Window"]
 
 Select the *General* tab on the *Settings* window.  Under _Station
 Details_, enter your call sign and 4-digit or 6-digit grid locator.

doc/user_guide/system-requirements.adoc

@@ -2,7 +2,7 @@
 
 - SSB transceiver and antenna 
 - Computer running Windows (XP or later), Linux, or OS X
-- 1.5 GHz or faster CPU and 100 MB of available memory
+- 1.5 GHz or faster CPU and 200 MB of available memory
 - Monitor with at least 1024 x 780 resolution
 - Computer-to-radio interface using a serial port for T/R switching, 
   or CAT control, or VOX, as required for your radio-to-computer connections