Version 1.0.5

Author: fadden

AppCommon/GlobalAppVersion.cs

@@ -27,7 +27,7 @@ public static class GlobalAppVersion {
         /// Overall application version.
         /// </summary>
         public static readonly CommonUtil.Version AppVersion =
-            new CommonUtil.Version(1, 0, 5, CommonUtil.Version.PreRelType.Dev, 2);
+            new CommonUtil.Version(1, 0, 5, CommonUtil.Version.PreRelType.Final, 0);
         // NOTE: there's an independent version in DiskArc/Defs.cs
     }
 }

DiskArc/Defs.cs

@@ -27,7 +27,7 @@ public static class Defs {
         /// DiskArc library version number.
         /// </summary>
         public static CommonUtil.Version LibVersion { get; } =
-            new CommonUtil.Version(1, 0, 4, CommonUtil.Version.PreRelType.Final, 0);
+            new CommonUtil.Version(1, 0, 5, CommonUtil.Version.PreRelType.Final, 0);
 
         public const string BUILD_TYPE =
 #if DEBUG

Install.md

@@ -17,19 +17,19 @@ or use one of the links below to download the most recent stable release.
 
 System        | Link
 ------------- | ----
-Windows x86   | https://github.com/fadden/CiderPress2/releases/download/v1.0.4/cp2_1.0.4_win-x86_sc.zip
-Windows x64   | https://github.com/fadden/CiderPress2/releases/download/v1.0.4/cp2_1.0.4_win-x64_sc.zip
-Mac OS x64    | https://github.com/fadden/CiderPress2/releases/download/v1.0.4/cp2_1.0.4_osx-x64_sc.zip
-Linux x64     | https://github.com/fadden/CiderPress2/releases/download/v1.0.4/cp2_1.0.4_linux-x64_sc.zip
+Windows x86   | https://github.com/fadden/CiderPress2/releases/download/v1.0.5/cp2_1.0.5_win-x86_sc.zip
+Windows x64   | https://github.com/fadden/CiderPress2/releases/download/v1.0.5/cp2_1.0.5_win-x64_sc.zip
+Mac OS x64    | https://github.com/fadden/CiderPress2/releases/download/v1.0.5/cp2_1.0.5_osx-x64_sc.zip
+Linux x64     | https://github.com/fadden/CiderPress2/releases/download/v1.0.5/cp2_1.0.5_linux-x64_sc.zip
 
 **Framework-Dependent** (~1 MB)
 
 System        | Link
 ------------- | ----
-Windows x86   | https://github.com/fadden/CiderPress2/releases/download/v1.0.4/cp2_1.0.4_win-x86_fd.zip
-Windows x64   | https://github.com/fadden/CiderPress2/releases/download/v1.0.4/cp2_1.0.4_win-x64_fd.zip
-Mac OS x64    | https://github.com/fadden/CiderPress2/releases/download/v1.0.4/cp2_1.0.4_osx-x64_fd.zip
-Linux x64     | https://github.com/fadden/CiderPress2/releases/download/v1.0.4/cp2_1.0.4_linux-x64_fd.zip
+Windows x86   | https://github.com/fadden/CiderPress2/releases/download/v1.0.5/cp2_1.0.5_win-x86_fd.zip
+Windows x64   | https://github.com/fadden/CiderPress2/releases/download/v1.0.5/cp2_1.0.5_win-x64_fd.zip
+Mac OS x64    | https://github.com/fadden/CiderPress2/releases/download/v1.0.5/cp2_1.0.5_osx-x64_fd.zip
+Linux x64     | https://github.com/fadden/CiderPress2/releases/download/v1.0.5/cp2_1.0.5_linux-x64_fd.zip
 
 Once downloaded, unzip the file somewhere convenient (Safari on the Mac will do the unzip
 for you).  There is no installer; the commands are executed directly from where they are unzipped.
@@ -109,13 +109,11 @@ on whether your target is 32-bit or 64-bit, respectively).  You can then run the
     #!/bin/sh
     exec PATH/TO/dotnet PATH/TO/cp2.dll $@
 
-### Linux and Wine ###
+### Using the GUI on Linux and macOS ###
 
-It's possible to run the GUI application under Linux using the Wine compatibility layer.
-With Wine v9 the application works somewhat, but crashes in some common operations.
+It's possible to run the GUI application under macOS and Linux using the Wine compatibility layer.
+See [this discussion](https://github.com/fadden/CiderPress2/discussions/34) for an example with
+macOS.  The key seems to be using the self-contained 32-bit (x86) release of CiderPress II
+(`win-x86_sc` package).
 
-If you want to try it, download the 32-bit (x86) self-contained package for Windows.  On my
-system, the 64-bit version hangs during startup (for both GUI and CLI), and the framework-dependent
-package requires downloading additional Wine components, so `win-x86_sc` is your best bet.
-
-(I am not a Wine expert.  It's possible I'm missing something obvious.)
+This is not officially supported and may be unstable.

LegalStuff.txt

@@ -1,4 +1,4 @@
-CiderPress II is copyright 2023 faddenSoft.  Source and binaries may be
+CiderPress II is copyright faddenSoft.  Source and binaries may be
 distributed under terms of the Apache 2.0 license (attached below, and
 in the LICENSE file included with the source code).
 

SourceNotes.md

@@ -159,20 +159,22 @@ always match the current "final" release.
 
  6. Update the `app_version` number in `ndocs/publish.py`.  This is used
     for text substitution in the descriptive text and installer links.
- 7. From the command line, in the `ndocs` directory, run `publish.py`
+ 7. If file format docs have changed, use the `ndocs/formatdoc/convert.py`
+    script (see below).
+ 8. From the command line, in the `ndocs` directory, run `publish.py`
     (you may need to explicitly run python if the shell isn't set up to
     execute scripts directly).  This will update the contents of the `docs`
     directory and the top-level documentation (including this file) with the
     contents of `ndocs`.  Check the diffs.
 
 Finally, build the applications and submit the changes.
 
- 8. Run `makedist build` from the top level of the source tree (it'll be in
+ 9. Run `makedist build` from the top level of the source tree (it'll be in
     `MakeDist/bin/debug/NET6.0`).  This builds the distribution packages.
     The output will be in the `DIST` directory.
- 9. Submit all changes to git, push them to the server.
- 10. Create a new release on github.  Drag `DIST/*.zip` into the release.
- 11. Update/close any issues that have been addressed by the new release.
+ 10. Submit all changes to git, push them to the server.
+ 11. Create a new release on github.  Drag `DIST/*.zip` into the release.
+ 12. Update/close any issues that have been addressed by the new release.
 
 Version numbers should follow the semantic versioning scheme: v1.2.3,
 v1.2.3-dev1, etc.

docs/README.md

@@ -28,7 +28,7 @@ handful of top-level documents (like the project README and installation
 instructions) are copied out of the `top` directory.
 
 Some text variable substitutions can be performed on HTML and Markdown files
-as they are copied, e.g. all occurrences of `1.0.4` will be replaced with
+as they are copied, e.g. all occurrences of `1.0.5` will be replaced with
 the current app version.  This is used to update the links in the download
 instructions (`Install.md`) to point at the current release.
 

docs/doc-index.html

@@ -102,6 +102,8 @@ <h3>File Archives</h3>
       AppleLink-PE Package Format (.acu)</a></li>
   <li><a href="formatdoc/AppleSingle-notes.html">
       AppleSingle (.as) and AppleDouble (._*)</a></li>
+  <li><a href="formatdoc/AudioRecording-notes.html">
+      Apple II cassette recording (*.wav)</a></li>
   <li><a href="formatdoc/Binary2-notes.html">
       Binary ][ (.bny .bqy)</a></li>
   <li><a href="formatdoc/GZip-notes.html">

docs/features.html

@@ -88,6 +88,7 @@ <h4>File Archives</h4>
     <tr> <td>AppleLink PE</td> <td>.acu</td> <td>read</td> </tr>
     <tr> <td>AppleDouble</td> <td>("<code>._</code>" prefix pair)</td> <td>read/add/extract</td> </tr>
     <tr> <td>AppleSingle</td> <td>.as</td> <td>read/add/extract</td> </tr>
+    <tr> <td>Apple II cassette</td> <td>.wav</td> <td>read</td> </tr>
     <tr> <td>Binary II</td> <td>.bny .bqy</td> <td>full</td> </tr>
     <tr> <td>gzip</td> <td>.gz</td> <td>read/add/extract</td> </tr>
     <tr> <td>MacBinary</td> <td>.bin .macbin</td> <td>read</td> </tr>