Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update README #34

Open
10 of 19 tasks
hackerb9 opened this issue Oct 1, 2022 · 14 comments
Open
10 of 19 tasks

Update README #34

hackerb9 opened this issue Oct 1, 2022 · 14 comments
Assignees

Comments

@hackerb9
Copy link
Contributor

hackerb9 commented Oct 1, 2022

Before the next release, it would be good to update the README.md file. I do not think it will require much.

  • Instructions for which files to download (M100.BA and WL20XX.CO)
    • Quick start, if you know what you're doing
    • Instructions for BASIC (ASCII) download (tokenization and compression)
    • Instructions for sending an ASCII file over serial from a modern computer
    • Instructions for binary download (teeny example)
  • New section on non -Tandy Kyotronic sisters (NEC, K-85, Olivetti)
    • Different .BA file (same source .DO)
    • Modify to say only NEC has a different .BA
    • Same Word List files
    • YY/MM/DD format
    • DD/MM/YY format (K-85, M10)
  • Update details on the DATE entry screen
    • Default is today's Wordle
    • Allows ordinal day ("Day of Year")
    • Mention that the date must be typed exactly
    • Remove mention about exact date entry
    • Remove statement that a Y2K patched ROM is needed
  • Update images with new Alphabet board position
  • Revise text to explain the new 'letter pop-out' clue
@bgri
Copy link
Owner

bgri commented Oct 7, 2022

Looks good. Yeah, given all the updates you've made (awesome work!!) it's almost a new program :) I'll take a pass at this.

@bgri bgri self-assigned this Oct 7, 2022
@bgri
Copy link
Owner

bgri commented Oct 8, 2022

Ok, first draft at an update. How's this? Feel free to tweak as needed -- I may have missed something as there was a lot updated :)
README.md.zip

Also, I'm thinking we can probably take the current version and .zip it up for a 0.m release once we get this readme done. Then move forward...

Thoughts?

hackerb9 added a commit to hackerb9/M100LE that referenced this issue Oct 11, 2022
This is the version bgrier put in issue bgri#34.
@hackerb9
Copy link
Contributor Author

I've made a new branch to experiment with edits. Let me know what you think of this https://github.com/hackerb9/M100LE/tree/documentation

I feel like it's not done, but I know that part of what's bugging me is things like telling people that they have to type the DATE exactly or it won't work. Sometimes I'd rather fix a program than admit to having a misfeature like that.

@bgri
Copy link
Owner

bgri commented Oct 11, 2022

Nice! I like the organizational changes and the additional detail about the optimization. I'm totally good to go with this version. If you agree I'll zip up the whole shebang and pop it into the releases section. Nice work!!

As for the date, I guess we could look at putting in some sort of date picker routine. Display a month calendar and navigate using arrow keys etc. Though it would look nice and 'modern', it would likely add a lot of code.

Or do a date verification before looking for the word list file? Something like:
You entered Saturday, October 1, 2022. [C]ontinue or [E]dit?

@hackerb9
Copy link
Contributor Author

Oh, the thing that's bugging me about the date is that if you type 3/4/22, it gets confused.

Let's hold off briefly on packaging it up. I'm trying to finish up some documentation on how to transfer the files and in so doing I'm coming across small bugs. For example, the [A]GAIN option gave the system date as the default instead of the game you just played. I've fixed that (and a couple others) and will send a pull request.

Also, did we ever confirm that CMPRSS.DO works on a NEC? I realize I never wrote up a howto for using it, so I'm doing that now.

@bgri
Copy link
Owner

bgri commented Oct 13, 2022

Ah, do we want to put in some date checking to enforce the format? When looking at calendar dates, only accept MM/DD/YY?

Totally good on holding off for a bit. And no, don't think we've tested CMPRSS.DO on a NEC. I'll do that tonight.

@bgri
Copy link
Owner

bgri commented Oct 13, 2022

Also, did we ever confirm that CMPRSS.DO works on a NEC? I realize I never wrote up a howto for using it, so I'm doing that now.

Yep. Tonight I've just loaded fresh copies of CMPRSS and WL2022. CMPRSS created a good wordlist .CO file that I spent way too much time testing.

It seems my 8201a is having a hardware issue or two. I have to spend some time and take a look at it. It's overdue. I think I'm having a minor issue with the serial port, and there's now a bad LCD strip on one of the display controler panels. So I need to poke at it. But first, I should get my 8300 up and running so I can use it while this one is on the workbench :)

Compounding things, I've got REX# and the 2nd bank 32k ram expansion card installed. So there could be a lot going on there. Yay?

@hackerb9
Copy link
Contributor Author

Also, did we ever confirm that CMPRSS.DO works on a NEC? I realize I never wrote up a howto for using it, so I'm doing that now.

Yep. Tonight I've just loaded fresh copies of CMPRSS and WL2022. CMPRSS created a good wordlist .CO file that I spent way too much time testing.

If by "testing", you mean actually playing the game and having fun, then yes, that happens to me, too. It's actually quite enjoyable in this form factor.

When I want to play multiple games, to avoid seeing words that haven't happened yet, I usually go backwards in time, always selecting the previous (yesterday's) puzzle. It's a bit inconvenient, though. I've been thinking it would be nice to have a "[P]REVIOUS" option (maybe hit the - MINUS key at the end of the game). Of course, good idea or not, it'd wait until after 0.m no matter what.

One thing that would be nice to get nailed down before the release is whether CMPRSS works over the serial port for the NEC computers.

It seems my 8201a is having a hardware issue or two. I have to spend some time and take a ld t it. It's overdue. I think I'm having a minor issue with the serial port, and there's now a bad LCD strip on one of the display controler panels. So I need to poke at it. But first, I should get my 8300 up and running so I can use it while this one is on the workbench :)

Compounding things, I've got REX# and the 2nd bank 32k ram expansion card installed. So there could be a lot going on there. Yay?

Oof. It's a good thing you've got more than one to tide you over until you can get that fixed. Did you say you also have a PC-8200 (as well as PC-82001A).

@bgri
Copy link
Owner

bgri commented Oct 16, 2022

If by "testing", you mean actually playing the game and having fun, then yes, that happens to me, too. It's actually quite enjoyable in this form factor.

Yes, heh, that's exactly what I mean by "testing". :)

I've been thinking it would be nice to have a "[P]REVIOUS" option (maybe hit the - MINUS key at the end of the game).

I like the MINUS key thing. Automagically restart the game with the previous date. Nice quick shortcut.

One thing that would be nice to get nailed down before the release is whether CMPRSS works over the serial port for the NEC computers.

For sure. I can try it once I get one of my 8300 off the bench.

Did you say you also have a PC-8200 (as well as PC-82001A).

Yep. 8201 (Red). LCD Polarizer filter is detaching. Not full 32k RAM. Should be my backup unit if REX# will talk to it (have to test).
8300. On the bench tonight to swap out the memory battery and give it a good cleaning.
8201a. Not feeling so hot. Needs a bit of a thorough review. I think there may be some corrosion I missed a year or so ago.

I've been stocking up on projects for winter :)

@bgri
Copy link
Owner

bgri commented Oct 16, 2022

image

More 'testing' on the 8201.

image

image

... and once I get to connecting this to my WinBox, I should be able to test if NEC CMPRSS will do the needful :)

@hackerb9
Copy link
Contributor Author

hackerb9 commented Oct 17, 2022

Thanks for the screenshots. That's great that the BSAVE kludge actually works on a genuine NEC. And it's satisfying to see that, even with the European style DATE$, the correct word is being picked.

One thing: I don't understand why the system labels are still showing. Does SCREEN 0,0 not turn them off on a NEC PC-8201?

@bgri
Copy link
Owner

bgri commented Oct 17, 2022

Oh! I think I tested on an older version. I moved my REX# from my ailing 8201a to the 8201 and refreshed from a slightly older backup, so yeah, it's probably not the current one. I'll load it and test that today.

@bgri
Copy link
Owner

bgri commented Oct 18, 2022

Yup, an older version. SCREEN 0,0 works fine in this version.

image

bgri pushed a commit that referenced this issue Oct 24, 2022
This is the version bgrier put in issue #34.
@bgri
Copy link
Owner

bgri commented Nov 2, 2022

Note to self: update images in readme to include new position of the Alphabet panel and images from different platforms.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants