From 8cbbb2ed50f96a8350ec6635e393a0b70f36676f Mon Sep 17 00:00:00 2001 From: dingusdev <52434309+dingusdev@users.noreply.github.com> Date: Mon, 15 Apr 2024 07:01:51 -0700 Subject: [PATCH] Initial preparation for a release --- CREDITS.md | 32 +++++++++++++ icon.png | Bin 0 -> 4062 bytes main.cpp | 9 ++-- zdocs/{ => developers}/aboutthis.md | 0 zdocs/{ => developers}/adb.md | 0 zdocs/{ => developers}/atirage.md | 0 zdocs/{ => developers}/awacs.md | 0 zdocs/{ => developers}/bmac.md | 0 zdocs/{ => developers}/cpu/powerpc/mmu.md | 0 zdocs/{ => developers}/cpu/powerpc/mmuemu.md | 0 .../get-inherited-property notes.txt | 0 zdocs/{ => developers}/grackle.md | 0 zdocs/{ => developers}/heathrow.md | 0 zdocs/{ => developers}/machines/pdmram.md | 0 zdocs/{ => developers}/memorymaps.md | 0 zdocs/{ => developers}/mesh.md | 0 zdocs/{ => developers}/misc.md | 0 zdocs/{ => developers}/openfirmware.md | 0 zdocs/{ => developers}/powerpc.md | 0 zdocs/{ => developers}/viacuda.md | 0 zdocs/users/manual.md | 45 ++++++++++++++++++ 21 files changed, 82 insertions(+), 4 deletions(-) create mode 100644 CREDITS.md create mode 100644 icon.png rename zdocs/{ => developers}/aboutthis.md (100%) rename zdocs/{ => developers}/adb.md (100%) rename zdocs/{ => developers}/atirage.md (100%) rename zdocs/{ => developers}/awacs.md (100%) rename zdocs/{ => developers}/bmac.md (100%) rename zdocs/{ => developers}/cpu/powerpc/mmu.md (100%) rename zdocs/{ => developers}/cpu/powerpc/mmuemu.md (100%) rename zdocs/{ => developers}/get-inherited-property notes.txt (100%) mode change 100755 => 100644 rename zdocs/{ => developers}/grackle.md (100%) rename zdocs/{ => developers}/heathrow.md (100%) rename zdocs/{ => developers}/machines/pdmram.md (100%) rename zdocs/{ => developers}/memorymaps.md (100%) rename zdocs/{ => developers}/mesh.md (100%) rename zdocs/{ => developers}/misc.md (100%) rename zdocs/{ => developers}/openfirmware.md (100%) rename zdocs/{ => developers}/powerpc.md (100%) rename zdocs/{ => developers}/viacuda.md (100%) create mode 100644 zdocs/users/manual.md diff --git a/CREDITS.md b/CREDITS.md new file mode 100644 index 0000000..046f974 --- /dev/null +++ b/CREDITS.md @@ -0,0 +1,32 @@ +# DingusPPC + + +## Developers + +- divingkatae +- maximumspatium +- joevt +- mihaip + +## Building + +- Waqar144 +- webspacecreations +- leap0x7b +- sdkmap + +## Testing + +- LagLifeYT + +## Thanks + +- 68kmla +- AppleFritter +- Archive.org +- Bitsavers +- Emaculation +- GitHub +- PenguinPPC +- The developers of other PowerPC Mac emulators, past and present +- All those preserving the software of 68k and PowerPC Macs diff --git a/icon.png b/icon.png new file mode 100644 index 0000000000000000000000000000000000000000..2f281f59239417eaf21cad492e82502c84eb5e53 GIT binary patch literal 4062 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 RQ1(ALaK_Bmw9>>Q{(p~4W1s*4 literal 0 HcmV?d00001 diff --git a/main.cpp b/main.cpp index 8a2a7ed..4ac507b 100644 --- a/main.cpp +++ b/main.cpp @@ -53,10 +53,11 @@ void sigabrt_handler(int signum) { } static string appDescription = string( - "\nDingusPPC - Prototype 5bf5 (8/23/2020) " - "\nWritten by divingkatae and maximumspatium " - "\n(c) 2018-2020 The DingusPPC Dev Team. " - "\nThis is not intended for general use. " + "\nDingusPPC - Alpha 1 (5/10/2024) " + "\nWritten by divingkatae, maximumspatium, " + "\njoevt, mihaip, et. al. " + "\n(c) 2018-2024 The DingusPPC Dev Team. " + "\nThis is a build intended for testing. " "\nUse at your own discretion. " "\n" ); diff --git a/zdocs/aboutthis.md b/zdocs/developers/aboutthis.md similarity index 100% rename from zdocs/aboutthis.md rename to zdocs/developers/aboutthis.md diff --git a/zdocs/adb.md b/zdocs/developers/adb.md similarity index 100% rename from zdocs/adb.md rename to zdocs/developers/adb.md diff --git a/zdocs/atirage.md b/zdocs/developers/atirage.md similarity index 100% rename from zdocs/atirage.md rename to zdocs/developers/atirage.md diff --git a/zdocs/awacs.md b/zdocs/developers/awacs.md similarity index 100% rename from zdocs/awacs.md rename to zdocs/developers/awacs.md diff --git a/zdocs/bmac.md b/zdocs/developers/bmac.md similarity index 100% rename from zdocs/bmac.md rename to zdocs/developers/bmac.md diff --git a/zdocs/cpu/powerpc/mmu.md b/zdocs/developers/cpu/powerpc/mmu.md similarity index 100% rename from zdocs/cpu/powerpc/mmu.md rename to zdocs/developers/cpu/powerpc/mmu.md diff --git a/zdocs/cpu/powerpc/mmuemu.md b/zdocs/developers/cpu/powerpc/mmuemu.md similarity index 100% rename from zdocs/cpu/powerpc/mmuemu.md rename to zdocs/developers/cpu/powerpc/mmuemu.md diff --git a/zdocs/get-inherited-property notes.txt b/zdocs/developers/get-inherited-property notes.txt old mode 100755 new mode 100644 similarity index 100% rename from zdocs/get-inherited-property notes.txt rename to zdocs/developers/get-inherited-property notes.txt diff --git a/zdocs/grackle.md b/zdocs/developers/grackle.md similarity index 100% rename from zdocs/grackle.md rename to zdocs/developers/grackle.md diff --git a/zdocs/heathrow.md b/zdocs/developers/heathrow.md similarity index 100% rename from zdocs/heathrow.md rename to zdocs/developers/heathrow.md diff --git a/zdocs/machines/pdmram.md b/zdocs/developers/machines/pdmram.md similarity index 100% rename from zdocs/machines/pdmram.md rename to zdocs/developers/machines/pdmram.md diff --git a/zdocs/memorymaps.md b/zdocs/developers/memorymaps.md similarity index 100% rename from zdocs/memorymaps.md rename to zdocs/developers/memorymaps.md diff --git a/zdocs/mesh.md b/zdocs/developers/mesh.md similarity index 100% rename from zdocs/mesh.md rename to zdocs/developers/mesh.md diff --git a/zdocs/misc.md b/zdocs/developers/misc.md similarity index 100% rename from zdocs/misc.md rename to zdocs/developers/misc.md diff --git a/zdocs/openfirmware.md b/zdocs/developers/openfirmware.md similarity index 100% rename from zdocs/openfirmware.md rename to zdocs/developers/openfirmware.md diff --git a/zdocs/powerpc.md b/zdocs/developers/powerpc.md similarity index 100% rename from zdocs/powerpc.md rename to zdocs/developers/powerpc.md diff --git a/zdocs/viacuda.md b/zdocs/developers/viacuda.md similarity index 100% rename from zdocs/viacuda.md rename to zdocs/developers/viacuda.md diff --git a/zdocs/users/manual.md b/zdocs/users/manual.md new file mode 100644 index 0000000..be64102 --- /dev/null +++ b/zdocs/users/manual.md @@ -0,0 +1,45 @@ +# DingusPPC User Manual + +## Commands + +DingusPPC is operated using the command line interface. As such, we will list the commands as required. + +``` +-r, --realtime +``` + +Run the emulator in runtime. + +``` +-d, --debugger +``` + +Enter the interactive debugger. The user may also enter the debugger at any point by pressing Control and C. + +``` +list machines +``` + +Shows the currently implemented machines within DingusPPC. + +``` +list properties +``` + +Shows the configurable properties, such as the selected disc image and the ram bank sizes. + +## Supported machines + +The machines that currently work the best are the Power Mac 6100, the Power Mac 7500, and the Power Mac G3. + +Early implementations for the Power Mac G3 Blue and White and the Apple Pippin are also present. + +## Quirks + +### CD ROM Images + +Currently, ISO images are supported. However, support is not yet implemented for multi-mode CD images. + +### Hard Disks + +Because Sheepshaver, Basilisk II, and Mini vMac operate on raw disks, it is required to a program such as BlueSCSI to make their hard disk images work in an emulator like DingusPPC. \ No newline at end of file