first pass at README update

This is the version bgrier put in issue bgri#34.

README.md

@@ -3,16 +3,59 @@ m100le - Wordle for the Tandy TRS-80 Model 100
 A version of Wordle created for a fourty-year-old computer, the Tandy TRS-80 Model 100.
 ![m100le](https://user-images.githubusercontent.com/14062627/157380662-b14b5225-cd50-479e-8fc5-f1fa1faf0162.png)
 
+--
+## Updates v0.m
+### A note about this update
+Though the look of the game hasn't changed much, a lot has gone on behind the scenes, thanks to the amazing work by [hackerb9](https://github.com/hackerb9):
+
+- Hardware agnostic - runs on any m100 platform
+- Speed increase - due to the following...
+- Compressed binary word list files - smaller size and discourages peeking :)
+- Commented and uncommented code files
+- VT52 character positioning vs Tandy/NEC-specific routines
+- Harmonized date and manual date entry - play tomorrow's game today!
+- Synchronized with the 'official' NYT Wordle list
+- Data cleanup, code cleanup, and other optimizations
+
+Whew, lots there -- and more detail on a few things below!
+
+--bgrier Oct. 8, 2022
+
+--
+
+### Hardware agnostic
+**m100le** should be able to run m100le on ANY Kyocera-based computer (Kyocera KY-85, NEC PC-8201a, NEC PC-8201, NEC PC-8300, NEC PC-8400\*, Olivetti M10\*, Tandy Model-100, Tandy Model-102, Tandy Model-200). 
+
+### Code versions
+Four versions of code now in repository
+
+Filename|Size|Meaning
+---|---:|---
+M100LE+comments.DO | 16KB | The actual source code, including all comments, in ASCII format
+M100LE+comments.BA  | 14KB | Tokenized Tandy BASIC format, including all comments 
+M100LE.DO | 8.5KB | All comments removed, in ASCII format
+M100LE.BA | 6.6KB | All comments removed, in tokenized Tandy BASIC format
+
+### Date
+You can now enable the ability to manually enter the date or accept the system date. You could use this to replay a specific game or enter today's date on a vintage system that doesn't understand dates beyond 1999. `LINE 16 MD=1` will enable. When run, the system will prompt you for the date **` YY/MM/DD `** OR you could enter the ordinal 'Day-of-year' ex. `200` for the 200th day of the loaded year.
+
+The date must be typed exactly in **` YY/MM/DD `** format.
+
+### Word list files
+Word list files are now compressed binary files. The system looks at the date (see above) to load the appropriate .CO word list file, based on year. As before, this file must be in RAM along with `m100le.ba`
+
+--
 ## Documentation
 **m100le** is an implementation of [WORDLE](https://en.wikipedia.org/wiki/Wordle) for the Tandy TRS-80 Model 100 family of computers. It is written in the unit's on-board BASIC, a subset of [Microsoft BASIC](https://en.wikipedia.org/wiki/Microsoft_BASIC) included with the device.
 
 As far as possible, we have attempted to remain faithful to the original game and gameplay. 
 
 WORDLE'S instructions are very simple:
-- Guess the WORDLE in 6 tries.
-- Every day you get a new WORDLE.
-- Each guess must be a valid 5 letter word. Hit the enter button to submit.
-- After each guess, the colour of the tiles will change to show how close your guess was to the word.
+
+* Guess the WORDLE in 6 tries.
+* Every day you get a new WORDLE.
+* Each guess must be a valid 5 letter word. Hit the enter button to submit.
+* After each guess, the colour of the tiles will change to show how close your guess was to the word.
 
 ![image](https://user-images.githubusercontent.com/14062627/159618578-ef980bb7-de0f-47d1-a496-b3f191d9700f.png)
 
@@ -26,7 +69,7 @@ WORDLE initially checks the date and loads today's word from the wordlist. When
 
 Implementing the WORDLE method, would require the Model 100 to have the entire wordlist in memory to check for valid words. The Wordle wordlist is about 17k bytes (spanning six years of words);  just over half of the maximum memory of a Tandy Model 100. 
 
-Rather than impose this burden, **m100le** reads the **current year's** wordfile for the appropriate word based on today's **Date$**. Currently, **m100le** is using the 2022 version of the wordfile 'WL2022.DO'.
+Rather than impose this burden, **m100le** reads the **current year's** wordfile for the appropriate word based on today's **Date$**. Currently, **m100le** is using the 2022 version of the wordfile 'WL2022.CO'. If you've enabled the Date Entry function, then the program will attempt to load whatever wordlist file that corresponds to the year entered.
 
 
 
@@ -51,15 +94,20 @@ If your m100 doesn't have a ROM that has a Y2K patch (or some other method to br
 
 So in line 16, change the value of MD from Zero to One if you want to be prompted for the date.
 ```
-16 AD$=DATE$:MD=0: 'DEFINE DATE$ AND MANUAL DATE FLAG
+16 MD=0: 'DEFINE DATE$ AND MANUAL DATE FLAG
 ```
 
+This will allow you to play a game from any date from any word file loaded into your unit's memory. When enabled and run, the system will prompt you for the date **` YY/MM/DD `** OR you could enter the ordinal 'Day-of-year' ex. `200` for the 200th day of the loaded year.
+
+The date must be typed exactly in **` YY/MM/DD `** format.
+
 ### End of game
 When either a word is guessed correctly, or no correct word is guessed after six attempts, the game ends and you have a few options:
+
 - [A]GAIN? - Restarts today's game
 - [R]ANDOM? - Starts a new game with the word chosen randomly from this year's wordlist
 - [S]OCIAL? - Display your game's progress in a way suitable for sharing on social networks (Take a photo of the display)
-- [Q]UIT? - End the program execution and return to the main menu. 
+- [Q]UIT? - End the program execution and return to the main system menu. 
 
 ### Gameplay
 ![image](https://user-images.githubusercontent.com/14062627/159623862-c2d431f8-f88a-48b0-ac1d-45fa83ce3df9.png)
@@ -69,36 +117,32 @@ Daily, a five-letter word is selected and players have six tries to guess it. Ea
 
 1. Download the most recent .zip file from the [RELEASES section](https://github.com/bgri/m100LE/releases).
 2. Extract and copy 'M100LE.DO' to your Model 100.
-3. Extract and copy 'WL20XX.DO' to your Model 100 replacing XX with the current year. For 2022 you want WL2022.DO.
+3. Extract and copy 'WL20XX.CO' to your Model 100 replacing XX with the current year. For 2022 you want WL2022.CO.
 4. Enter BASIC on the Model 100, and type:
-```LOAD "M100LE.DO"```
-
+`LOAD "M100LE.DO"`
 5. Then save the file as a .BA file:
-```SAVE "M100LE.BA"```
-
+`SAVE "M100LE.BA"`
 6. Delete the now-unnecessary .DO file to free up RAM:
-```KILL "M100LE.DO"```
+`KILL "M100LE.DO"`
 
 
 ## Roadmap
 
-- Game end and Social Screen - update how they exit so user isn't dumped to OK prompt. Exit gracefully or restart menu.
 - Add the ability to save and display statistics
-- Add the ability to select different wordfiles
-- Port to the NEC PC-8201
+- Improve clues, guess feedback and messages
 
 
 ## FAQ
 ### About the word files and today's word
-The wordfiles we use in **m100le** are based on the the **original** javascript WORDLE, which contained the entire set of daily words (the wordfile) within the program code.  Over six years worth of words. 
+The current version of **m100le** (greater than v0.l) uses the New York Times Wordle word lists. Prevously, the wordfiles used were based on the the **original** javascript WORDLE, which contained the entire set of daily words (the wordfile) within the program code.  Over six years worth of words. 
 
 ### How wordfiles work
 Big wordfiles wouldn't work for our little units, so we broke each wordfile into manageable chunks of one year each. 
 
-The wordfiles are all appropriately named for the year they correspond to.  On program load, **m100le** checks the system **DATE$** for the current date and scans the appropriate wordfile for the matching daily word.
+The wordfiles are all appropriately named for the year they correspond to.  On program load, **m100le** checks the system **DATE$** for the current date OR the manually entered date (if enabled) and scans the appropriate wordfiles for the matching daily word.
 
 ### Will my m100le word be the same as today's NYT Wordle word?
-Maybe. m100le wordlists are based on the javascript version that was running online prior to the NYT acquisition of WORDLE. So today's word in m100le may be the same word in NYT WORDLE, or not.
+Maybe. Mostly. The NYT may change their word list at any time. If that happens, and we don't catch it, let us know and we'll update ours.
 
 ## Feedback
 
@@ -111,11 +155,13 @@ If you have any feedback, please reach out to us:
 ## Acknowledgements
 
  - [Josh Wardle - Wordle's creator](https://en.wikipedia.org/wiki/Josh_Wardle)
+ - [hackerb9](https://github.com/hackerb9) - significant optimization and improvements. This thing rocks!!
  - [TRS-80 Model 100 BASIC - based on Microsoft BASIC, with special support for the RAM file store, LCD display, and other built-in hardware of the TRS-80 Model 100 and Tandy 102 portable computers](https://archive.org/details/MasteringBasicOnTheTrs80Model100/page/n5/mode/2up)
 
 
 ## Authors
 
 - [@bgrier](http://blog.bradgrier.com)
+- [hackerb9](https://github.com/hackerb9)