💾 Archived View for mirrors.apple2.org.za › archive › apple.cabi.net › GS.Emulators › XGS.DOCS › POR… captured on 2023-01-29 at 07:59:24.
-=-=-=-=-=-=-
The XGS Porting Guide Written by Joshua M. Thompson (invid@optera.com) Last Updated March 16th, 1997 Please read this if you are interested in doing a port of XGS to a currently unsupported platform. Before starting any porting work, it's best to check with me first. This lets me keep track of who is doing what and make sure that nobody wastes effort by doing the same thing that somebody else is already working on. The next step is the hardest part: actually doing the port. This should not be _too_ difficult, as XGS is written to be portable and most of the code in the main distribution will compile on any decent ANSI C compiler with no modification whatsoever. In fact, your port will probably consist of the following components: o A video output driver (vid-drv.c and vid-drv.h) [ required ] o An input driver (adb-drv.c and adb-drv.h) [ required ] o A sound output driver (snd-drv.c and snd-drv.h) [ optional ] Drivers for specific ports are stored in subdirectories in the arch/ directory of the main source tree. If you need to make any patches outside of arch/, please try to keep them to an absolute minimum, make sure they don't break any other ports (use #ifdef's to bracket your changes if you must), and submit them to me for integration into the main source tree. Since XGS was originally written for X11 and Open Sound System, those ports are a good place from which to start your port. Once your port is completed, you can send me your drivers for inclusion into the arch/ directory of the main XGS distribution. [ need more detail here ]