README: Add a screenshot

README: Document how sensitivity is affected
Makefile: Use variable for qemu
2023-03-27 19:42:56 +02:00 · 2023-03-27 19:42:56 +02:00 · 2023-03-27 19:42:56 +02:00 · 2023-03-27 19:42:56 +02:00
3 changed files with 7 additions and 3 deletions
--- a/3
+++ b/3
@ -1,5 +1,6 @@
 NASM = nasm
 PYTHON = python3
+QEMU = qemu-system-i386

 .SUFFIXES:
 .SUFFIXES: .bin .asm .ans .wall
@ -31,7 +32,7 @@ memory.bin: ponydos.inc
 	$(PYTHON) process_wallpaper.py $@ $< 7 0 0 0

 run: ponydos.img
-	qemu-system-i386 -fda $<
+	$(QEMU) -drive file=$<,index=0,if=floppy,format=raw

 clean:
 	rm -f *.bin *.img *.wall ponydos.inc
--- a/README.md
+++ b/README.md
@ -10,12 +10,14 @@ No! PonyDOS uses its own 512-byte kernel, built from scratch.

 ### Screenshots

-[todo: insert screenshots here]
+![PonyDOS in action](ponydos.png)

 ### Building from scratch

 To build PonyDOS from scratch, on an environment with `nasm` and `python3`,
 run `make`. `make run` runs the floppy disk image `ponydos.img` with QEMU.
+By default, `qemu-system-i386` is invoked. If you want to use a different
+backend, use `make QEMU=<backend> run`.

 ### How do I contribute?

@ -55,7 +57,8 @@ the symbol to resize.

 #### How do I adjust the mouse sensitivity?

-Tweak `X_SENSITIVITY` and `Y_SENSITIVITY` in `ponydos.asm`.
+Tweak `X_SENSITIVITY` and `Y_SENSITIVITY` in `ponydos.asm`. Lower values mean
+higher sensitivity.

 #### I started an application and it doesn't have a title bar, how do I exit it?

--- a/ponydos.png
+++ b/ponydos.png
Author	SHA1	Message	Date
Wolfgang Müller	ce7b2c9dd6	README: Add a screenshot	2023-03-27 19:42:56 +02:00
Wolfgang Müller	cce105184f	README: Document how sensitivity is affected	2023-03-27 19:42:56 +02:00
Wolfgang Müller	2e78130f67	Makefile: Use variable for qemu This way users can specify which backend to use without having to change the Makefile itself.	2023-03-27 19:42:56 +02:00
Wolfgang Müller	2ca9f413ab	Makefile: Quench qemu warning about image format qemu deems format autodetection to be dangerous on raw images, so make sure we specify exactly what we want to do. This will quench a scary-looking warning right when launching PonyDOS. There's no functional change otherwise.	2023-03-27 19:42:56 +02:00