Skip to content

Commit 4f6d889

Browse files
committed
Post 3.4.0 - Doc Updates for Qt 5.15.2 now coming from Archive
1 parent 51f0043 commit 4f6d889

12 files changed

Lines changed: 273 additions & 152 deletions

File tree

README.md

Lines changed: 158 additions & 94 deletions
Large diffs are not rendered by default.

docs/nav.html

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
<table width="100%" border="0">
2+
<tr>
3+
<td width="12.5%" align="center"><a href="./ver3/index3.html">Version 3 Documentation</a></td>
4+
<td width="12.5%" align="center"><a href="./ver4/index4.html">Version 4 Documenatation</a></td>
5+
<td width="12.5%" align="center"><a href="https://groups.io/g/JTSDK">JTSDK Forum</a></td>
6+
<td width="12.5%" align="center"><a href="https://sourceforge.net/projects/hamlib-sdk/">Sourceforge</a></td>
7+
<td width="20%" align="center"><a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-Stream/">Download</a</td>
8+
</tr>
9+
</table>
10+
<hr/>

docs/nav.js

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
// JavaScript Document
2+
// Ref: https://stackoverflow.com/questions/31954089/how-can-i-reuse-a-navigation-bar-on-multiple-pages
3+
fetch("nav.html")
4+
.then(res => res.text())
5+
.then(text => {
6+
let oldelem = document.querySelector("script#replace_with_navbar");
7+
let newelem = document.createElement("div");
8+
newelem.innerHTML = text;
9+
oldelem.parentNode.replaceChild(newelem,oldelem);
10+
})

docs/ver3/AN3.html

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -186,9 +186,9 @@ <h3>CPACK Packaging Issues - Not Finding DLL's</h3>
186186
<ul>
187187
<p><strong>$env:Path += "</strong>;C:\Windows\SysWOW64\downlevel;C:\JTSDK64-Tools\tools\hamlib\qt\5.15.2\bin<strong>"</strong></p>
188188
</ul>
189-
<li>If you are using <strong>Qt 6.6.1</strong> (experimental only - Will not build JT-ware yet):</li>
189+
<li>If you are using <strong>Qt 6.6.2</strong> (experimental only - Will not build JT-ware yet):</li>
190190
<ul>
191-
<p><strong>$env:Path += "</strong>;C:\Windows\SysWOW64\downlevel;C:\JTSDK64-Tools\tools\hamlib\qt\6.6.1\bin<strong>"</strong></p>
191+
<p><strong>$env:Path += "</strong>;C:\Windows\SysWOW64\downlevel;C:\JTSDK64-Tools\tools\hamlib\qt\6.6.2\bin<strong>"</strong></p>
192192
</ul>
193193
</ul>
194194
<p>These paths could also be added to the main Windows system paths.</p>
@@ -202,10 +202,10 @@ <h3>CPACK Packaging Issues - Not Finding DLL's</h3>
202202
<strong>C:\Windows\SysWOW64\downlevel;C:\JTSDK64-Tools\tools\hamlib\qt\5.15.2\bin</strong>
203203
</ul>
204204
<br/>
205-
<li>For <strong>Qt 6.6.1</strong> (Developmental):</li>
205+
<li>For <strong>Qt 6.6.2</strong> (Developmental):</li>
206206
<br/>
207207
<ul>
208-
<strong>C:\Windows\SysWOW64\downlevel;C:\JTSDK64-Tools\tools\hamlib\qt\6.6.1\bin</strong>
208+
<strong>C:\Windows\SysWOW64\downlevel;C:\JTSDK64-Tools\tools\hamlib\qt\6.6.2\bin</strong>
209209
</ul>
210210
</ul>
211211
<br/>

docs/ver3/DG3.html

Lines changed: 29 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -229,9 +229,9 @@ <h4>Deployment</h4>
229229
</div>
230230
<ul>
231231
<p>The script for Qt deployment presents a number of options. &#39;D&#39; or &#39;Y&#39; Selects a scripted &quot;Default&quot;
232-
deployment being Qt 5.15.2 as the base. &#39;F&#39; Deploys Qt 5.15.2 and 6.6.1&nbsp; Qt 5.15.2 (default) is the recommended version for JT-ware development. </p>
232+
deployment being <strong>Qt 5.15.2</strong> as the base (see note below). &#39;F&#39; Deploys <strong>Qt 5.15.2</strong> and <strong>6.6.2</strong>&nbsp; <strong>Qt 5.15.2</strong> is the recommended version for JT-ware development.</p>
233233
<ul>
234-
<li>Select &#39;Y&#39;/&#39;D&#39; or &#39;F&#39; (note:&#39;Y&#39; or &#39;D&#39; is recommended).</li>
234+
<li>Select &#39;Y&#39;/&#39;D&#39; or &#39;F&#39; (note:&#39;F&#39; is now recommended as <strong>Qt 5.15.2</strong> can only be obtained from "Archive" - which cannot be easily scripted. It must be deployed manually from the Maintenance Tool now. See later notes).</li>
235235
</ul>
236236
</ul>
237237
<div class="reducewidth">
@@ -293,12 +293,13 @@ <h4>Deployment</h4>
293293
</tr>
294294
</table>
295295
<ul>
296-
<p>Refer any installation issues issues to the <a href="https://groups.io/g/JTSDK">JTSDK Forum</a.</p>
296+
<p>Refer any installation issues issues to the <a href="https://groups.io/g/JTSDK">JTSDK Forum</a></p>
297297
</ul>
298298
<h4>Step 2a: Prepare the MSYS2 Environment</h4>
299299
<ul>
300300
<p>A MSYS2 environment window will open as part of the <strong>postinstall</strong> process. </p>
301301
</ul>
302+
</u>
302303
<div class="reducewidth">
303304
<pre>
304305
JTSDK64 Tools MSYS2 (MSYS)
@@ -394,24 +395,41 @@ <h3>Step 3: Set Up The Main Tools Environment</h3>
394395
</ul>
395396

396397
<h4>Step 3a: Upgrade your Qt Deployment</h4>
398+
<ul>
399+
<p>As of March 2024 it has been observed that <strong>Qt 5.15.2</strong> is no longer available from "Mainstream" installer sources</p>
400+
<table width="*" align="center" border="1">
401+
<tr>
402+
<td class="custd"><strong>Qt 5.15.2 is still available from "Archive" ast the time of writing. This means that Qt must be deployed manually from "Archive" Repositories</strong></td>
403+
</tr>
404+
</table>
405+
<p>Earlier wit was recommended that one performs a "Full" deployment of Qt at install time.&nbsp;</p>
406+
<p>This should properly deploy <strong>Qt 6.6.2</strong> along with the <strong>Qt Maintenance Tool</strong>.&nbsp;</p>
407+
<p>Once the JTSDK is deployed you can then add <strong>Qt 5.15.2</strong> MANUALLY from Archive.&nbsp;</p>
408+
<table width="*" align="center" border="1">
409+
<tr>
410+
<td class="custd"><strong>See the guide <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> for latest instructions</strong></td>
411+
</tr>
412+
</table>
413+
</ul>
414+
397415
<ul>
398-
<p>A Minimum Qt installation pegs at <a href="https://www.qt.io/download-open-source">Qt</a> at version 5.15.2. If you did not use
416+
<p>A Minimum Qt installation pegs at <a href="https://www.qt.io/download-open-source">Qt</a> at version <strong>5.15.2</strong>. If you did not use
399417
the &quot;F&quot; Full option for <a href="https://www.qt.io/download-open-source">Qt</a> deployment or you
400-
want to update Qt to an experimental version such as 6.6.1 version you should do so now.
401-
Note that using Qt 5.15.2 is the only Qt version that JT-ware source supports at this time.</p>
418+
want to update Qt to an experimental version you should do so now.
419+
Note that using Qt <strong>5.15.2</strong> is the only Qt version that JT-ware source supports at this time.</p>
402420
<p>Perform the following steps:</p>
403421
<ul>
404422
<li>Navigate to the Qt Deployment directory</li>
405423

406424
<li>Run the <strong>Qt Maintenance Tool</strong> from your Qt deployment directory (i.e. <strong>C:\JTASK64-Tools\tools\Qt</strong>)</li>
407425
</ul>
408-
<p>To add Qt 6.6.1:</p>
426+
<p>To add <strong>Qt 6.6.2</strong> (as an example):</p>
409427
<ul>
410-
<li>Add Qt 6.6.1 MinGW. [ Note that the packages may be named 'mingw900' but it is really MinGW 11.2 ]</li>
428+
<li>Add <strong>Qt 6.6.2</strong> MinGW. [ Note that the packages may be named 'mingw900' but it is really MinGW 11.2 or later ]</li>
411429

412-
<li>Ensure that components Qt 6.6.1/MinGW 11.x 64 bit and Qt 6.6.1 Qt5 Compatability Module are added.</li>
430+
<li>Ensure that components <strong>Qt 6.6.2</strong>/<strong>MinGW 11.x 64 bit</strong> and <strong>Qt 6.6.2 Qt5 Compatability Module</strong> are added.</li>
413431

414-
<li>Select Qt 6.6.1/All Additional Libraries .</li>
432+
<li>Select <strong>Qt 6.6.2</strong>/All Additional Libraries .</li>
415433

416434
<li>Add Developer and Designer Tools / MinGW 11.2.0 64-bit</li>
417435

@@ -423,7 +441,7 @@ <h4>Step 3a: Upgrade your Qt Deployment</h4>
423441
<li>Adjust the maker file in <strong>x:\JTSDK64-Tools\config</strong> marker file to match the Qt version that you want to use </li>
424442

425443
<ul>
426-
<li>i.e. rename <strong>qt5.15.2</strong> to <strong>qt6.6.1</strong></li>
444+
<li>i.e. rename <strong>qt5.15.2</strong> to <strong>qt6.6.2</strong></li>
427445
</ul>
428446
</ul>
429447
</ul>

docs/ver3/QU3.html

Lines changed: 29 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -109,13 +109,13 @@ <h3>How do I update the JTSDK?</h3>
109109
are designed to be deployed to existing &quot;Base&quot; packages.</p>
110110
</ul>
111111

112-
<h4>Where do I get and how do I apply 'Update' packages?</h4>
112+
<h4>Where do I get and how do I apply 'Update'/'Patch'&nbsp; packages?</h4>
113113

114114
<ul>
115-
<p><strong></strong>Update packages can be downloaded from <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.4-Stream/">https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.4-Stream/</a> .</p>
115+
<p><strong></strong>Update/Patch&nbsp; packages can be downloaded from <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.4-Stream/">https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.4-Stream/</a> .</p>
116116
<p><em>These steps assume that you have a deployed base environment</em></p>
117117
<ul>
118-
<li>Download any Update packages if they exist ( i.e. packages with a "U" in the filename) from <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.4-Stream/">https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.4-Stream/</a>. </li>
118+
<li>Download any Update/Patch packages if they exist ( i.e. packages with a "U" in the filename) from <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.4-Stream/">https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.4-Stream/</a>. </li>
119119
</ul>
120120
<p><strong>Note:</strong> There are no current update packages .</p>
121121
<ul>
@@ -249,9 +249,26 @@ <h3>Wrong Qt deployment settings</h3>
249249
</table>
250250

251251
<p>The marker file to set the version of Qt used is found in <strong>x:\JTSDK64-Tools\config</strong> i.e. <strong>qt5.15.2</strong> (as default).</p>
252-
<p>Rename that file as appropriate to match the version of Qt that is deployed or that you want to use i.e. from <strong>qt5.15.2</strong> to <strong>qt6.6.1&nbsp; </strong>.&nbsp;</p>
252+
<p>Rename that file as appropriate to match the version of Qt that is deployed or that you want to use i.e. from <strong>qt5.15.2</strong> to <strong>qt6.6.2&nbsp; </strong>.&nbsp;</p>
253253
</ul>
254-
<h3>Issues observed when trying to build software with Qt 6.6.1 deployments</h3>
254+
<h3>Qt 5.15.2 Not Being Deployed</h3>
255+
<ul>
256+
<p>As of March 2024 it has been observed that Qt 5.15.2 is no longer available from "Mainstream" installer sources</p>
257+
<table width="*" align="center" border="1">
258+
<tr>
259+
<td class="custd"><strong>Qt 5.15.2 is still available from "Archive" ast the time of writing. This means that Qt must be deployed manually from "Archive" Repositories</strong></td>
260+
</tr>
261+
</table>
262+
<p>It is now recommended that one performs a "Full" deployment of Qt at install time.&nbsp;</p>
263+
<p>This should properly deploy <strong>Qt 6.6.2</strong> along with the <strong>Qt Maintenance Tool</strong>.&nbsp;</p>
264+
<p>Once the JTSDK is deployed you can then add Qt 5.15.2 MANUALLY from Archive.&nbsp;</p>
265+
<table width="*" align="center" border="1">
266+
<tr>
267+
<td class="custd"><strong>See the guide <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> for latest instructions</strong></td>
268+
</tr>
269+
</table>
270+
</ul>
271+
<h3>Issues observed when trying to build software with Qt 6.6.2 deployments</h3>
255272
<ul>
256273
<p><strong>Qt 6</strong> is not currently supported by the JT-ware developers. Current source code of all known JT-ware forks at the time that this document was written will not compile under <strong>Qt 6</strong>.</p>
257274
<p>JT-ware developers are researching Qt 6-compatible code conversion.&nbsp;</p>
@@ -261,11 +278,11 @@ <h3>Issues observed when trying to perform a Full Deployment: Qt 5 and/or Qt 6
261278
<p><strong>JTSDK 2.3.2</strong> with <strong>Tools 3.2.3.3</strong> Has the capability to deploy two "streams" of Qt kit:</p>
262279
<ul>
263280
<li><strong> Default Deployment</strong>: deploys <strong>Qt Version 5.15.2</strong>. This is not likely to change - but at some stage it may be withdrawn from release by the Qt maintainers. When this occurs our kit will not be able to find these files; it will not install.</li>
264-
<li><strong>Full Deployment</strong>: deploys <strong>both Qt versions 5.15.2 and Qt 6.6.1</strong> at the time that this document was written. If one or either of these versions cannot be found then these kits will not be installed.</li>
281+
<li><strong>Full Deployment</strong>: deploys <strong>both Qt versions 5.15.2 and Qt 6.6.2</strong> at the time that this document was written. If one or either of these versions cannot be found then these kits will not be installed.</li>
265282
</ul>
266283
<p>This kit by default deploys the <a href="https://www.qt.io/download-open-source">Qt SDK For Open Source Release</a>. This is also compliant with the basic beliefs, method and release licensing terms for WSJTX.</p>
267284
<p>These Qt deployment repositories are stored in <a href="https://download.qt.io/static/mirrorlist/">geo-assigned download repositories</a>. Each repository ONLY MAKES THE LATEST DOWNLOAD RELEASE STREAMS AVAILABLE to the Qt installer.</p>
268-
<p>The Qt maintainers may at some stage in the future bump the versions available i.e. From <strong>6.6.1</strong> to&nbsp; <strong>6.6.2</strong> (as an example).&nbsp;</p>
285+
<p>The Qt maintainers may at some stage in the future bump the versions available i.e. From <strong>6.6.2</strong> to&nbsp; <strong>6.6.2</strong> (as an example).&nbsp;</p>
269286
<p><strong><u>Our kit has a way of dealing with this:</u></strong></p>
270287
<p>Refer to the file <strong>x:\JTSDK64-Tools\config\Versions.ini</strong>&nbsp;</p>
271288
<p>There are two keys that (at the time of writing) can br found at the bottom of the file:</p>
@@ -275,7 +292,7 @@ <h3>Issues observed when trying to perform a Full Deployment: Qt 5 and/or Qt 6
275292
...
276293
#future enhancement to set Qt version
277294
qt5v=5.15.2
278-
qt6v=6.6.1
295+
qt6v=6.6.2
279296
</pre>
280297
</div>
281298
<ul>
@@ -376,9 +393,9 @@ <h3>Minor packaging issue observed when building JTDX</h3>
376393
<ul>
377394
<p><strong>$env:Path += "</strong>;C:\Windows\SysWOW64\downlevel;C:\JTSDK64-Tools\tools\hamlib\qt\5.15.2\bin<strong>"</strong></p>
378395
</ul>
379-
<li>If you are using <strong>Qt 6.6.1</strong>:&nbsp;</li>
396+
<li>If you are using <strong>Qt 6.6.2</strong>:&nbsp;</li>
380397
<ul>
381-
<p><strong>$env:Path += "</strong>;C:\Windows\SysWOW64\downlevel;C:\JTSDK64-Tools\tools\hamlib\qt\6.6.1\bin<strong>"</strong></p>
398+
<p><strong>$env:Path += "</strong>;C:\Windows\SysWOW64\downlevel;C:\JTSDK64-Tools\tools\hamlib\qt\6.6.2\bin<strong>"</strong></p>
382399
</ul>
383400
</ul>
384401
<p>These paths can be added to the main Windows system paths.</p>
@@ -391,9 +408,9 @@ <h3>Minor packaging issue observed when building JTDX</h3>
391408
<br/>
392409
<strong>C:\Windows\SysWOW64\downlevel;C:\JTSDK64-Tools\tools\hamlib\qt\5.15.2\bin</strong>
393410
<br/><br/>
394-
<li>For <strong>Qt 6.6.1</strong>:</li>
411+
<li>For <strong>Qt 6.6.2</strong>:</li>
395412
<br/>
396-
<strong>C:\Windows\SysWOW64\downlevel;C:\JTSDK64-Tools\tools\hamlib\qt\6.6.1\bin</strong>
413+
<strong>C:\Windows\SysWOW64\downlevel;C:\JTSDK64-Tools\tools\hamlib\qt\6.6.2\bin</strong>
397414
</ul>
398415
<br/>
399416
<li>Restart the build proess i.e. <strong>jtbuild package</strong></li>

docs/ver3/UG3.html

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -389,7 +389,7 @@ <h4>Mainstream Deployment</h4>
389389
</div>
390390
<ul>
391391
<p>Qt Presents a number of options. &#39;D&#39; or &#39;Y&#39; Selects a scripted &quot;Default&quot;
392-
deployment being Qt 5.15.2 as the base. &#39;F&#39; Deploys Qt 5.15.2 and 6.6.1.
392+
deployment being Qt 5.15.2 as the base. &#39;F&#39; Deploys Qt 5.15.2 and 6.6.2.
393393
Qt 5.15.2 (default) is the recommended version for Jt-ware development. </p>
394394
<ul>
395395
<li>Select &#39;Y&#39;/&#39;D&#39; or &#39;F&#39; <strong>Note:</strong> &#39;Y&#39; or &#39;D&#39; is recommended for an initial installation. Add other Qt versions later.</li>
@@ -535,21 +535,21 @@ <h4>Step 3a: (Recommended) Upgrade your Qt Deployment</h4>
535535
<ul>
536536
<p>A Minimum Qt installation pegs at <a href="https://www.qt.io/download-open-source">Qt</a> at version 5.15.2. If you did not use
537537
the &quot;F&quot; Full option for <a href="https://www.qt.io/download-open-source">Qt</a> deployment or you
538-
want to update Qt to an experimental version such as Qt 6.6.1 version you should do so now.
538+
want to update Qt to an experimental version such as Qt 6.6.2 version you should do so now.
539539
Note that using Qt 5.15.2 is the only Qt version that JT-ware source supports at this time.</p>
540540
<p>Perform the following steps:</p>
541541
<ul>
542542
<li>Navigate to the Qt Deployment directory</li>
543543

544544
<li>Run the <strong>Qt Maintenance Tool</strong> from your Qt deployment directory (i.e. <strong>C:\JTASK64-Tools\tools\Qt</strong>)</li>
545545
</ul>
546-
<p>To add Qt 6.6.1:</p>
546+
<p>To add Qt 6.6.2:</p>
547547
<ul>
548-
<li>Add Qt 6.6.1 MinGW.</li>
548+
<li>Add Qt 6.6.2 MinGW.</li>
549549

550-
<li>Ensure that components Qt 6.6.1/MinGW 11.x 64 bit and Qt 6.6.1/Qt5 Compatability Module are added.</li>
550+
<li>Ensure that components Qt 6.6.2/MinGW 11.x 64 bit and Qt 6.6.2/Qt5 Compatability Module are added.</li>
551551

552-
<li>Select Qt 6.6.1/All Additional Libraries .</li>
552+
<li>Select Qt 6.6.2/All Additional Libraries .</li>
553553

554554
<li>Add Developer and Designer Tools / MinGW 11.x 64-bit</li>
555555

@@ -561,7 +561,7 @@ <h4>Step 3a: (Recommended) Upgrade your Qt Deployment</h4>
561561
<li>Adjust the maker file in <strong>x:\JTSDK64-Tools\config</strong> marker file to match the Qt version that you want to use </li>
562562

563563
<ul>
564-
<li>i.e. rename <strong>qt5.15.2</strong> to <strong>qt6.6.1</strong></li>
564+
<li>i.e. rename <strong>qt5.15.2</strong> to <strong>qt6.6.2</strong></li>
565565
</ul>
566566
</ul>
567567
</ul>

0 commit comments

Comments
 (0)