More User Guide updates.

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

doc/CMakeLists.txt

@@ -22,6 +22,7 @@ set (UG_SRCS
   controls-functions-status-bar.adoc
   controls-functions-wide-graph.adoc
   cooperating-programs.adoc
+  decoder_notes.adoc
   faq.adoc
   font-sizes.adoc
   install-from-source.adoc
@@ -29,11 +30,11 @@ set (UG_SRCS
   install-mac.adoc
   install-windows.adoc
   introduction.adoc
+  measurement_tools.adoc
   protocols.adoc
   logging.adoc
   make-qso.adoc
   new_features.adoc
-  odds_and_ends.adoc
   platform-dependencies.adoc
   protocols.adoc
   settings-advanced.adoc

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

@@ -25,7 +25,7 @@ and audio Tx frequency.
 * Check the box *Lock Tx=Rx* to make the frequencies always track one
 another.
 
-TIP: In general we do not recommend using *Lock Tx=Rx* since it
+IMPORTANT: In general we do not recommend using *Lock Tx=Rx* since it
 encourages poor radio etiquette when running a frequency.  With this
 box checked, your own Tx frequency will move around following your
 callers.

doc/user_guide/en/decoder_notes.adoc

@@ -90,15 +90,3 @@ End of line information::
  `R` - Return code from QRA64 decoder +
  `T` - Length of analyzed region (s)
 
-
-
-=== Reference Spectrum
-
-WSJT-X provides a tool that can be used to determine the detailed
-shape of your receiver's passband.  Disconnect your antenna or tune to
-a quiet frequency with no signals.  With WSJT-X running in one of the
-slow modes, select *Measure reference spectrum* from the *File* menu.
-Wait for about a minute and then hit the *Stop* button.  A file named
-`refspec.dat` should appear in your log directory.  
-
- [ ... more to come ...]

doc/user_guide/en/make-qso.adoc

@@ -31,10 +31,10 @@ lie in the range –30 to –1 dB, and values are significantly compressed
 above about -10 dB.  JT9 supports the extended range –50 to +49 dB and
 assigns more reliable numbers to relatively strong signals.
 
-NOTE: Signals become visible on the waterfall around S/N = –26 dB
+NOTE: Signals become visible on the waterfall around S/N = –26 dB and
-and audible (to someone with very good hearing) around –15
+audible (to someone with very good hearing) around –15 dB. Thresholds
-dB. Thresholds for decodability are around -23 dB for JT4, –24 dB for
+for decodability are around -20 dB for FT8, -23 dB for JT4, –25 dB for
-JT65, –26 dB for JT9.
+JT65, –27 dB for JT9.
 
 === Free-Text Messages
 
@@ -50,11 +50,11 @@ or rag-chewing.
 === Auto-Sequencing
 
 The slow modes JT4, JT9, JT65, and QRA64 allow nearly 10 seconds at
-the end of each one-minute receiving sequence in which you can inspect
+the end of each one-minute receiving sequence -- enough time for you
-decoded messages and decide how to reply.  With its 15-second T/R
+to inspect decoded messages and decide how to reply.  The 15-second
-cycles, FT8 allows only about two seconds for this task.  For this
+T/R cycles of FT8 allow only about two seconds for this task, which is
-reason a basic auto-sequencing feature is offered. Check *Auto Seq*
+often not enough.  For this reason a basic auto-sequencing feature is
-on the main window to enable this feature:
+offered. Check *Auto Seq* on the main window to enable this feature:
 
 image::auto-seq.png[align="center",alt="AutoSeq"]
 
@@ -62,7 +62,7 @@ When calling CQ you may also choose to check the box *Call 1st*.
 _WSJT-X_ will then respond automatically to the first decoded
 responder to your CQ.
 
-TIP: When *Auto-Seq* is enabled the program will de-activate *Enable
+NOTE: When *Auto-Seq* is enabled the program de-activates *Enable
 Tx* at the end of each QSO.  We do not want _WSJT-X_ to make fully
 automated QSOs.
 
@@ -129,7 +129,7 @@ In each case, the compound callsign is treated as *Type 2* because the
 add-on prefix or suffix is _not_ one of those in the fixed list.  Note
 that a second callsign is never permissible in these messages.
 
-TIP: During a transmission your outgoing message is displayed in the
+NOTE: During a transmission your outgoing message is displayed in the
 first label on the *Status Bar* and shown exactly as another station
 will receive it.  You can check to see that you are actually
 transmitting the message you wish to send.

doc/user_guide/en/measurement_tools.adoc

@@ -0,0 +1,14 @@
+=== Calibrating Your Radio
+
+ [ ... TBD ... ]
+
+=== Reference Spectrum
+
+WSJT-X provides a tool that can be used to determine the detailed
+shape of your receiver's passband.  Disconnect your antenna or tune to
+a quiet frequency with no signals.  With WSJT-X running in one of the
+slow modes, select *Measure reference spectrum* from the *File* menu.
+Wait for about a minute and then hit the *Stop* button.  A file named
+`refspec.dat` should appear in your log directory.  
+
+ [ ... more to come ...]

doc/user_guide/en/new_features.adoc

@@ -17,15 +17,15 @@ added to _WSJT-X_ since Version 1.7.0:
 windows
     
 - New set of suggested default frequencies specific to the three IARU
-Regions.
+regions
 
 - Enhanced scheme for managing table of suggested default operating
 frequencies
 
 - Improved CAT control for many radios, including those controlled
-through Commander or OmniRig.
+through Commander or OmniRig
 
-- Bug fixes and tweaks to user interface
+- Bug fixes and minor tweaks to user interface
 
 === Documentation Conventions
 

doc/user_guide/en/settings-advanced.adoc

@@ -11,10 +11,6 @@ purposes a good setting is 6 or 7.
 decodes using Deep Search.  Higher numbers will display results 
 with lower confidence levels.
 
-- Check *FT8 and MSK144 Contest Mode* to enable generation and
-auto-sequencing of MSK144 messages with four-character grid locators
-in place of signal reports.
-
 - Check *Two-pass decoding* to enable a second decoding pass after
 signals producing first-pass decodes have been subtracted from the
 received data stream.
@@ -35,6 +31,10 @@ 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.
 
+- Check *FT8 and MSK144 Contest Mode* to enable generation and
+auto-sequencing of MSK144 messages with four-character grid locators
+in place of signal reports.
+
 - Check *x 2 Tone spacing* to generate Tx audio with twice the normal
 tone spacing.  This feature is intended for use with specialized LF/MF
 transmitters that divide the audio waveform by 2 before further

doc/user_guide/en/settings-audio.adoc

@@ -37,5 +37,5 @@ window is displayed.
 - _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* on the main window, the power slider will change
+you click the *Tune* button on the main window, the power slider will
-to the most recent setting used for *Tune* on the band in use.
+change to the most recent setting used for *Tune* on the band in use.

doc/user_guide/en/settings-general.adoc

@@ -17,6 +17,6 @@ NOTE: If you are using a callsign with an add-on prefix or
 suffix, or wish to work a station using such a call, be sure to read
 the section <<COMP-CALL,Compound Callsigns>>.
 
-IMPORTANT: Enabling VHF/UHF/Microwave features necessarily disables
+NOTE: Enabling VHF/UHF/Microwave features necessarily disables the
-the wideband multi-decode capability of JT65.  In most circumstances
+wideband multi-decode capability of JT65.  In most circumstances you
-you should turn this feature off when operating at HF.
+should turn this feature off when operating at HF.

doc/user_guide/en/settings-radio.adoc

@@ -2,9 +2,9 @@
 
 image::RadioTab.png[align="center",alt="Radio Tab"]
 
-_WSJT-X_ offers CAT (Computer Aided Transceiver) control of the
+_WSJT-X_ offers CAT (Computer Aided Transceiver) control of relevant
-relevant features of most modern transceivers.  To configure the
+features of most modern transceivers.  To configure the program for
-program for your radio, select the *Radio* tab.
+your radio, select the *Radio* tab.
 
 - Select your radio type from the drop-down list labeled *Rig*, or
 *None* if you do not wish to use CAT control.

doc/user_guide/en/system-requirements.adoc

@@ -2,13 +2,13 @@
 
 - SSB transceiver and antenna 
 - Computer running Windows (XP or later), Linux, or OS X
-- 1.5 GHz or faster CPU and 200 MB of available memory.  (MSK144
+- 1.5 GHz or faster CPU and 200 MB of available memory; faster
-especially benefits from a multi-core CPU)
+machines are better
 - Monitor with at least 1024 x 780 resolution
 - Computer-to-radio interface using a serial port or equivalent USB 
   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 
-  configured for sample rate 48000 Hz.
+  configured for sample rate 48000 Hz, 16 bits
 - Audio or equivalent USB connections between transceiver and computer  
 - A means for synchronizing the computer clock to UTC within ±1 second

doc/user_guide/en/transceiver-setup.adoc

@@ -46,9 +46,9 @@ clicks or glitches.  Make sure that this is true even when you
 simultaneously use the computer to do other tasks such as email, web
 browsing, etc.
 
-* Adjust the *Pwr" slider (at the right edge of the main window)
+* Adjust the *Pwr* slider (at right edge of main window) downward from
-downward from its maximum until the RF output from your transmitter
+its maximum until the RF output from your transmitter falls slightly.
-falls slightly.  This is generally a good level for audio drive.
+This is generally a good level for audio drive.
 
 * Toggle the *Tune* button once more or click *Halt Tx* to stop your
 test transmission.

doc/user_guide/en/tutorial-example3.adoc

@@ -46,5 +46,5 @@ This behavior is desirable so that you will not inadvertently change
 your Tx frequency to that of a tail-ender who called you somewhere
 else in the FT8 subband.
 
-IMPORTANT: When finished with this Tutorial, don’t forget to re-enter
+IMPORTANT: When finished with this Tutorial, don't forget to re-enter
 your own callsign as *My Call* on the *Settings | General* tab.

doc/user_guide/en/wsjtx-main.adoc

@@ -68,7 +68,7 @@ include::install-from-source.adoc[]
 Select *Settings* from the *File* menu or by typing *F2*.  (On
 Macintosh select *Preferences* from the _WSJT-X_ menu, or use the
 keyboard shortcut *Cmd+,*).  The following sections describe setup
-options available on each of seven tabs selectable near the top of the
+options available on each of eight tabs selectable near the top of the
 window.
 
 [[GENERAL]]
@@ -110,12 +110,12 @@ include::transceiver-setup.adoc[]
 [[TUTORIAL]]
 == Basic Operating Tutorial
 
-<<TUT_MAIN,Sections 6.1>> through <<TUT_EX2,6.4>> introduce basic user
+This section introduces the basic user controls and program behavior
-controls and program behavior of _WSJT-X_.  We suggest that new users
+of _WSJT-X_, with particular emphasis on the JT9, JT65, and FT8 modes.
-should go through the full HF-oriented tutorial, preferably while at
+We suggest that new users should go through the full HF-oriented
-your radio.  Subsequent sections cover additional details on
+tutorial, preferably while at your radio.  Subsequent sections cover
-<<MAKE_QSOS,Making QSOs>>, <<WSPR,WSPR mode>> and <<VHF_AND_UP,VHF+
+additional details on <<MAKE_QSOS,Making QSOs>>, <<WSPR,WSPR mode>>
-Features>>.
+and <<VHF_AND_UP,VHF+ Features>>.
 
 [[TUT_MAIN]]
 === Main Window Settings
@@ -184,9 +184,13 @@ include::controls-functions-wide-graph.adoc[]
 == Logging
 include::logging.adoc[]
 
-[[ODDS_AND_ENDS]]
+[[DECODER_NOTES]]
-== Odds and Ends
+== Decoder Notes
-include::odds_and_ends.adoc[]
+include::decoder_notes.adoc[]
+
+[[MEASUREMENT_TOOLS]]
+== Measurement Tools
+include::measurement_tools.adoc[]
 
 [[COOP_PGMS]]
 == Cooperating Programs
@@ -213,17 +217,6 @@ include::astro_data.adoc[]
 == Utility Programs
 include::utilities.adoc[]
 
-////
-[[TXRX]]
-== Implementation Details
-include::implementation.adoc[]
-
-[[TROUBLE_SHOOTING]]
-== Troubleshooting
-To be added (?) ...
-
-////
-
 [[SUPPORT]]
 == Support
 include::support.adoc[]