From 10bda6b6d2e3ffbcc3ca38ff11741d769bfcbbf7 Mon Sep 17 00:00:00 2001 From: Joe Taylor Date: Mon, 31 Oct 2016 17:23:51 +0000 Subject: [PATCH] A number of minor edits to the User Guide -- mostly thanks to Roger, VE1SKY. git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@7271 ab8295b8-cf94-4d9e-aec4-7959e3be5d79 --- about.cpp | 2 +- doc/common/links.adoc | 1 + doc/user_guide/en/acknowledgements.adoc | 2 +- doc/user_guide/en/astro_data.adoc | 8 ++-- .../en/controls-functions-wide-graph.adoc | 8 ++-- doc/user_guide/en/faq.adoc | 4 +- doc/user_guide/en/make-qso.adoc | 4 +- doc/user_guide/en/protocols.adoc | 38 +++++++++---------- doc/user_guide/en/settings-general.adoc | 2 +- doc/user_guide/en/tutorial-example1.adoc | 4 +- doc/user_guide/en/vhf-features.adoc | 2 +- doc/user_guide/en/wspr.adoc | 4 +- 12 files changed, 40 insertions(+), 39 deletions(-) diff --git a/about.cpp b/about.cpp index 1a1eef541..4cf626bdc 100644 --- a/about.cpp +++ b/about.cpp @@ -22,7 +22,7 @@ CAboutDlg::CAboutDlg(QWidget *parent) : "acknowledgment for contributions from AC6SL, AE4JY,
" "DJ0OT, G3WDG, G4KLA, G4WJS, IV3NWV, IW3RAB, K3WYC, K9AN,
" "KA6MAL, KA9Q, KB1ZMX, KD6EKQ, KI7MT, KK1D, ND0B, PY2SDR,
" - "VK3ACF, VK4BDJ, VK7MO, W4TI, W4TV, and W9MDB.

" + "VE1SKY, VK3ACF, VK4BDJ, VK7MO, W4TI, W4TV, and W9MDB.

" "WSJT-X is licensed under the terms of Version 3
" "of the GNU General Public License (GPL)
" "" diff --git a/doc/common/links.adoc b/doc/common/links.adoc index 1e825f034..803797392 100644 --- a/doc/common/links.adoc +++ b/doc/common/links.adoc @@ -74,6 +74,7 @@ d). Edit lines as needed. Keeping them in alphabetic order help see dupes. :jtalert: http://hamapps.com/[JT-Alert] :launchpadki7mt: https://launchpad.net/~ki7mt[KI7MT PPA's] :log4om: http://www.log4om.com[Log4OM] +:lunarEchoes: http://physics.princeton.edu/pulsar/K1JT/LunarEchoes_QEX.pdf[QEX] :msys_url: http://sourceforge.net/projects/mingwbuilds/files/external-binary-packages/[MSYS Download] :ntpsetup: http://www.satsignal.eu/ntp/setup.html[Network Time Protocol Setup] :osx_instructions: http://physics.princeton.edu/pulsar/K1JT/OSX_Readme[Mac OS X Install Instructions] diff --git a/doc/user_guide/en/acknowledgements.adoc b/doc/user_guide/en/acknowledgements.adoc index 9e0d07075..2afa8e7a5 100644 --- a/doc/user_guide/en/acknowledgements.adoc +++ b/doc/user_guide/en/acknowledgements.adoc @@ -10,7 +10,7 @@ programs. For _WSJT-X_ in particular, we acknowledge contributions from *AC6SL, AE4JY, DJ0OT, G3WDG, G4KLA, G4WJS, IV3NWV, IW3RAB, K3WYC, K9AN, -KA6MAL, KA9Q, KB1ZMX, KD6EKQ, KI7MT, KK1D, ND0B, PY2SDR, VK3ACF, +KA6MAL, KA9Q, KB1ZMX, KD6EKQ, KI7MT, KK1D, ND0B, PY2SDR, VE1SKY, VK3ACF, VK4BDJ, VK7MO, W4TI, W4TV, and W9MDB*. Each of these amateurs has helped to bring the program’s design, code, testing, and/or documentation to its present state. diff --git a/doc/user_guide/en/astro_data.adoc b/doc/user_guide/en/astro_data.adoc index 5dd0043dc..dcdc2800e 100644 --- a/doc/user_guide/en/astro_data.adoc +++ b/doc/user_guide/en/astro_data.adoc @@ -1,6 +1,6 @@ A text box entitled Astronomical Data provides information needed for -tracking the sun or moon, moon, compensating for EME Doppler shift, -and estimating EME Doppler spread and path degradation. Toggle the +tracking the sun or moon, compensating for EME Doppler shift, and +estimating EME Doppler spread and path degradation. Toggle the *Astronomical data* on the *View* menu to display or hide this window. image::AstroData_2.png[align="center",alt="Astronomical Data"] @@ -31,8 +31,8 @@ example, the celestial coordinates of the moon or a planet can be determined at a specified time to within about 0.0000003 degrees. The JPL ephemeris tables and interpolation routines have been incorporated into _WSJT-X_. Further details on accuracy, especially concerning -calculated EME Doppler shifts, are described in QEX (###reference to -come###). +calculated EME Doppler shifts, are described in {lunarEchoes} for +November-December, 2016. The sky background temperatures reported by _WSJT-X_ are derived from the all-sky 408 MHz map of Haslam et al. (Astronomy and Astrophysics diff --git a/doc/user_guide/en/controls-functions-wide-graph.adoc b/doc/user_guide/en/controls-functions-wide-graph.adoc index 40cf45c12..e269f1e17 100644 --- a/doc/user_guide/en/controls-functions-wide-graph.adoc +++ b/doc/user_guide/en/controls-functions-wide-graph.adoc @@ -20,10 +20,10 @@ frequency. - *Start nnn Hz* sets the low-frequency starting point of the waterfall frequency scale. -- *N Avg* is the number of successive FFTs to be averaged before -updating the spectral display. Values around 5 are suitable for -normal JT9 and JT65 operation. Adjust *N Avg* to make the waterfall -move faster or slower, as desired. +- *N Avg* is the number of successive spectra to be averaged before +updating the display. Values around 5 are suitable for normal JT9 and +JT65 operation. Adjust *N Avg* to make the waterfall move faster or +slower, as desired. - A dropdown list below the *Palette* label lets you select from a wide range of waterfall color palettes. diff --git a/doc/user_guide/en/faq.adoc b/doc/user_guide/en/faq.adoc index ecb26fd46..64568daac 100644 --- a/doc/user_guide/en/faq.adoc +++ b/doc/user_guide/en/faq.adoc @@ -39,7 +39,7 @@ passband, if such control is available. How should I configure _WSJT-X_ to run multiple instances?:: -Start _WSJT-X_ from a command-prompt window, passing each instance a +Start _WSJT-X_ from a command-prompt window, assigning each instance a unique identifier as in the following two-instance example. This procedure will isolate the *Settings* file and the writable file location for each instance of _WSJT-X_. @@ -69,6 +69,6 @@ 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 diff --git a/doc/user_guide/en/make-qso.adoc b/doc/user_guide/en/make-qso.adoc index 9bf549227..b9d527d45 100644 --- a/doc/user_guide/en/make-qso.adoc +++ b/doc/user_guide/en/make-qso.adoc @@ -36,7 +36,7 @@ and audible (to someone with very good hearing) around –15 dB. Thresholds for decodability are around -23 dB for JT4, –24 dB for JT65, –26 dB for JT9. -=== Free Text Messages +=== Free-Text Messages Users often add some friendly chit-chat at the end of a QSO. Free-format messages such as "`TNX ROBERT 73`" or "`5W VERT 73 GL`" @@ -115,7 +115,7 @@ will receive it. You can check to see that you are actually transmitting the message you wish to send. QSOs involving *Type 2* compound callsigns might look like either -of the following sequences +of the following sequences: CQ K1ABC/VE1 FN75 K1ABC G0XYZ IO91 diff --git a/doc/user_guide/en/protocols.adoc b/doc/user_guide/en/protocols.adoc index 5161652c4..580980148 100644 --- a/doc/user_guide/en/protocols.adoc +++ b/doc/user_guide/en/protocols.adoc @@ -147,28 +147,28 @@ comparable to tone spacing. |===================================== |Mode |Tone Spacing |BW (Hz)|S/N (dB) |JT4A |4.375| 17.5 |-23 -|JT4B |8.75 | 35.0 |-22 -|JT4C |17.5 | 70.0 |-21 -|JT4D |39.375| 157.5 |-20 -|JT4E |78.75| 315.0 |-19 -|JT4F |157.5| 630.0 |-18 -|JT4G |315.0| 1260.0 |-17 +|JT4B |8.75 | 30.6 |-22 +|JT4C |17.5 | 56.9 |-21 +|JT4D |39.375| 122.5 |-20 +|JT4E |78.75| 240.6 |-19 +|JT4F |157.5| 476.9 |-18 +|JT4G |315.0| 949.4 |-17 |JT9A |1.736| 15.6 |-27 -|JT9B |3.472| 15.6 |-26 -|JT9C |6.944| 15.6 |-25 -|JT9D |13.889| 15.6 |-24 -|JT9E |27.778| 250 |-23 -|JT9F |55.556| 500 |-22 -|JT9G |111.111| 2000 |-21 -|JT9H |222.222| 2000 |-20 +|JT9B |3.472| 29.5 |-26 +|JT9C |6.944| 57.3 |-25 +|JT9D |13.889| 112.8 |-24 +|JT9E |27.778| 224.0 |-23 +|JT9F |55.556| 446.2 |-22 +|JT9G |111.111|890.6 |-21 +|JT9H |222.222|1779.5|-20 |JT65A |2.692| 177.6 |-25 -|JT65B |5.383| 355.3 |-25 -|JT65C |10.767| 710.6 |-25 +|JT65B |5.383| 352.6 |-25 +|JT65C |10.767| 702.5 |-25 |QRA64A|1.736| 111.1 |-26 -|QRA64B|3.472| 222.2 |-26 -|QRA64C|6.944| 444.4 |-26 -|QRA64D|13.889| 888.8 |-26 -|QRA64E|27.778|1777.8 |-26 +|QRA64B|3.472| 220.5 |-25 +|QRA64C|6.944| 439.2 |-24 +|QRA64D|13.889| 876.7 |-23 +|QRA64E|27.778|1751.7 |-22 |===================================== [[FAST_MODES]] diff --git a/doc/user_guide/en/settings-general.adoc b/doc/user_guide/en/settings-general.adoc index 8c68eb8b9..5bf07b89d 100644 --- a/doc/user_guide/en/settings-general.adoc +++ b/doc/user_guide/en/settings-general.adoc @@ -3,7 +3,7 @@ image::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. +Details_, enter your callsign and 4-digit or 6-digit grid locator. This information will be sufficient for initial tests. Meanings of remaining options on the *General* tab should be diff --git a/doc/user_guide/en/tutorial-example1.adoc b/doc/user_guide/en/tutorial-example1.adoc index 040584255..bee64ca5e 100644 --- a/doc/user_guide/en/tutorial-example1.adoc +++ b/doc/user_guide/en/tutorial-example1.adoc @@ -7,7 +7,7 @@ those shown in the screen shot below. - Select *File | Open* and select the file +...\save\samples\JT9\130418_1742.wav+. When the file opens you should -see something similar to the to the following screen shot: +see something similar to the following screen shot: [[X12]] image::main-ui.png[align="center",alt="Main UI and Wide Graph"] @@ -76,7 +76,7 @@ behavior can also be forced by checking *Lock Tx=Rx*. sending "`73`" to K1JT, signifying that the QSO is over. Most likely you want to send 73 to him, so the message "`KF4RWA K1JT 73`" is automatically generated and selected for your next transmission. -(Alternatively, you might choose to send a free text message or to +(Alternatively, you might choose to send a free-text message or to call CQ again.) - Click somewhere on the waterfall to set Rx frequency (green marker diff --git a/doc/user_guide/en/vhf-features.adoc b/doc/user_guide/en/vhf-features.adoc index 42c9ecf86..9a6b85501 100644 --- a/doc/user_guide/en/vhf-features.adoc +++ b/doc/user_guide/en/vhf-features.adoc @@ -191,7 +191,7 @@ Graph* spectral display. image::MSK144.png[align="center",alt="MSK144"] -Unlike other _WSJT-X modes, MSK144 decodes signals in real time, +Unlike other _WSJT-X_ modes, the MSK144 decoder operates in real time during the reception sequence. Decoded messages will appear on your screen almost as soon as you hear them. diff --git a/doc/user_guide/en/wspr.adoc b/doc/user_guide/en/wspr.adoc index 99d4472ea..c5d28944e 100644 --- a/doc/user_guide/en/wspr.adoc +++ b/doc/user_guide/en/wspr.adoc @@ -26,7 +26,7 @@ hopping enables a sizable group of stations around the world to move together from band to band, thereby maximizing the chances of identifying open propagation paths. -- To enable automatic band-hopping, check the *Band Hopping* box on +- To enable automatic band hopping, check the *Band Hopping* box on the main window. - Click *Schedule* to open the *WSPR Band Hopping* window, and select @@ -71,7 +71,7 @@ meters. You must write your own program, script, or batch file to do the necessary switching at your station. The following screen shot is an example of WSPR operation with -band-hopping enabled: +band hopping enabled: image::WSPR_2.png[align="center",alt="WSPR_2"]