Merge pull request #2 from bxparks/develop

merge v0.2 into master

Author: bxparks

CHANGELOG.md

@@ -1,6 +1,8 @@
 # Changelog
 
 - Unreleased
+- 0.2 (2023-08-13)
+    - Update downloading and installation instructions.
 - 0.1 (2023-08-13)
     - Create a release, with the `.8xk` so that I can see what a GitHub release
       asset looks like, which allows me to write a better Installation guide.

README.md

@@ -2,7 +2,7 @@
 
 RPN calculator app for the TI-83 Plus and TI-84 Plus inspired by the HP-42S.
 
-**Version**: 0.1 (2023-08-13)
+**Version**: 0.2 (2023-08-13)
 
 **Changelog**: [CHANGELOG.md](CHANGELOG.md)
 
@@ -25,12 +25,14 @@ RPN calculator app for the TI-83 Plus and TI-84 Plus inspired by the HP-42S.
 <a name="Installation"></a>
 ## Installation
 
-RPN83P is a flash application (it no longer small enough to create as an
-assembly language program). Detailed instructions are given in the [RPN83P User
+RPN83P is a flash application that is packaged as a single file named
+`rpn83p.8xk`. Detailed instructions are given in the [RPN83P User
 Guide](USER_GUIDE.md), but here is the quick version:
 
-- Copy the `rpn83p.8xk` file to the TI-83/TI-84 calculator. Use one of following
-  link programs:
+- Download the `rpn83p.8xk` file from the
+  [releases page](https://github.com/bxparks/rpn83p/releases).
+- Upload the file to the TI-83 Plus or TI-84 Plus calculator. Use one of
+  following link programs:
     - Windows: [TI Connect](https://education.ti.com/en/products/computer-software/ti-connect-sw)
     - Linux: [tilp](https://github.com/debrouxl/tilp_and_gfm)
 - Run the program using the `APPS`:

USER_GUIDE.md

@@ -2,7 +2,7 @@
 
 RPN calculator app for the TI-83 Plus and TI-84 Plus inspired by the HP-42S.
 
-**Version**: 0.1 (2023-08-13)
+**Version**: 0.2 (2023-08-13)
 
 **Project Home**: https://github.com/bxparks/rpn83p
 
@@ -192,12 +192,23 @@ project.
 <a name="Installation"></a>
 ## Installation
 
+<a name="ObtainingProgramFile"></a>
+### Obtaining the Program File
+
+The RPN83P app is packaged as a single file named `rpn83p.8xk`. There are at
+least 2 ways to obtain this:
+
+- [RPN83P release page on GitHub](https://github.com/bxparks/rpn83p/releases)
+    - go to the latest release
+    - click and download the `rpn83p.8xk` file
+- Compile the binary locally
+    - See [Compiling from Source](#Compiling) section below
+
 <a name="Uploading"></a>
 ### Uploading
 
-The RPN83P app is provided as a single file named `rpn83p.8xk`. It must be
-uploaded to the calculator using a "link" program from a host computer. There
-are a number of options:
+The `rpn83p.8xk` file must be uploaded to the calculator using a "link" program
+from a host computer. There are a number of options:
 
 **Linux**: Use the [tilp](https://github.com/debrouxl/tilp_and_gfm) program. On
 Ubuntu Linux 22.04 systems, the precompiled package can be installed using `$
@@ -232,7 +243,8 @@ should see a screen that looks like:
 The RPN83P application can be quit using:
 
 - `2ND` `QUIT`: to exit to normal TI calculator
-- `2ND` `OFF`: to turn the calculator off (the RPN registers will be preserved)
+- `2ND` `OFF`: to turn the calculator off (the RPN registers and storage
+  registers will be preserved)
 
 <a name="BasicUsage"></a>
 ## Basic Usage

src/menuhandlers.asm

@@ -127,7 +127,7 @@ helpPages:
 
 msgHelpPage1:
     .db escapeLargeFont, "RPN83P", Lenter
-    .db escapeSmallFont, "v0.0 (2023", Shyphen, "08", Shyphen, "13)", Senter
+    .db escapeSmallFont, "v0.2 (2023", Shyphen, "08", Shyphen, "13)", Senter
     .db "(c) 2023  Brian T. Park", Senter
     .db Senter
     .db "An RPN calculator for the", Senter