xyw is written in C99 and it is self contained within a single executable with no external dependencies (except perhaps some system libraries for the beeper device).
=== Accessing the source code
You can download xyw source code by cloning the repository at git.sr.ht/~h3rald/xyw.
=== Compiling
xyw is manually tested on Linux, NetBSD, macOS, and Windows. Regardless of the system, you will need GNU Make to build it, the GNU C Compiler (gcc), and bash to run the minimal test suite provided (test.sh).
To compile xyw, simply run make from the root directory of the project.
=== The xyw executable
The xyw executable provides:
an assembler to assemble .xyw source files into .xim image files
a virtual machine to execute .xim image files
== Options
-d, --debug: run in debug mode printing every instruction and state data.
-h, --help: print the help screen and exit.
-v, --version: print the program version (xyw follows Convergent Versioning).
== Arguments
The xyw executable takes a single argument, corresponding to the source file to assemble (if it has a .xyw extension) or the image file to execute (if it has a .xim extension).
an assembler to assemble .xyw source files into .xim image files
a virtual machine to execute .xim image files
== Options
-d, --debug: run in debug mode printing every instruction and state data.
-h, --help: print the help screen and exit.
-v, --version: print the program version (xyw follows Convergent Versioning).
== Arguments
The xyw executable takes a single argument, corresponding to the source file to assemble (if it has a .xyw extension) or the image file to execute (if it has a .xim extension).