add more options to client build script and document them as well as the standalone bootloader

This commit is contained in:
Iris Lightshard 2021-10-17 11:18:24 -06:00
parent df0c4db3b4
commit 30603241cb
Signed by: Iris Lightshard
GPG key ID: 3B7FBC22144E6398
2 changed files with 19 additions and 5 deletions

View file

@ -86,8 +86,14 @@ You can add `-d` to either the `xrxs` command line or the `xrxs-srv.sh` command
### client ### client
From the `uxn-client` directory, run `./build.sh` to compile the ROM. If you're working on the ROM with some local test files, not over 9p, you can also add the `-r` flag to run after building without starting the `9p` client. There are two versions of the client ROM. One is the normal `xrxs` client, and one is a standalone client for use as a generic `uxn` bootloader. The latter reads a ROM list out of a file called `index`, and appends the `.rom` extension to your selection and loads a file so named. Note that while the `9p` filesystem will be located under the parent directory of `./n`, the standalone bootloader assumes a flat filesystem.
When the ROM has been built, run `./uxn-xrxs.sh` to mount the `9p` service and run the client. You can run `./build.sh` with no options to build the normal `xrxs` client, or with any of the following options:
Both scripts assume you have `uxnasm` and `uxnemu` in your `PATH` respectively. `9pfuse` is used to mount the service, but other implementations could possibly be used. * `-r`: build the normal client and run it for local testing (don't mount the remote `9p` filesystem)
* `-l`: build the standalone bootloader
* `-lr`: build the standalone bootloader and run it
When the client ROM has been built, run `./uxn-xrxs.sh` to mount the `9p` service and run the client.
The scripts assume you have `uxnasm` and `uxnemu` in your `PATH`. `9pfuse` is used to mount the service, but other implementations could possibly be used.

View file

@ -1,7 +1,15 @@
#!/bin/sh #!/bin/sh
rm xrxs.rom 2>/dev/null rm xrxs.rom 2>/dev/null
uxnasm xrxs.tal xrxs.rom
if [ "$1" = "-r" ]; then if [ "$1" = "-l" ]; then
uxnasm xrxs-local.tal xrxs.rom
elif [ "$1" = "-lr" ]; then
uxnasm xrxs-local.tal xrxs.rom
uxnemu xrxs.rom uxnemu xrxs.rom
else
uxnasm xrxs.tal xrxs.rom
if [ "$1" = "-r" ]; then
uxnemu xrxs.rom
fi
fi fi