mirror of
https://github.com/autc04/Retro68.git
synced 2024-09-30 17:55:35 +00:00
Update documentation
This commit is contained in:
parent
507ba9debf
commit
d8ad527e0f
36
README.md
36
README.md
@ -126,7 +126,7 @@ Third Party Components:
|
|||||||
- binutils 2.28
|
- binutils 2.28
|
||||||
- gcc 6.3.0
|
- gcc 6.3.0
|
||||||
- newlib 2.10.1 (inside the gcc directory)
|
- newlib 2.10.1 (inside the gcc directory)
|
||||||
- elf2flt (from the ucLinux project's CVS)
|
- libelf from elfutils-0.170
|
||||||
- hfsutils 3.2.6
|
- hfsutils 3.2.6
|
||||||
|
|
||||||
Retro68-Specific Components:
|
Retro68-Specific Components:
|
||||||
@ -134,6 +134,7 @@ Retro68-Specific Components:
|
|||||||
- Rez
|
- Rez
|
||||||
- PEFTools (MakePEF and MakeImport)
|
- PEFTools (MakePEF and MakeImport)
|
||||||
- MakeAPPL
|
- MakeAPPL
|
||||||
|
- LaunchAPPL
|
||||||
- libretro
|
- libretro
|
||||||
- TestApps - a few tiny test programs
|
- TestApps - a few tiny test programs
|
||||||
- Sample Programs: Raytracer, HelloWorld, Launcher, Dialog
|
- Sample Programs: Raytracer, HelloWorld, Launcher, Dialog
|
||||||
@ -145,6 +146,7 @@ Two new target platforms:
|
|||||||
- `powerpc-apple-macos`, based on the `powerpc-ibm-aix` target
|
- `powerpc-apple-macos`, based on the `powerpc-ibm-aix` target
|
||||||
|
|
||||||
The powerpc target has a few hacks to make weak symbols work as expected.
|
The powerpc target has a few hacks to make weak symbols work as expected.
|
||||||
|
The elf target has a hack to protect MacsBug symbols from -gc-sections.
|
||||||
|
|
||||||
### gcc
|
### gcc
|
||||||
|
|
||||||
@ -169,10 +171,12 @@ PowerPC specific:
|
|||||||
Standard C library. Currently unmodified. The missing platform-dependent
|
Standard C library. Currently unmodified. The missing platform-dependent
|
||||||
bits haven't been added, instead they are found in 'libretro'.
|
bits haven't been added, instead they are found in 'libretro'.
|
||||||
|
|
||||||
### elf2flt
|
### libelf
|
||||||
|
|
||||||
Converts from ELF to a much simpler binary format.
|
A library for convenient access to ELF files, taken from the elfutils-0.170
|
||||||
Minor patch: provide symbols around .init and .fini sections
|
package. Or rather, brutally ripped out of it, hacked to compile on non-linux
|
||||||
|
platforms (<endian.h> is not a standard header file), and made to build with
|
||||||
|
cmake instead of autotools. Much simpler now.
|
||||||
|
|
||||||
### hfsutils:
|
### hfsutils:
|
||||||
|
|
||||||
@ -188,6 +192,26 @@ A reimplementation of Apple's Rez resource compiler. Reads `.r` files
|
|||||||
containing textual resource descriptions and compiles them to binary
|
containing textual resource descriptions and compiles them to binary
|
||||||
resource files.
|
resource files.
|
||||||
|
|
||||||
|
### Elf2Mac
|
||||||
|
|
||||||
|
A wrapper around the linker for 68K programs; it supplies a linker script,
|
||||||
|
invokes the linker, and converts the resulting ELF binary to a Mac APPL with
|
||||||
|
one or more segments, or to a flat file which can be converted to a code resource
|
||||||
|
using Rez.
|
||||||
|
|
||||||
|
### LaunchAPPL
|
||||||
|
|
||||||
|
A tool for lauching compiled Mac applications via various emulators.
|
||||||
|
Currently, there are the following backends:
|
||||||
|
|
||||||
|
* classic - launch in the Classic environment on PowerPC Macs up to Tiger (10.4)
|
||||||
|
* carbon - launch as a Carbon app on PowerPC Macs and via Rosetta on Intel Macs up to Snow Leopard (10.6)
|
||||||
|
* minivmac - launch using the Mini vMac emulator
|
||||||
|
* executor - launch using Executor
|
||||||
|
|
||||||
|
**CONTRIBUTION OPPORTUNITY** - This tool can easily be extended with further backends,
|
||||||
|
so make it work with your favourtite emulator.
|
||||||
|
|
||||||
### ConvertObj
|
### ConvertObj
|
||||||
|
|
||||||
Reads a MPW 68K Object file (`*.o`) and converts it to input for the
|
Reads a MPW 68K Object file (`*.o`) and converts it to input for the
|
||||||
@ -228,6 +252,10 @@ for some standard library functions.
|
|||||||
|
|
||||||
Contains a library that implements basic text console functionality.
|
Contains a library that implements basic text console functionality.
|
||||||
|
|
||||||
|
### AutomatedTests
|
||||||
|
|
||||||
|
An automated test suite that can be run using `ctest` and `LaunchAPPL`.
|
||||||
|
|
||||||
### Sample Program: Hello World
|
### Sample Program: Hello World
|
||||||
|
|
||||||
The binary is in Retro68-build/build-target/Samples/HelloWorld/.
|
The binary is in Retro68-build/build-target/Samples/HelloWorld/.
|
||||||
|
Loading…
Reference in New Issue
Block a user