Getting Started

get-started
calendarsave
xyw is written in C99 and it is self contained within a single executable with no external dependencies (except some system libraries for the beeper device, but you can choose not to support it). === 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. If you want to compile without beeper support because your device has no audio support or simply you don't want to, you can run make with the appropriate flags, as follows: make AUDIO_CFLAGS=-DXYW_NO_AUDIO_BACKEND AUDIO_LIBS=none === The xyw executable The xyw executable provides: dot-single an assembler to assemble .xyw source files into .xim image files dot-single a virtual machine to execute .xim image files == Options dot-single -d, --debug: run in debug mode printing every instruction and state data. dot-single -h, --help: print the help screen and exit. dot-single -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).