accept .bin for universal interface files and update docs

This commit is contained in:
Wolfgang Thaller 2024-07-24 22:20:23 +02:00
parent e9efa0c989
commit 7b597afbed
2 changed files with 14 additions and 1 deletions

View File

@ -78,6 +78,12 @@ Version 3.4 has received the most testing, but any 3.x version could theoretical
work. The exact directory layout inside the InterfacesAndLibraries directory does
not matter. It will be picked up automatically when Retro68 is built.
Especially on non-macOS platforms, make sure that the Mac resource fork of the
PowerPC library files is included in a format recognized by Retro68.
Recognized formats include MacBinary II (e.g., Interfacelib.bin),
AppleDouble (._InterfaceLib or %InterfaceLib) or Basilisk/Sheepshaver resource
forks (.rsrc/InterfaceLib).
The Universal Interfaces were also included with Apple's free-to-download
Macintosh Programmer's Workshop (MPW; redistribution is not officially allowed, either)
and with Metrowerks CodeWarrior.

View File

@ -23,7 +23,7 @@ function locateInterfaceThing()
local varname=$1
local name=$2
printf "Searching for %-25s" "$name..."
local found=`find -L "$INTERFACES_DIR"/ -name ".*" -prune -o -name $name -print`
local found=`find -L "$INTERFACES_DIR"/ -name ".*" -prune -o \( -name $name -o -name $name.bin \) -print`
if [ -n "$found" ]; then
eval "$varname=\$found"
echo ${found#$INTERFACES_DIR/}
@ -61,6 +61,13 @@ function explainInterfaces()
echo " - (for PPC) a directory containing InterfaceLib (usually \"SharedLibraries\")"
echo " - (for Carbon) Carbon.h and CarbonLib, in the same directories"
echo
echo "Especially on non-macOS platforms, make sure that the Mac resource fork of the"
echo "PowerPC library files is included in a format recognized by Retro68."
echo
echo "Recognized formats include MacBinary II (Interfacelib.bin),"
echo "AppleDouble (._InterfaceLib or %InterfaceLib) or Basilisk/Sheepshaver resource"
echo "forks (.rsrc/InterfaceLib)."
echo
echo "The Interfaces&Libraries folder from Apple's last MPW release (MPW 3.5 "
echo "aka MPW GM 'Golden Master') is known to work."