From c6099eaca3dd1ee2c95042321e592538bbd5b740 Mon Sep 17 00:00:00 2001 From: Joe Taylor Date: Thu, 14 May 2020 18:56:35 -0400 Subject: [PATCH] More updates and corrections to User Guide. --- doc/user_guide/en/install-linux.adoc | 2 +- doc/user_guide/en/install-windows.adoc | 14 +++++++------- doc/user_guide/en/introduction.adoc | 17 ++++++++--------- doc/user_guide/en/settings-audio.adoc | 4 ++-- doc/user_guide/en/settings-frequencies.adoc | 11 ++++++----- doc/user_guide/en/settings-general.adoc | 3 ++- doc/user_guide/en/settings-radio.adoc | 4 ++-- doc/user_guide/en/settings-txmacros.adoc | 3 ++- doc/user_guide/en/wsjtx-main.adoc | 3 +-- 9 files changed, 31 insertions(+), 30 deletions(-) diff --git a/doc/user_guide/en/install-linux.adoc b/doc/user_guide/en/install-linux.adoc index 3f3ab91e3..b3075d66a 100644 --- a/doc/user_guide/en/install-linux.adoc +++ b/doc/user_guide/en/install-linux.adoc @@ -3,7 +3,7 @@ Debian, Ubuntu, and other Debian-based systems including Raspbian: NOTE: The project team release binary installer packages for Linux -when a new _WSJT-X_ release is announced, note that these are built to +when a new _WSJT-X_ release is announced. These are built to target one contemporary version of a Linux distribution. Although these may work on newer Linux versions or even different distributions, it is unlikely that they will work on older diff --git a/doc/user_guide/en/install-windows.adoc b/doc/user_guide/en/install-windows.adoc index 94fc7a3fa..faaf2ed4c 100644 --- a/doc/user_guide/en/install-windows.adoc +++ b/doc/user_guide/en/install-windows.adoc @@ -32,18 +32,18 @@ TIP: Your computer may be configured so that this directory is * image:LoTW_TLS_error.png[_WSJT-X_ LoTW download TLS error, role="right"] _WSJT-X_ requires the _OpenSSL_ libraries to be - installed. Suitable libraries may already be installed on your - system, if they are not you will see this error shortly after + installed, and suitable libraries may already be installed on your + system. If they are not you will see this error shortly after requesting a fetch of the latest LoTW users database. To fix this you need to install the _OpenSSL_ libraries. -** You can download a suitable _OpenSSL_ package for from - {win_openssl_packages}, you need the latest *Windows Light* +** You can download a suitable _OpenSSL_ package from + {win_openssl_packages}. You need the latest *Windows Light* version. For the 32-bit _WSJT-X_ build use the latest Win32 v1.1.x version of the _OpenSSL_ libraries, for the 64-bit _WSJT-X_ use the - latest Win64 v1.1.x version of the _OpenSSL_ libraries (Note it is - OK to install both versions on a 64-bit system) which at the time - of writing were {win32_openssl} and {win64_openssl} respectively. + latest Win64 v1.1.x version of the _OpenSSL_ libraries which at the + time of writing were {win32_openssl} and {win64_openssl}. It is OK + to install both versions on a 64-bit system. ** Install the package and accept the default options, including the option to copy the _OpenSSL_ DLLs to the Windows system diff --git a/doc/user_guide/en/introduction.adoc b/doc/user_guide/en/introduction.adoc index 9e9199725..0ea83757f 100644 --- a/doc/user_guide/en/introduction.adoc +++ b/doc/user_guide/en/introduction.adoc @@ -16,15 +16,14 @@ making reliable QSOs under weak-signal conditions. They use nearly identical message structure and source encoding. JT65 and QRA64 were designed for EME ("`moonbounce`") on the VHF/UHF bands and have also proven very effective for worldwide QRP communication on the HF bands. -QRA64 has a number of advantages over JT65, including better -performance on the very weakest signals. We imagine that over time it -may replace JT65 for EME use. JT9 was originally designed for the LF, -MF, and lower HF bands. Its submode JT9A is 2 dB more sensitive than -JT65 while using less than 10% of the bandwidth. JT4 offers a wide -variety of tone spacings and has proven highly effective for EME on -microwave bands up to 24 GHz. These four "`slow`" modes use -one-minute timed sequences of alternating transmission and reception, -so a minimal QSO takes four to six minutes — two or three +QRA64 has a some advantages over JT65, including better performance +for EME on the higher microwave bands. JT9 was originally designed +for the LF, MF, and lower HF bands. Its submode JT9A is 2 dB more +sensitive than JT65 while using less than 10% of the bandwidth. JT4 +offers a wide variety of tone spacings and has proven highly effective +for EME on microwave bands up to 24 GHz. These four "`slow`" 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. FT8 is operationally similar but four times faster (15-second T/R sequences) and less sensitive by a few dB. FT4 is diff --git a/doc/user_guide/en/settings-audio.adoc b/doc/user_guide/en/settings-audio.adoc index eff45aaa8..5779b8d27 100644 --- a/doc/user_guide/en/settings-audio.adoc +++ b/doc/user_guide/en/settings-audio.adoc @@ -1,9 +1,9 @@ // Status=review -image::settings-audio.png[align="center",alt="_WSJT-X_ Audio Configuration Screen"] - Select the *Audio* tab to configure your sound system. +image::settings-audio.png[align="center",alt="_WSJT-X_ Audio Configuration Screen"] + * _Soundcard_: Select the audio devices to be used for *Input* and *Output*. Usually the *Mono* settings will suffice, but in special cases you can choose *Left*, *Right*, or *Both* stereo channels. diff --git a/doc/user_guide/en/settings-frequencies.adoc b/doc/user_guide/en/settings-frequencies.adoc index a0d1015c1..52e20c58c 100644 --- a/doc/user_guide/en/settings-frequencies.adoc +++ b/doc/user_guide/en/settings-frequencies.adoc @@ -1,12 +1,13 @@ // Status=review [[FIG_BAND_SETTINGS]] -image::settings-frequencies.png[align="center",alt="Frequency Screen"] -_Working Frequencies_: By default, the *Working Frequencies* table -contains a list of frequencies conventionally used for modes FT8, JT4, -JT9, JT65, MSK144, WSPR, and Echo. Conventions may change with time -or by user preference; you can modify the frequency table as desired. +_By default, the *Working Frequencies* table contains a list of +frequencies conventionally used for modes FT8, JT4, JT9, JT65, MSK144, +WSPR, and Echo. Conventions may change with time or by user +preference; you can modify the frequency table as desired. + +image::settings-frequencies.png[align="center",alt="Frequency Screen"] - To change an existing entry, double-click to edit it, type a desired frequency in MHz or select from the drop down list of options, then diff --git a/doc/user_guide/en/settings-general.adoc b/doc/user_guide/en/settings-general.adoc index 9ae1621ff..bffa94f9a 100644 --- a/doc/user_guide/en/settings-general.adoc +++ b/doc/user_guide/en/settings-general.adoc @@ -1,6 +1,5 @@ // Status=review [[FIG_CONFIG_STATION]] -image::settings-general.png[align="center",alt="Settings Window"] Select the *General* tab on the *Settings* window. Under _Station Details_ enter your callsign, grid locator (preferably the 6-character @@ -9,6 +8,8 @@ Middle East, and Northern Asia; Region 2 the Americas; and Region 3 Southern Asia and the Pacific. This information will be sufficient for initial tests. +image::settings-general.png[align="center",alt="Settings Window"] + Meanings of remaining options on the *General* tab should be self-explanatory after you have made some QSOs using _WSJT-X_. You may return to set these options to your preferences later. diff --git a/doc/user_guide/en/settings-radio.adoc b/doc/user_guide/en/settings-radio.adoc index 11ef54f7a..e61d0998b 100644 --- a/doc/user_guide/en/settings-radio.adoc +++ b/doc/user_guide/en/settings-radio.adoc @@ -1,11 +1,11 @@ // Status=review -image::RadioTab.png[align="center",alt="Radio Tab"] - _WSJT-X_ offers CAT (Computer Aided Transceiver) control of relevant features of most modern transceivers. To configure the program for your radio, select the *Radio* tab. +image::RadioTab.png[align="center",alt="Radio Tab"] + * Select your radio type from the drop-down list labeled *Rig*, or *None* if you do not wish to use CAT control. diff --git a/doc/user_guide/en/settings-txmacros.adoc b/doc/user_guide/en/settings-txmacros.adoc index 0f31cb823..fb23d5344 100644 --- a/doc/user_guide/en/settings-txmacros.adoc +++ b/doc/user_guide/en/settings-txmacros.adoc @@ -1,11 +1,12 @@ // Status=review [[FigTxMacros]] -image::tx-macros.png[align="center",alt="Tx Macros Screen"] *Tx Macros* are an aid for sending brief, frequently used free-text messages such as the examples shown above. +image::tx-macros.png[align="center",alt="Tx Macros Screen"] + - To add a new message to the list, enter the desired text (up to 13 characters) in the entry field at top, then click *Add*. diff --git a/doc/user_guide/en/wsjtx-main.adoc b/doc/user_guide/en/wsjtx-main.adoc index a3cea81e0..c20bf4c9c 100644 --- a/doc/user_guide/en/wsjtx-main.adoc +++ b/doc/user_guide/en/wsjtx-main.adoc @@ -68,8 +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 eight tabs selectable near the top of the -window. +options available on eight tabs selectable near the top of the window. [[GENERAL]] === General