Commit Graph

49 Commits

Author SHA1 Message Date
Bill Somerville
46a6b75944
Repair User Guide file name, asciidoctor macros, web fetch URL 2020-11-16 03:07:35 +00:00
Joe Taylor
598835d9c9 First cut at adding FST4, FST4W to the User Guide. 2020-09-23 15:03:33 -04:00
Joe Taylor
43e02116bf Updates to User Guide: Dark Style, translated UIs, ... 2020-05-19 15:18:13 -04:00
Joe Taylor
3a7eda58ea Add a section on EME Tips to the User Guide. 2020-05-08 10:02:05 -04:00
Bill Somerville
c2f63637ee
Removed confusing and inaccurate HTML user Guide document footer 2019-11-27 19:18:45 +00:00
Joe Taylor
f13ed57eef Document "Best S+P" in the User Guide. 2019-07-18 15:14:59 -04:00
Joe Taylor
3b777860ca Add a User Guide tutorial section for FT4. 2019-06-06 14:15:12 -04:00
Joe Taylor
70b531fc44 Updates to User Guide; replace FT8 and MSK144 sample files with ones using new protocols. 2018-12-11 11:24:04 -05:00
Joe Taylor
94a4e90290 Several additions/tweaks to User Guide.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@8521 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2018-02-22 13:55:42 +00:00
Joe Taylor
c988a35019 Update the list of keyboard shortcuts.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@8157 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2017-10-02 18:33:17 +00:00
Joe Taylor
616d8d83da Update User Guide and "mouse_commands".
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@8154 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2017-10-02 13:49:37 +00:00
Joe Taylor
7dfc11b786 Add some FreqCal info to User Guide.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@8134 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2017-09-28 19:51:04 +00:00
Joe Taylor
fdc3d2d4d8 More User Guide updates.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@7997 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2017-08-03 18:18:34 +00:00
Joe Taylor
ed26d6a249 Updates to the WSJT-X User Guide for Version 1.8.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@7987 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2017-08-02 19:23:42 +00:00
Joe Taylor
253020f3f0 Update the WSJT-X User Guide to v1.8
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@7859 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2017-07-12 19:32:17 +00:00
Bill Somerville
0e214efb9c Rework install locations for better flexibility
Using the  CMake module  GNUInstallDirs to  set up  standard locations
which allows  better customisation for packagers  building for various
distributions.

The change does change some internal package file paths and will leave
some  files  in  old   locations  in  Windows  installations.  Running
uninstall  is probably  wise  on Windows  before  installing this  new
package layout if future clean uninstalls are desired.

Linux and other  *nix package maintainers can use  the CMake variables
CMAKE_INSTALL_xxx to vary the install paths of various components. See
the  CMake GNUInstallDirs  module documentation  for more  details. An
example might be for Slackware where package documents are expected to
be                            installed                           into
<install-prefix>/doc/<package-name>-<package-version>/ whereas the GNU
default         is         to        install         them         into
<install-prefix>/share/doc/<package-name>/.  To achieve  this set  the
CMake variable CMAKE_INSTALL_DOCDIR as follows when configuring:

cmake -D CMAKE_INSTALL_DOCDIR:PATH=doc/wsjtx-1.7.1 -D CMAKE_INSTALL_PREFIX= ...

git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@7623 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2017-03-28 13:03:48 +00:00
Joe Taylor
4d0c6c4466 Edit and add to User Guide.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@7284 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2016-11-03 19:14:07 +00:00
Joe Taylor
eed5bc0be5 Add description of information accompanying decoded text to User Guide.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@7281 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2016-11-02 20:25:51 +00:00
Joe Taylor
bf7c903318 Update the CMakeLists.txt for docs.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@7239 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2016-10-26 16:47:59 +00:00
Joe Taylor
ddeb1bab4e Many editorial changes to User Guide.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@7235 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2016-10-26 15:36:22 +00:00
Joe Taylor
40cf903db5 Many more additions to the WSJT-X User Guide.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@7228 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2016-10-25 18:04:33 +00:00
Joe Taylor
a251c045e3 Rationalize several VHF-oriented features of the JT4 and JT64 decoders. More additions to the User Guide.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@7227 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2016-10-24 20:48:24 +00:00
Joe Taylor
e4d10d4f19 Clarify what VHF-enabled JT65 messages get sent to the right window.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@7226 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2016-10-24 17:01:47 +00:00
Joe Taylor
149f9b4e38 Many more updates to WSJT-X v1.7 User Guide.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@7184 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2016-10-14 20:36:34 +00:00
Joe Taylor
e7c42fc9a2 Update the CMakeLists.txt for User Guide.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@7066 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2016-09-08 19:15:17 +00:00
Bill Somerville
59e59087bd Only generate USLetter size PDFs for languages that might need it
Only en-US, fr-CA, es-MX and es-CO use the USLetter paper size.

git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@6646 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2016-04-24 19:05:03 +00:00
Bill Somerville
0ba0977aa2 User Guide localization
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@6341 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2016-01-02 22:30:12 +00:00
Bill Somerville
c5ea6938d3 Another attempt to get installed locations right
That is, right for all platforms with both local and package installs.

git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@6248 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-12-08 20:39:50 +00:00
Bill Somerville
859a5ef416 Make install locations configuration variables
Locations  of various  components  to be  determined at  configuration
time.   This  allows   various   "Standard"  system   layouts  to   be
accomodated. For example on FreeBSD the manpages are usually installed
in the man directory i.e. /usr/local/man whereas the WSJT-X default is
to install them in share/man i.e. /usr/share/man. By setting the CMake
variable  WSJT_MANPAGE_DESTINATION to  either a  relative or  absolute
path the install location can be set:

  $ cmake -D WSJT_MANPAGE_DESTINATION=. ...

will install the manpages at ${CMAKE_INSTALL_PREFIX}/man

The new configuration variables are:

 WSJT_BIN_DESTINATION
 WSJT_LIB_DESTINATION
 WSJT_SHARE_DESTINATION
 WSJT_DOC_DESTINATION
 WSJT_DATA_DESTINATION
 WSJT_MANPAGE_DESTINATION
 WSJT_PLUGIN_DESTINATION
 WSJT_QT_CONF_DESTINATION

NB: changes to the above may break WSJT-X at present where the install
    locations of files used directly by WSJT-X are moved.

Warning: using absolute  paths for these variables  is not recommended
as files may be installed  in unexpected places, particularly when run
with  root  privileges.  All  relative   paths  with  be  relative  to
CMAKE_INSTALL_PREFIX.

git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@6192 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-11-26 19:45:10 +00:00
Bill Somerville
6c6a758b8b Add PDF generation to docs target
Cleaned  up   some  syntax   anomolies  because   of  the   switch  to
asciidoctor. Minor text tweaks to improve PDF pagination. Reduced HTML
master font size to 80% for better web rendering.

Removed references to KVASD from User Guide.

git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@6142 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-11-21 02:34:20 +00:00
Bill Somerville
dc672c4bb1 Switch to ascidoctor for User Guide generation
Requires Ruby and asciidoctor to be installed.

git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@6131 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-11-19 00:08:30 +00:00
Joe Taylor
c3ded3d418 Many more edits of the User Guide.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@6105 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-11-16 20:13:47 +00:00
Joe Taylor
4b07fa7cb1 More editing of User Guide. Bring some images up to Version 1.6.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@6102 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-11-16 00:11:40 +00:00
Joe Taylor
8609450974 Final (?) additions to WSJT-X User Guide for v1.6.0. Close reading
is now strongly encouraged!  We "go to press" soon!


git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@6090 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-11-13 20:26:41 +00:00
Joe Taylor
581577c421 Add Tool Tips for WSPR controls.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@6066 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-11-10 14:19:22 +00:00
Joe Taylor
36d7d7b484 Add a brief "Support" section to the WSJT-X User Guide. (Section 16.)
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5602 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-06-12 19:52:29 +00:00
Joe Taylor
fad969b9e0 More additions to User Guide for v1.6.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5480 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-05-31 15:58:33 +00:00
Joe Taylor
ebc2cb2ffb 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
2015-05-31 15:29:59 +00:00
Bill Somerville
0aa1e6605b Added graphic for JTAlert to user guide
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5438 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-05-28 02:07:15 +00:00
Bill Somerville
f41b03344e Fix up user guide sources for use in WSJT-X build
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5437 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-05-28 01:50:34 +00:00
Bill Somerville
aae320a3fe Clarify that documentation building is optional
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5428 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-05-27 22:06:59 +00:00
Bill Somerville
873579fecb Add an asciidoc theme so that project specific CSS can be used
The file doc/theme/wsjt.css is the theme  CSS file and it contains the
contents of the  standard asciidoc.css file followed  by WSJT specific
CSS overrides. If required a file  doc/theme/wsjt.js may be added at a
later date.

git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5369 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-05-12 21:32:18 +00:00
Bill Somerville
ec0c0786a9 Make CMake variable for asciidoc script less likely to be overridden
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5327 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-04-29 23:56:48 +00:00
Bill Somerville
b3c0c68af7 Ensure that asciidoc configuration file changes trigger doc builds
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5322 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-04-29 10:25:27 +00:00
Bill Somerville
bcffcf8aaa Use absolute path for Python interpreter to avoid picking up v3
Because asciidoc  doesn't work with Python  3 we must not  allow it to
run via  a shebang  or Windows  file association,  instead we  now use
find_package()  on Python  and  filter the  version.  This means  that
CMAKE_PREFIX_PATH   can  be   used  to   select  the   correct  Python
installation if there are more than one and one is v3 or newer.

git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5321 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-04-29 00:51:52 +00:00
Bill Somerville
98897e7f9d Solve the WSJT-X manual versioning issue
The user guide  is now installed with the product  version in the name
so  serving the  same  file from  the project  web  server will  allow
multiple manual versions to be easily supported.

git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5320 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-04-28 22:59:12 +00:00
Bill Somerville
1cf8a104a8 Added automatic VERSION attributes to asciidoc generation
Also tring a few minor technical formatting experiments.

Added  common asciidoc  files  to dependencies  so that  modifications
cause rebuilds.

git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5319 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-04-28 22:33:32 +00:00
Bill Somerville
3947b91098 Take out invalid custom command output that causes unnecessary rebuilds
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5317 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-04-28 19:44:23 +00:00
Bill Somerville
8440dd5af0 First attempt at adding the WSJT-X user guide to the CMake build
These documentation source files are not  the one true version, just a
copy for testing purposes. DO NOT EDIT THESE FILES.

To use this  on Windows you will need a  working asciidoc installation
and  the  path  to  it  must be  included  in  your  CMAKE_PREFIX_PATH
(probably via a  local CMake tool chain file). At  the time of writing
the official  asciidoc package does  not work on Windows.   The latest
development  master does  however  work,  it can  be  downloaded as  a
snapshot ZIP archive from here:

  https://github.com/asciidoc/asciidoc/archive/master.zip

git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5316 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-04-28 18:37:50 +00:00