Update READMEs.
Chris Pressey
3 years ago
| 4 | 4 |
|
| 5 | 5 |
In the [rudiments](rudiments/) directory are programs which are
|
| 6 | 6 |
meant to demonstrate the elementary features of SixtyPical, and
|
| 7 | |
to serve as manual integration test cases.
|
| 8 | |
|
| 9 | |
These sources are portable across architectures. They include
|
| 10 | |
architecture-dependent libraries to produce output. Libraries
|
| 11 | |
for such are provided in the `include` directory in the root
|
| 12 | |
directory of the repository; make it is on the compiler's include
|
| 13 | |
search path.
|
| 14 | |
|
| 15 | |
Some others of these sources are meant to fail and produce an error
|
| 16 | |
message when compiled.
|
|
7 |
to serve as manual integration test cases. See
|
|
8 |
[the README in that directory](rudiments/README.md) for details.
|
| 17 | 9 |
|
| 18 | 10 |
### c64
|
| 19 | 11 |
|
| 1 | 1 |
the rudiments of SixtyPical.
|
| 2 | 2 |
|
| 3 | 3 |
Examples that are meant to fail and produce an error message
|
| 4 | |
are in the `errorful/` subdirectory.
|
|
4 |
when being compiled are in the `errorful/` subdirectory.
|
| 5 | 5 |
|
| 6 | |
These files are intended to be architecture-agnostic.
|
| 7 | |
For the ones that do produce output, an appropriate source
|
| 8 | |
under `support/` should be included first, so that system entry
|
| 9 | |
points such as `chrout` are defined. In addition, some of these
|
| 10 | |
programs use "standard" support modules, so those should be included
|
| 11 | |
first too. For example:
|
|
6 |
The other sources are portable across architectures. They use
|
|
7 |
`include` directives to bring in architecture-dependent libraries
|
|
8 |
to produce output. Libraries for such are provided in the
|
|
9 |
architecture-specific subdirectories of the `include` directory
|
|
10 |
in the root directory of this repository; make sure it is on the
|
|
11 |
compiler's include search path. For example:
|
| 12 | 12 |
|
| 13 | |
sixtypical --run-on=x64 support/c64.60p support/stdlib.60p vector-table.60p
|
|
13 |
sixtypical --run-on=x64 -I../../include/c64/:../../include/stdlib/ vector-table.60p
|
| 14 | 14 |
|
| 15 | 15 |
`chrout` is a routine with outputs the value of the accumulator
|
| 16 | 16 |
as an ASCII character, disturbing none of the other registers,
|