diff --git a/eg/README.md b/eg/README.md index 615a8aa..9268429 100644 --- a/eg/README.md +++ b/eg/README.md @@ -5,16 +5,8 @@ in subdirectories by machine architecture. In the [rudiments](rudiments/) directory are programs which are meant to demonstrate the elementary features of SixtyPical, and -to serve as manual integration test cases. - -These sources are portable across architectures. They include -architecture-dependent libraries to produce output. Libraries -for such are provided in the `include` directory in the root -directory of the repository; make it is on the compiler's include -search path. - -Some others of these sources are meant to fail and produce an error -message when compiled. +to serve as manual integration test cases. See +[the README in that directory](rudiments/README.md) for details. ### c64 diff --git a/eg/rudiments/README.md b/eg/rudiments/README.md index a3b675d..547eb63 100644 --- a/eg/rudiments/README.md +++ b/eg/rudiments/README.md @@ -2,16 +2,16 @@ This directory contains example sources which demonstrate the rudiments of SixtyPical. Examples that are meant to fail and produce an error message -are in the `errorful/` subdirectory. +when being compiled are in the `errorful/` subdirectory. -These files are intended to be architecture-agnostic. -For the ones that do produce output, an appropriate source -under `support/` should be included first, so that system entry -points such as `chrout` are defined. In addition, some of these -programs use "standard" support modules, so those should be included -first too. For example: +The other sources are portable across architectures. They use +`include` directives to bring in architecture-dependent libraries +to produce output. Libraries for such are provided in the +architecture-specific subdirectories of the `include` directory +in the root directory of this repository; make sure it is on the +compiler's include search path. For example: - sixtypical --run-on=x64 support/c64.60p support/stdlib.60p vector-table.60p + sixtypical --run-on=x64 -I../../include/c64/:../../include/stdlib/ vector-table.60p `chrout` is a routine with outputs the value of the accumulator as an ASCII character, disturbing none of the other registers,