From 7b597afbed589727885e49687bea2199edb61440 Mon Sep 17 00:00:00 2001
From: Wolfgang Thaller <wolfgang.thaller@gmx.net>
Date: Wed, 24 Jul 2024 22:20:23 +0200
Subject: [PATCH] accept .bin for universal interface files and update docs

---
 README.md                   | 6 ++++++
 interfaces-and-libraries.sh | 9 ++++++++-
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 9410ec2e1b..02c474356f 100644
--- a/README.md
+++ b/README.md
@@ -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.
diff --git a/interfaces-and-libraries.sh b/interfaces-and-libraries.sh
index 752922a8e1..109d469163 100755
--- a/interfaces-and-libraries.sh
+++ b/interfaces-and-libraries.sh
@@ -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."