Skip to content

Commit 9961430

Browse files
committed
Documentation Updates - Including Qt Notes
1 parent 4f6d889 commit 9961430

48 files changed

Lines changed: 1821 additions & 117 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

docs/Qt/ADQT.html

Lines changed: 188 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,188 @@
1+
<!doctype html>
2+
<html>
3+
<head>
4+
<meta charset="utf-8">
5+
<meta name="keywords" content="JTSDK,Jt-ware,wsjtx,jtdx,js8call,build wsjtx,compile wsjtx,Qt,Windows,software,development">
6+
<title>Hamlib SDK v3.2.3 Deployment Guide</title>
7+
<link rel="stylesheet" href="../style-new.css">
8+
<link rel="shortcut icon" type="image/x-icon" href="../favicon.ico" />
9+
</head>
10+
11+
<body>
12+
13+
<table width="100%" border="0">
14+
<tr>
15+
<td>
16+
<table width="*" border="0">
17+
<tr>
18+
<td>
19+
<img src="../favicon.ico" alt=""/>
20+
</td>
21+
<td>
22+
<h1>HAMLIB SDK</h1>
23+
<h2>Evolving the JT-ware Software Developer's Kit (JTSDK)</h2>
24+
</td>
25+
</tr>
26+
</table>
27+
</td>
28+
<td align="right" style="vertical-align: top" >
29+
<a href="ALLQT.html"><img src="../UGIcon.png" width="34" height="33" alt=""/></a>
30+
<a href="../index.html"><img src="../HomeIcon.png" width="34" height="33" alt=""/></a>
31+
</td>
32+
</tr>
33+
</table>
34+
35+
<hr>
36+
<! –– Ref: https://css-tricks.com/the-simplest-ways-to-handle-html-includes/ ––>
37+
<iframe src="navQt.html" onload="this.insertAdjacentHTML('afterend', (this.contentDocument.body||this.contentDocument).innerHTML);this.remove()"></iframe>
38+
<!--
39+
<table width="100%" border="0">
40+
<tr>
41+
<td width="16.7%" align="center"><a href="./qt/BDQT.html">Basic-Deploy</a></td>
42+
<td width="16.7%" align="center"><a href="./qt/UDQT.html">Update-Deploy</a></td>
43+
<td width="16.6%" align="center"><a href="./qt/ADQT.html">Archive-Deploy</a></td>
44+
<td width="16.7%" align="center"><a href="./qt/QUQT.html">Questions</a></td>
45+
<td width="16.6%" align="center"><a href="https://sourceforge.net/projects/hamlib-sdk/">Sourceforge</a></td>
46+
<td width="16.7%" align="center"><a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-Stream/">Download</a</td>
47+
</tr>
48+
</table>
49+
-->
50+
<hr/>
51+
<h2>Qt Deployment - Archived Versions - Guide</h2>
52+
<hr>
53+
54+
<h3>Introduction</h3>
55+
<ul>
56+
<p>As of March 2024 <strong>Qt 5.15.2</strong> is no longer available from mainstream installer repositories.</p>
57+
<p>This does not mean that it is gone and that one cannot install it any more.</p>
58+
<p>The Qt Maintainers offer a facility whereby archived versions of their software can be obtained from selected servers.</p>
59+
<p>This guide details how to deploy Qt from Archive. It is based on a primary document stored at <a href="https://sourceforge.net/projects/hamlib-sdk/files/JTware-Deployment/Deploying-Archived-Versions-of-Qt-via-Maintenance-Tool.docx">https://sourceforge.net/projects/hamlib-sdk/files/JTware-Deployment/Deploying-Archived-Versions-of-Qt-via-Maintenance-Tool.docx</a> .</p>
60+
<p>Note: This guide assumes that a version of Qt i.e. <strong>Qt 6.2.2 </strong>is deployed.</p>
61+
</ul>
62+
63+
64+
<hr>
65+
<h2>Deployment</h2>
66+
<hr>
67+
68+
<h3>Step 1: Start the Qt Maintenance Tool</h3>
69+
70+
<ul>
71+
<p>The Qt Maintenance Tool <strong>MaintenanceTool.exe</strong> should be able to be found in your Qt deployment directory</p>
72+
<ul>
73+
<li>Open a Windows Terminal (it does not matter if it is <strong>CMD.EXE</strong> or <strong>PowerShell Terminal</strong>) i.e Start / Terminal</li>
74+
<li>Enter the command: <strong>./MaintenanceTool.exe</strong></li>
75+
</ul>
76+
</ul>
77+
<h3>Step 2: Log in with your Qt Account</h3>
78+
<ul>
79+
<p>You should be presented with a screen similar to that shown below:</p>
80+
</ul>
81+
<p ><img src="Qt-Step-2.jpg" alt="" width="940" height="624" class="center"/></p>
82+
<table width="*" align="center" border="1">
83+
<tr>
84+
<td class="custd">If you do not have a Qt Account then please sign up for one by clicking <strong>Sign Up</strong></td>
85+
</tr>
86+
</table>
87+
<ul>
88+
<ul>
89+
<li>Enter Your Password</li>
90+
<li>Click <strong>Next</strong></li>
91+
</ul>
92+
</ul>
93+
94+
<h3>Step 3: Add or Remove Components</h3>
95+
96+
<ul>
97+
<p>You should be presented with a screen similar to that shown below:</p>
98+
</ul>
99+
<p ><img src="Qt-Step-3a.jpg" alt="" width="940" height="624" class="center"/></p>
100+
<ul>
101+
<ul>
102+
<li>Ensure that <strong>Add or remove programs</strong> is selected</li>
103+
<li>Click <strong>Next</strong></li>
104+
</ul>
105+
<p>The Qt installer will now download components from its pool repository.</p>
106+
</ul>
107+
<p ><img src="Qt-Step-3b.jpg" alt="" width="940" height="624" class="center"/></p>
108+
<ul>
109+
<p>The Qt Maintenance Tool fetches update info for code released through mirrors …</p>
110+
<p>This is inadequate for us as it does not necessarily provide versions that we require.</p>
111+
<p>Wait until the metadata is completely loaded into the system.</p>
112+
</ul>
113+
114+
<h3>Step 4: Select the "Archive" Check Box</h3>
115+
116+
<ul>
117+
<p>You should be presented with a screen similar to that shown below:</p>
118+
</ul>
119+
<p ><img src="Qt-Step-4a.jpg" alt="" width="940" height="624" class="center"/></p>
120+
<ul>
121+
<ul>
122+
<li>Click “Archive” (circled in yellow)</li>
123+
<li>Click “Filter”</li>
124+
</ul>
125+
<p>This loads “Archive Repository” information into the Installer/Maintenance Tool</p>
126+
</ul>
127+
<p><img src="Qt-Step-4b.jpg" alt="" width="940" height="624" class="center"/></p>
128+
<ul>
129+
<p>It may take a few minutes do download the metadata and to contact/test sites where these “archived” deployments can be obtained from.</p>
130+
</ul>
131+
132+
<h3>Step 5: Select the Archived Version of Qt that you want to Deploy</h3>
133+
<ul>
134+
<p>In this example we will refer to Qt 5.15.2:</p>
135+
</ul>
136+
<p ><img src="Qt-Step-5a.jpg" alt="" width="940" height="624" class="center"/></p>
137+
<ul>
138+
<ul>
139+
<li>Expand “Qt” as shown</li>
140+
</ul>
141+
</ul>
142+
<p><img src="Qt-Step-5b.jpg" alt="" width="940" height="624" class="center"/></p>
143+
<ul>
144+
<ul>
145+
<li>Scroll down to “Developer and Designer Tools”</li>
146+
<li>Select the version that you want. i.e Select &ldquo;5.15.2&rdquo; (as shown). It is best at this stage to select EVERY component. </li>
147+
</ul>
148+
</ul>
149+
<p><img src="Qt-Step-5c.jpg" alt="" width="940" height="624" class="center"/></p>
150+
<ul>
151+
<ul>
152+
<li>Scroll down to &ldquo;Developer and Designer Tools&rdquo;</li>
153+
<li>Ensure that the MinGW 8.1.0 32 bit and MinGW 8.1.0 64-bit support tools environments are selected (as shown)</li>
154+
<li>The Next Button should be activated when you make any change. Click this button.</li>
155+
</ul>
156+
</ul>
157+
158+
<p ><img src="Qt-Step-5d.jpg" alt="" width="940" height="624" class="center"/></p>
159+
<ul>
160+
<ul>
161+
<li>Click Update.</li>
162+
</ul>
163+
</ul>
164+
<img src="Qt-Step-5e.jpg" alt="" width="940" height="624" class="center"/></p>
165+
<ul>
166+
<p>Updates should now occur (Note a Version 6.6.2 update progress is shown in this example).</p>
167+
<ul>
168+
<li>Click 'Finish' when complete (Not shown).</li>
169+
</ul>
170+
</ul>
171+
172+
<h3>Complete</h3>
173+
<ul>
174+
<p>Once complete your archived deploy should now be available.</p>
175+
</ul>
176+
<hr>
177+
<table width="100%" border="0">
178+
<tbody>
179+
<tr>
180+
<td>Editor: <a href="https://www.qrz.com/db/vk3vm">Steve VK3VM/VK3SIR</a></td>
181+
<td align="right"><a href="../hamlibdk [at] outlook.com"
182+
rel="nofollow"
183+
onclick="this.href='mailto:' + 'hamlibdk' + '@' + 'outlook.com'">Contact</a></td>
184+
</tr>
185+
</tbody>
186+
</table>
187+
</body>
188+
</html>

docs/Qt/ALLQT.html

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,104 @@
1+
<!doctype html>
2+
<html>
3+
<head>
4+
<meta charset="utf-8">
5+
<meta name="keywords" content="JTSDK,Jt-ware,wsjtx,jtdx,js8call,build wsjtx,compile wsjtx,Qt,Windows,software,development">
6+
<title>Hamlib SDK v3.2.3 Deployment Guide</title>
7+
<link rel="stylesheet" href="../style-new.css">
8+
<link rel="shortcut icon" type="image/x-icon" href="../favicon.ico" />
9+
</head>
10+
11+
<body>
12+
13+
<table width="100%" border="0">
14+
<tr>
15+
<td>
16+
<table width="*" border="0">
17+
<tr>
18+
<td>
19+
<img src="../favicon.ico" alt=""/>
20+
</td>
21+
<td>
22+
<h1>HAMLIB SDK</h1>
23+
<h2>Evolving the JT-ware Software Developer's Kit (JTSDK)</h2>
24+
</td>
25+
</tr>
26+
</table>
27+
</td>
28+
<td align="right" style="vertical-align: top" >
29+
<a href="ALLQT.html"><img src="../UGIcon.png" width="34" height="33" alt=""/></a>
30+
<a href="../index.html"><img src="../HomeIcon.png" width="34" height="33" alt=""/></a>
31+
</td>
32+
</tr>
33+
</table>
34+
35+
<hr>
36+
<! –– Ref: https://css-tricks.com/the-simplest-ways-to-handle-html-includes/ ––>
37+
<iframe src="navQt.html" onload="this.insertAdjacentHTML('afterend', (this.contentDocument.body||this.contentDocument).innerHTML);this.remove()"></iframe>
38+
<!--
39+
<table width="100%" border="0">
40+
<tr>
41+
<td width="16.7%" align="center"><a href="./qt/BDQT.html">Basic-Deploy</a></td>
42+
<td width="16.7%" align="center"><a href="./qt/UDQT.html">Update-Deploy</a></td>
43+
<td width="16.6%" align="center"><a href="./qt/ADQT.html">Archive-Deploy</a></td>
44+
<td width="16.7%" align="center"><a href="./qt/QUQT.html">Questions</a></td>
45+
<td width="16.6%" align="center"><a href="https://sourceforge.net/projects/hamlib-sdk/">Sourceforge</a></td>
46+
<td width="16.7%" align="center"><a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-Stream/">Download</a</td>
47+
</tr>
48+
</table>
49+
-->
50+
<hr/>
51+
<h2>Qt Deployment Guide</h2>
52+
<hr>
53+
54+
<h3>PowerShell Security Warnings</h3>
55+
<ul>
56+
<p>You may receive the following <strong>security notification</strong>:</p>
57+
</ul>
58+
<div class="reducewidth"> <pre>
59+
Execution Policy Change
60+
The execution policy helps protect you from scripts that you do not trust. Changing
61+
the execution policy might expose you to the security risks described in the
62+
about_Execution_Policies help topic at https:/go.microsoft.com/fwlink/?LinkID=135170.
63+
Do you want to change the execution policy?
64+
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"):
65+
</pre>
66+
</div>
67+
<ul>
68+
<ul>
69+
<li>It is safe to select <strong>Y</strong>.</li>
70+
</ul>
71+
<p>These scripts are not any processor flaw tests.</p>
72+
<p>Remember that developing these scripts is also a learning exercise for the Development Team.</p></p>
73+
</ul>
74+
<hr>
75+
<h2>Deployment</h2>
76+
<hr>
77+
78+
<h3>Under Development;</h3>
79+
<ul>
80+
<p>Resources are being Developed.</p>
81+
<p>*** Watch this space ***</p>
82+
83+
</ul>
84+
<hr>
85+
<h2>Conclusion and Further References</h2>
86+
<hr>
87+
<ul>
88+
<p>The aim of <strong>JTSDK64-Tools</strong> is to use an Agile delivery approach to create a
89+
high-quality, yet flexible build system. </p>
90+
<p>Base ref: <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-4.0-Stream/README.md">https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-4.0-Stream/README.md</a></p>
91+
</ul>
92+
<hr>
93+
<table width="100%" border="0">
94+
<tbody>
95+
<tr>
96+
<td>Editor: <a href="https://www.qrz.com/db/vk3vm">Steve VK3VM/VK3SIR</a></td>
97+
<td align="right"><a href="../hamlibdk [at] outlook.com"
98+
rel="nofollow"
99+
onclick="this.href='mailto:' + 'hamlibdk' + '@' + 'outlook.com'">Contact</a></td>
100+
</tr>
101+
</tbody>
102+
</table>
103+
</body>
104+
</html>

docs/Qt/BDQT.html

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
<!doctype html>
2+
<html>
3+
<head>
4+
<meta charset="utf-8">
5+
<meta name="keywords" content="JTSDK,Jt-ware,wsjtx,jtdx,js8call,build wsjtx,compile wsjtx,Qt,Windows,software,development">
6+
<title>Hamlib SDK v3.2.3 Deployment Guide</title>
7+
<link rel="stylesheet" href="../style-new.css">
8+
<link rel="shortcut icon" type="image/x-icon" href="../favicon.ico" />
9+
</head>
10+
11+
<body>
12+
13+
<table width="100%" border="0">
14+
<tr>
15+
<td>
16+
<table width="*" border="0">
17+
<tr>
18+
<td>
19+
<img src="../favicon.ico" alt=""/>
20+
</td>
21+
<td>
22+
<h1>HAMLIB SDK</h1>
23+
<h2>Evolving the JT-ware Software Developer's Kit (JTSDK)</h2>
24+
</td>
25+
</tr>
26+
</table>
27+
</td>
28+
<td align="right" style="vertical-align: top" >
29+
<a href="ALLQT.html"><img src="../UGIcon.png" width="34" height="33" alt=""/></a>
30+
<a href="../index.html"><img src="../HomeIcon.png" width="34" height="33" alt=""/></a>
31+
</td>
32+
</tr>
33+
</table>
34+
35+
<hr>
36+
<! –– Ref: https://css-tricks.com/the-simplest-ways-to-handle-html-includes/ ––>
37+
<iframe src="navQt.html" onload="this.insertAdjacentHTML('afterend', (this.contentDocument.body||this.contentDocument).innerHTML);this.remove()"></iframe>
38+
<!--
39+
<table width="100%" border="0">
40+
<tr>
41+
<td width="16.7%" align="center"><a href="./qt/BDQT.html">Basic-Deploy</a></td>
42+
<td width="16.7%" align="center"><a href="./qt/UDQT.html">Update-Deploy</a></td>
43+
<td width="16.6%" align="center"><a href="./qt/ADQT.html">Archive-Deploy</a></td>
44+
<td width="16.7%" align="center"><a href="./qt/QUQT.html">Questions</a></td>
45+
<td width="16.6%" align="center"><a href="https://sourceforge.net/projects/hamlib-sdk/">Sourceforge</a></td>
46+
<td width="16.7%" align="center"><a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-Stream/">Download</a</td>
47+
</tr>
48+
</table>
49+
-->
50+
<hr/>
51+
<h2>Qt Basic Deployment Guide</h2>
52+
<hr>
53+
54+
<h3>Qt Resources</h3>
55+
<ul>
56+
<p>Occasionally one comes aross base resources that are perhaps better than what we can supply,</p>
57+
<p><a href="https://doc.qt.io/qt-6/qt-online-installation.html">Please utilise this link for guidance on how to deploy Qt from Scratch</a>.
58+
</p>
59+
<p>This project is based around Open Source and Open Source Development. </p>
60+
<p>The installer for The Open Source Development Licensed version of Qt can be found at <a href="https://www.qt.io/download-open-source">https://www.qt.io/download-open-source</a> .
61+
</p>
62+
</ul>
63+
<hr>
64+
<table width="100%" border="0">
65+
<tbody>
66+
<tr>
67+
<td>Editor: <a href="https://www.qrz.com/db/vk3vm">Steve VK3VM/VK3SIR</a></td>
68+
<td align="right"><a href="../hamlibdk [at] outlook.com"
69+
rel="nofollow"
70+
onclick="this.href='mailto:' + 'hamlibdk' + '@' + 'outlook.com'">Contact</a></td>
71+
</tr>
72+
</tbody>
73+
</table>
74+
</body>
75+
</html>

0 commit comments

Comments
 (0)