commanderx16 / x16-emulator

Emulator for the Commander X16 8-bit computer
383 stars 59 forks source link

Documentation: Please document all of the C64 stuff you've adopted #85

Open naikrovek opened 4 years ago

naikrovek commented 4 years ago

I (and I'm sure, many others) have never owned a Commodore 64 and don't know all of the various addresses and peek/poke commands to make things happen, nor anything else about writing or even running software on the system.

This seems like it inherits (or, rather, adopts) a lot of C64 stuff, and I don't know any of those things, and those things should probably be documented for this project, somehow.

mist64 commented 4 years ago

Doesn't the Programmer's Reference Manual document all of this? Especially here: https://github.com/commanderx16/x16-docs/blob/master/Commander%20X16%20Programmer's%20Reference%20Guide.md#compatibility-considerations

What information exactly are you missing?

mist64 commented 4 years ago

I've added some more text:

https://github.com/commanderx16/x16-docs/commit/0102bd02908d59860c0dbfcfec6910d3d0735e51

naikrovek commented 4 years ago

Well, I was thinking more along the lines of example programs for both BASIC and assembly, and the like. Things that would have been included in any C64 documentation or that would have been included in any sought-after material at the time.

A list of addresses and what they do doesn't help me personally, but if no one else wants more than that, then I guess this isn't the community/project for me.

mist64 commented 4 years ago

The core team is working on writing a User's Manual with an introduction to the editor and BASIC programming. I believe they work on it in Google Docs and not publicly. You should reach out to them on the Facebook group to ask them about it.

greg-king5 commented 4 years ago

There is https://github.com/commanderx16/x16-demo