User guide updates for frequency calibration mode

Also some instances of non-italicized WSJT-X fixed.

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

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

@@ -5,7 +5,7 @@ and operation.  Most of the items are self-explanatory; a few
 additional details are provided below.  Keyboard shortcuts for some
 frequently used menu items are listed at the right edge of the menu.
 
-==== WSJT-X menu
+==== _WSJT-X_ menu
 image::MacAppMenu.png[align="left",alt="Mac App Menu"]
 
 This menu appears on the Macintosh only. *Settings* appears here,

doc/user_guide/en/decoder_notes.adoc

@@ -44,7 +44,7 @@ successful decode used MyCall as hypothetically known information.
 |===============================================
 
 Table 2 lists the six possible QSO states that are tracked by the
-WSJT-X auto-sequencer, along with the type of AP decoding that would
+_WSJT-X_ auto-sequencer, along with the type of AP decoding that would
 be attempted in each state.
 
 [[AP_DECODING_TYPES_TABLE]]

doc/user_guide/en/faq.adoc

@@ -69,6 +69,9 @@ command-prompt window:
  sudo apt remove appmenu-qt5
 
 +
-Alternatively, you can disable the common menu bar for just WSJT-X by starting the application with the environment variable QT_QPA_PLATFORMTHEME set to empty (the space after the '=' character is necessary):
+Alternatively, you can disable the common menu bar for just _WSJT-X_
+by starting the application with the environment variable
+QT_QPA_PLATFORMTHEME set to empty (the space after the '=' character
+is necessary):
 
  QT_QPA_PLATFORMTHEME= wsjtx

doc/user_guide/en/measurement_tools.adoc

@@ -30,19 +30,25 @@ in other parts of the world.
 - In most cases you will want to start by deleting any existing file
 `fmt.all` in the directory where your log files are kept.
 
-- Enter `0.0` for both *Slope* and *Intercept* under _Frequency
-Calibration_ on the *Settings -> Frequencies* tab.
-
 - To cycle automatically through your chosen list of calibration
 frequencies, check *Execute frequency calibration cycle* on the
-*Tools* menu.  _WSJT-X_ will spend 30 seconds at each frequency,
-writing its measurements to file `fmt.all` in the log directory.
+*Tools* menu.  _WSJT-X_ will spend 30 seconds at each
+frequency. Initially no measurement data is saved to the `fmt.all`
+file although it is displayed on screen, this allows you to check you
+current calibration parameters.
 
 - During the calibration procedure, the radio's USB dial frequency is
 offset 1500 Hz below each *FreqCal* entry in the default frequencies
 list.  As shown in the screen shot below, detected signal carriers
 therefore appear at about 1500 Hz in the _WSJT-X_ waterfall.
 
+- To start a measurement session check the *Measure* option and let
+the calibration cycle run for at least one complete sequence. Note
+that, while measuring, any existing calibration parameters are
+automatically disabled so you may have to increase the *FTol* range if
+your rig is off freqeuncy by more than a few Hertz in order to capture
+valid measurements.
+
 image::FreqCal.png[align="left",alt="FreqCal"]
 
 With modern synthesized radios, small measured offsets from 1500 Hz
@@ -78,18 +84,25 @@ displayed as in the following screen shot.  Estimated uncertainties
 are included for slope and intercept; `N` is the number of averaged
 frequency measurements included in the fit, and `StdDev` is the root
 mean square deviation of averaged measurements from the fitted
-straight line.
+straight line. If the solution seems valid you will be offered an
+*Apply* button to push that will automatically set the calibration
+parameters in *Settings -> Frequencies -> Frequency Calibration*.
 
 image::FreqCal_Results.png[align="center",alt="FreqCal_Results"]
 
+For a quick visual check of the resulting calibration, stay in
+*FreqCal* mode with the *Measure* option cleared. _WSJT-X_ will show
+the adjusted results directly on the waterfall and the displayed
+records.
+
 === 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 *Tools* menu.
-Wait for about a minute and then hit the *Stop* button.  A file named
-`refspec.dat` will appear in your log directory.  
+a quiet frequency with no signals.  With _WSJT-X_ running in one of
+the slow modes, select *Measure reference spectrum* from the *Tools*
+menu.  Wait for about a minute and then hit the *Stop* button.  A file
+named `refspec.dat` will appear in your log directory.
 
  [ ... more to come ... ]
 

doc/user_guide/en/settings-audio.adoc

@@ -1,6 +1,6 @@
 // Status=review
 
-image::settings-audio.png[align="center",alt="WSJT-X Audio Configuration Screen"]
+image::settings-audio.png[align="center",alt="_WSJT-X_ Audio Configuration Screen"]
 
 Select the *Audio* tab to configure your sound system.
 

doc/user_guide/en/wsjtx-main.adoc

@@ -1,5 +1,5 @@
 // This is a comment line, anything with // is ignored at process time.
-= WSJT-X User Guide
+= _WSJT-X_ User Guide
 Joseph H Taylor, Jr, K1JT
 :revnumber: {VERSION}
 // For web-pages, adding :badges: is ok, but is a security issue for