User manual needs some work.

[janrinze]

Many long years ago I have used ArcEm a lot.
Now it happens that I simply have forgotten how to set it up.
For context: I am running it on Linux (Debian 12)

created ~/.arcemrc from the arcemrc (copied it.)
built arcem from source with make

created a directory ~/.arcem/roms and copied RISC OS 3.11 ROM in there as ROM

janrinze@debian:~/dev/ArcEm$ ls -al ~/.arcem/roms
total 2056
drwxr-xr-x 2 janrinze janrinze    4096 Dec  6 16:17 .
drwxr-xr-x 3 janrinze janrinze    4096 Dec  6 16:17 ..
-rw-r--r-- 1 janrinze janrinze 2097152 Dec  6 14:46 ROM
janrinze@debian:~/dev/ArcEm$ ARCEMXMOUSEKEY="End" ./arcem --processor ARM3 --memory 16M --rom ~/.arcem/roms/ROM
Could not open Extension Rom directory 'extnrom': No such file or directory
extnrom_size = 0, extnrom_entry_count= 0
HDC: Couldn't open image for drive 0
HDC: Couldn't open image for drive 1
HDC: Couldn't open image for drive 2
HDC: Couldn't open image for drive 3
mouse_key is End
...

So far so good, we have ArcEm running in a (small) window. The RISC OS desktop is visible!
I added ARCEMXMOUSEKEY="End" because I have a small keyboard without a keypad. So 'End' key will toggle mouse capture.

Now I want to add a harddisk But it is completely unclear where it searches for the harddisk image. Also the search path for the extnrom directory seems to be hazy.

I'm sure at one point I knew all these but it's been ages since I have used ArcEm.
Could someone do a simple write-up on how to set it up proper without having to dig in the source code to figure out where it tries to load this? Or just point me to the manual that I may have overlooked..

Best regards,
Jan Rinze.

[ccawley2011]

There's a manual available here: https://arcem-emu.github.io/manual/

That said, I haven't really touched the website beyond converting it to Git. If you're interested in updating it, then PRs are welcome here: https://github.com/ArcEm-emu/arcem-emu.github.io