@patleeman/pi-boy 0.1.0

package/mgba-bridge/vendor/mgba/Makefile.libretro

@@ -0,0 +1,490 @@
+DEBUG = 0
+HAVE_VFS_FD := 1
+CORE_DIR := .
+BUILD_DIR := libretro-build
+
+ifeq ($(platform),windows_x86)
+   include $(BUILD_DIR)/Makefile.windows_x86
+#else ifeq ($(platform),wii_ppc)
+   #include $(BUILD_DIR)/Makefile.wii_ppc
+else ifeq ($(platform),android_armeabi)
+   include $(BUILD_DIR)/Makefile.android_armeabi
+else ifeq ($(platform),android_arm64-v8a)
+   include $(BUILD_DIR)/Makefile.android_arm64-v8a
+else ifeq ($(platform),mingw_x86)
+   include $(BUILD_DIR)/Makefile.mingw_x86
+else ifeq ($(platform),mingw_x86_64)
+   include $(BUILD_DIR)/Makefile.mingw_x86_64
+else ifeq ($(platform),windows_x86_64)
+   include $(BUILD_DIR)/Makefile.windows_x86_64
+else ifeq ($(platform),linux_x86)
+   include $(BUILD_DIR)/Makefile.linux_x86
+else ifeq ($(platform),linux_x86_64)
+   include $(BUILD_DIR)/Makefile.linux_x86_64
+else ifeq ($(platform),android_armeabi-v7a)
+   include $(BUILD_DIR)/Makefile.android_armeabi-v7a
+else ifeq ($(platform),android_x86)
+   include $(BUILD_DIR)/Makefile.android_x86
+else ifeq ($(platform),android_mips64)
+   include $(BUILD_DIR)/Makefile.android_mips64
+else ifeq ($(platform),android_x86_64)
+   include $(BUILD_DIR)/Makefile.android_x86_64
+else ifeq ($(platform),linux-portable_x86)
+   include $(BUILD_DIR)/Makefile.linux-portable_x86
+else ifeq ($(platform),linux-portable_x86_64)
+   include $(BUILD_DIR)/Makefile.linux-portable_x86_64
+else ifeq ($(platform),android_mips)
+   include $(BUILD_DIR)/Makefile.android_mips
+else
+
+# system platform
+ifeq ($(platform),)
+   platform = unix
+   ifeq ($(shell uname -s),)
+      EXE_EXT = .exe
+      platform = win
+   else ifneq ($(findstring MINGW,$(shell uname -s)),)
+      platform = win
+   else ifneq ($(findstring Darwin,$(shell uname -s)),)
+      platform = osx
+      arch = intel
+      ifeq ($(shell uname -p),arm64)
+         arch = arm
+      endif
+      ifeq ($(shell uname -p),powerpc)
+         arch = ppc
+      endif
+   else ifneq ($(findstring win,$(shell uname -s)),)
+      platform = win
+   endif
+else ifneq (,$(findstring armv,$(platform)))
+	ifeq (,$(findstring classic_,$(platform)))
+		override platform += unix
+	endif
+endif
+
+prefix := /usr
+libdir := $(prefix)/lib
+
+LIBRETRO_DIR := libretro
+
+TARGET_NAME := mgba
+
+DEFINES :=
+
+ifeq (,$(findstring msvc,$(platform)))
+LIBS += -lm
+endif
+
+# GIT HASH
+GIT_VERSION := " $(shell git rev-parse --short HEAD || echo unknown)"
+ifneq ($(GIT_VERSION)," unknown")
+   DEFINES += -DGIT_VERSION=\"$(GIT_VERSION)\"
+endif
+
+# Unix
+ifneq (,$(findstring unix,$(platform)))
+   TARGET := $(TARGET_NAME)_libretro.so
+   fpic := -fPIC
+   SHARED := -shared -Wl,-version-script=link.T
+   DEFINES += -std=c99 -D_GNU_SOURCE -DHAVE_LOCALE
+
+# Raspberry Pi
+else ifneq (,$(findstring rpi,$(platform)))
+   TARGET := $(TARGET_NAME)_libretro.so
+   fpic := -fPIC
+   SHARED := -shared -Wl,-version-script=link.T
+   DEFINES += -std=c99 -D_GNU_SOURCE -DHAVE_LOCALE
+   LDFLAGS += -flto 
+   HAVE_VFS_FD = 0
+   CFLAGS += -fomit-frame-pointer -ftree-vectorize -flto
+   ifneq (,$(findstring rpi3,$(platform)))
+      CFLAGS += -marm -mcpu=cortex-a53 -mfloat-abi=hard
+   else ifneq (,$(findstring rpi4_64,$(platform)))
+      CFLAGS += -march=armv8-a+crc+simd -mtune=cortex-a72
+   endif
+
+# Go-Advance 
+else ifeq ($(platform), goadvance)
+   CPUFLAGS := -Ofast -march=armv8-a+crc+fp+simd -mcpu=cortex-a35 -flto -DUSE_RENDER_THREAD -DNO_ASM -DARM_ASM -frename-registers -ftree-vectorize
+   CFLAGS   := -DNDEBUG -Ofast -fno-ident
+   LDFLAGS  += -Ofast -fno-ident
+   CFLAGS  += $(CPUFLAGS) -fpic -fomit-frame-pointer -fno-exceptions -fno-non-call-exceptions -Wno-psabi -Wno-format
+   LDFLAGS += $(CPUFLAGS) -lpthread -Wl,--gc-sections -shared
+   TARGET := $(TARGET_NAME)_libretro.so
+   fpic := -fPIC
+   SHARED := -shared -Wl,-version-script=link.T
+   DEFINES += -std=c99 -D_GNU_SOURCE -DHAVE_LOCALE
+   HAVE_VFS_FD = 0
+
+# (armv7 a7, hard point, neon based) ### 
+# NESC, SNESC, C64 mini 
+else ifeq ($(platform), classic_armv7_a7)
+	TARGET := $(TARGET_NAME)_libretro.so
+	fpic := -fPIC
+	SHARED := -shared -Wl,--version-script=link.T -Wl,--no-undefined
+	CFLAGS += -Ofast \
+	-flto=4 -fwhole-program -fuse-linker-plugin \
+	-fdata-sections -ffunction-sections -Wl,--gc-sections \
+	-fno-stack-protector -fno-ident -fomit-frame-pointer \
+	-falign-functions=1 -falign-jumps=1 -falign-loops=1 \
+	-fno-unwind-tables -fno-asynchronous-unwind-tables -fno-unroll-loops \
+	-fmerge-all-constants -fno-math-errno \
+	-marm -mtune=cortex-a7 -mfpu=neon-vfpv4 -mfloat-abi=hard
+	CXXFLAGS += $(CFLAGS)
+	CPPFLAGS += $(CFLAGS)
+	ASFLAGS += $(CFLAGS)
+	HAVE_NEON = 1
+	ARCH = arm
+	BUILTIN_GPU = neon
+	HAVE_VFS_FD = 0
+    DEFINES += -std=c99 -D_GNU_SOURCE
+    DEFINES += -DHAVE_LOCALE
+	ifeq ($(shell echo `$(CC) -dumpversion` "< 4.9" | bc -l), 1)
+	  CFLAGS += -march=armv7-a
+	else
+	  CFLAGS += -march=armv7ve
+	  # If gcc is 5.0 or later
+	  ifeq ($(shell echo `$(CC) -dumpversion` ">= 5" | bc -l), 1)
+	    LDFLAGS += -static-libgcc -static-libstdc++
+	  endif
+	endif
+	
+# (armv8 a35, hard point, neon based) ###
+# Playstation Classic
+else ifeq ($(platform), classic_armv8_a35)
+	TARGET := $(TARGET_NAME)_libretro.so
+	fpic := -fPIC
+	SHARED := -shared -Wl,--version-script=link.T -Wl,--no-undefined
+	CFLAGS += -Ofast \
+	-flto=4 -fwhole-program -fuse-linker-plugin \
+	-fdata-sections -ffunction-sections -Wl,--gc-sections \
+	-fno-stack-protector -fno-ident -fomit-frame-pointer \
+	-falign-functions=1 -falign-jumps=1 -falign-loops=1 \
+	-fno-unwind-tables -fno-asynchronous-unwind-tables -fno-unroll-loops \
+	-fmerge-all-constants -fno-math-errno \
+	-marm -mtune=cortex-a35 -mfpu=neon-fp-armv8 -mfloat-abi=hard
+	CXXFLAGS += $(CFLAGS)
+	CPPFLAGS += $(CFLAGS)
+	ASFLAGS += $(CFLAGS)
+	HAVE_NEON = 1
+	ARCH = arm
+	BUILTIN_GPU = neon
+	HAVE_VFS_FD = 0
+    DEFINES += -std=c99 -D_GNU_SOURCE
+    DEFINES += -DHAVE_LOCALE
+    	CFLAGS += -march=armv8-a
+	LDFLAGS += -static-libgcc -static-libstdc++
+#######################################
+
+# OS X
+else ifeq ($(platform), osx)
+   TARGET := $(TARGET_NAME)_libretro.dylib
+   fpic := -fPIC
+   SHARED := -dynamiclib
+   OSXVER = `sw_vers -productVersion | cut -d. -f 2`
+   OSX_LT_MAVERICKS = `(( $(OSXVER) <= 9)) && echo "YES"`
+   ifeq ($(OSX_LT_MAVERICKS),YES)
+   	   fpic += -mmacosx-version-min=10.1
+   endif
+   ifndef ($(NOUNIVERSAL))
+      CFLAGS += $(ARCHFLAGS)
+      LDFLAGS += $(ARCHFLAGS)
+   endif
+   ifeq ($(arch),ppc)
+      DEFINES += -D__POWERPC__ -D__PPC__ -DMSB_FIRST
+   endif
+   DEFINES += -std=gnu99
+	DEFINES += -DHAVE_STRLCPY
+   ifeq ($(CROSS_COMPILE),1)
+	TARGET_RULE  = -target $(LIBRETRO_APPLE_PLATFORM) -isysroot $(LIBRETRO_APPLE_ISYSROOT)
+	CFLAGS      += $(TARGET_RULE)
+	LDFLAGS     += $(TARGET_RULE)
+   endif
+
+# iOS
+else ifneq (,$(findstring ios,$(platform)))
+   TARGET := $(TARGET_NAME)_libretro_ios.dylib
+   fpic := -fPIC
+   SHARED := -dynamiclib
+   ifeq ($(IOSSDK),)
+      IOSSDK := $(shell xcodebuild -version -sdk iphoneos Path)
+   endif
+   ifeq ($(platform),ios-arm64)
+      CC = cc -arch arm64 -isysroot $(IOSSDK)
+   else
+      CC = cc -arch armv7 -isysroot $(IOSSDK)
+   endif
+   ifeq ($(platform),$(filter $(platform),ios9 ios-arm64))
+      CC += -miphoneos-version-min=8.0
+      PLATFORM_DEFINES := -miphoneos-version-min=8.0
+   else
+      CC += -miphoneos-version-min=5.0
+      PLATFORM_DEFINES := -miphoneos-version-min=5.0
+   endif
+   DEFINES += -std=c99
+   DEFINES += -DHAVE_STRLCPY
+
+# tvOS
+else ifeq ($(platform), tvos-arm64)
+   TARGET := $(TARGET_NAME)_libretro_tvos.dylib
+   fpic := -fPIC
+   SHARED := -dynamiclib
+   CFLAGS := -DIOS
+   DEFINES += -std=c99
+   DEFINES += -DHAVE_STRLCPY
+
+ifeq ($(IOSSDK),)
+   IOSSDK := $(shell xcodebuild -version -sdk appletvos Path)
+endif
+   CC = clang -arch arm64 -isysroot $(IOSSDK)
+   CXX = clang++ -arch arm64 -isysroot $(IOSSDK)
+   CC += -mappletvos-version-min=11.0
+   PLATFORM_DEFINES := -mappletvos-version-min=11.0
+
+# Theos
+else ifeq ($(platform), theos_ios)
+   DEPLOYMENT_IOSVERSION = 5.0
+   TARGET = iphone:latest:$(DEPLOYMENT_IOSVERSION)
+   ARCHS = armv7 armv7s
+   TARGET_IPHONEOS_DEPLOYMENT_VERSION=$(DEPLOYMENT_IOSVERSION)
+   THEOS_BUILD_DIR := objs
+   include $(THEOS)/makefiles/common.mk
+   LIBRARY_NAME = $(TARGET_NAME)_libretro_ios
+   DEFINES += -std=c99
+
+# QNX
+else ifeq ($(platform), qnx)
+   TARGET := $(TARGET_NAME)_libretro_qnx.so
+   fpic := -fPIC
+   SHARED := -lcpp -lm -shared -Wl,-version-script=link.T
+   CC = qcc -Vgcc_ntoarmv7le
+   AR = QCC -Vgcc_ntoarmv7le
+   PLATFORM_DEFINES := -D__BLACKBERRY_QNX__ -fexceptions -marm -mcpu=cortex-a9 -mfpu=neon -mfloat-abi=softfp
+   DEFINES += -Wc,-std=c99
+
+# PS3
+else ifneq (,$(filter $(platform), psl1ght))
+   TARGET := $(TARGET_NAME)_libretro_$(platform).a
+   CC = $(PS3DEV)/ppu/bin/ppu-gcc$(EXE_EXT)
+   AR = $(PS3DEV)/ppu/bin/ppu-ar$(EXE_EXT)
+   PLATFORM_DEFINES := -D__PPC__ -D__BIG_ENDIAN__
+   STATIC_LINKING = 1
+   DEFINES += -std=gnu99 -fms-extensions
+   HAVE_VFS_FD = 0
+
+# PS2
+else ifeq ($(platform), ps2)
+   TARGET := $(TARGET_NAME)_libretro_$(platform).a
+   CC = mips64r5900el-ps2-elf-gcc$(EXE_EXT)
+   AR = mips64r5900el-ps2-elf-ar$(EXE_EXT)
+   PLATFORM_DEFINES := -DPS2 -DCC_RESAMPLER
+   CFLAGS += -G0 -DHAVE_NO_LANGEXTRA -DHAVE_STRTOF_L -D_GNU_SOURCE -DHAVE_LOCALE
+   STATIC_LINKING = 1
+   DEFINES += -std=c99
+	HAVE_VFS_FD = 0
+
+# PSP
+else ifeq ($(platform), psp1)
+   TARGET := $(TARGET_NAME)_libretro_$(platform).a
+   CC = psp-gcc$(EXE_EXT)
+   AR = psp-ar$(EXE_EXT)
+   PLATFORM_DEFINES := -DPSP -DCC_RESAMPLER -DHAVE_STRTOF_L
+   CFLAGS += -G0 -I$(shell psp-config --pspsdk-path)/include
+   STATIC_LINKING = 1
+   DEFINES += -std=c99
+	HAVE_VFS_FD = 0
+
+# Vita
+else ifeq ($(platform), vita)
+   TARGET := $(TARGET_NAME)_libretro_$(platform).a
+   CC = arm-vita-eabi-gcc$(EXE_EXT)
+   AR = arm-vita-eabi-ar$(EXE_EXT)
+   PLATFORM_DEFINES := -DVITA -DCC_RESAMPLER -DPSP2 -DHAVE_STRTOF_L
+   STATIC_LINKING = 1
+   DEFINES += -std=c99
+
+# CTR(3DS)
+else ifeq ($(platform), ctr)
+   TARGET := $(TARGET_NAME)_libretro_$(platform).a
+   CC = $(DEVKITARM)/bin/arm-none-eabi-gcc$(EXE_EXT)
+   AR = $(DEVKITARM)/bin/arm-none-eabi-ar$(EXE_EXT)
+   PLATFORM_DEFINES := -DARM11 -D_3DS -D__3DS__
+	 PLATFORM_DEFINES += -DHAVE_STRTOF_L -DHAVE_LOCALE -D_GNU_SOURCE
+
+   CFLAGS += -march=armv6k -mtune=mpcore -mfloat-abi=hard
+   CFLAGS += -Wall -mword-relocations
+   CFLAGS += -fomit-frame-pointer -ffast-math
+   CFLAGS += -I$(CTRULIB)/include
+   DEFINES += -std=c99
+
+   PLATFORM_DEFINES += -DENABLE_VFS_3DS
+   STATIC_LINKING = 1
+
+# Xbox 360
+else ifeq ($(platform), xenon)
+   TARGET := $(TARGET_NAME)_libretro_xenon360.a
+   CC = xenon-gcc$(EXE_EXT)
+   AR = xenon-ar$(EXE_EXT)
+   PLATFORM_DEFINES := -D__LIBXENON__
+   STATIC_LINKING = 1
+   DEFINES += -std=c99
+   HAVE_VFS_FD = 0
+
+# Nintendo Game Cube / Wii / WiiU
+else ifneq (,$(filter $(platform), ngc wii wiiu))
+   TARGET := $(TARGET_NAME)_libretro_$(platform).a
+   CC = $(DEVKITPPC)/bin/powerpc-eabi-gcc$(EXE_EXT)
+   AR = $(DEVKITPPC)/bin/powerpc-eabi-ar$(EXE_EXT)
+   PLATFORM_DEFINES += -DGEKKO -mcpu=750 -meabi -mhard-float -DHAVE_STRTOF_L
+   PLATFORM_DEFINES += -U__INT32_TYPE__ -U __UINT32_TYPE__ -D__INT32_TYPE__=int -D_GNU_SOURCE
+   STATIC_LINKING = 1
+   DEFINES += -std=c99
+   HAVE_VFS_FD = 0
+
+   # Nintendo WiiU
+   ifneq (,$(findstring wiiu,$(platform)))
+      PLATFORM_DEFINES += -DWIIU -DHW_RVL -mwup
+
+   # Nintendo Wii
+   else ifneq (,$(findstring wii,$(platform)))
+      PLATFORM_DEFINES += -DHW_RVL -mrvl
+
+   # Nintendo Game Cube
+   else ifneq (,$(findstring ngc,$(platform)))
+      PLATFORM_DEFINES += -DHW_DOL -mrvl
+   endif
+
+	PLATFORM_DEFINES += -DHAVE_LOCALE
+
+# Nintendo Switch (libnx)
+else ifeq ($(platform), libnx)
+	export DEPSDIR := $(CURDIR)/
+	TARGET := $(TARGET_NAME)_libretro_$(platform).a
+	include $(DEVKITPRO)/libnx/switch_rules
+	STATIC_LINKING=1
+	STATIC_LINKING_LINK=1
+	HAVE_VFS_FD = 0
+	CFLAGS += -O3 -fomit-frame-pointer -ffast-math -I$(LIBNX)/include/ -fPIE -Wl,--allow-multiple-definition -specs=$(LIBNX)/switch.specs
+	DEFINES += -std=gnu11
+	ASFLAGS += -DHAVE_LIBNX
+	PLATFORM_DEFINES += -D__SWITCH__ -DHAVE_LIBNX -DHAVE_LOCALE
+	PLATFORM_DEFINES += -march=armv8-a -mtune=cortex-a57 -mtp=soft -fPIE -mcpu=cortex-a57+crc+fp+simd -DHAVE_INTTYPES -DLSB_FIRST -DINLINE=inline
+
+# Nintendo Switch (libtransistor)
+else ifeq ($(platform), switch)
+   TARGET := $(TARGET_NAME)_libretro_$(platform).a
+   include $(LIBTRANSISTOR_HOME)/libtransistor.mk
+   STATIC_LINKING=1
+   STATIC_LINKING_LINK=1
+   HAVE_VFS_FD = 0
+   CFLAGS += -fomit-frame-pointer -ffast-math
+   DEFINES += -std=c99
+
+# Genode
+else ifeq ($(platform), genode)
+   TARGET  := $(TARGET_NAME)_libretro.lib.so
+   CC      := $(shell pkg-config genode-base --variable=cc)
+   LD      := $(shell pkg-config genode-base --variable=ld)
+   CFLAGS  += $(shell pkg-config --cflags genode-libc)
+   LDFLAGS += -shared --version-script=link.T
+   LDFLAGS += $(shell pkg-config --libs genode-lib genode-libc)
+   LIBS =
+
+# emscripten
+else ifeq ($(platform), emscripten)
+   TARGET := $(TARGET_NAME)_libretro_$(platform).bc
+   DEFINES += -std=gnu99 -DHAVE_LOCALE -D_GNU_SOURCE -DHAVE_STRTOF_L
+   STATIC_LINKING = 1
+
+# GCW0
+else ifeq ($(platform), gcw0)
+   TARGET := $(TARGET_NAME)_libretro.so
+   fpic := -fPIC
+   SHARED := -shared -Wl,-version-script=link.T
+   CC = /opt/gcw0-toolchain/usr/bin/mipsel-linux-gcc
+   AR = /opt/gcw0-toolchain/usr/bin/mipsel-linux-ar
+   PLATFORM_DEFINES += -D_GNU_SOURCE
+   CFLAGS += -fomit-frame-pointer -ffast-math -march=mips32 -mtune=mips32r2 -mhard-float
+   CFLAGS += -fno-common -ftree-vectorize -funswitch-loops
+   DEFINES += -std=c99
+
+# MIYOO
+else ifeq ($(platform), miyoo)
+   TARGET := $(TARGET_NAME)_libretro.so
+   fpic := -fPIC
+   SHARED := -shared -Wl,-version-script=link.T
+   CC = /opt/miyoo/usr/bin/arm-linux-gcc
+   AR = /opt/miyoo/usr/bin/arm-linux-ar
+   PLATFORM_DEFINES += -D_GNU_SOURCE
+   CFLAGS += -fomit-frame-pointer -ffast-math -march=armv5te -mtune=arm926ej-s
+   CFLAGS += -fno-common -ftree-vectorize -funswitch-loops
+   DEFINES += -std=c99
+
+# Windows
+else
+   TARGET := $(TARGET_NAME)_libretro.dll
+   CC ?= gcc
+   SHARED := -shared -static-libgcc -static-libstdc++ -Wl,-no-undefined -Wl,-version-script=link.T
+   DEFINES += -std=c99
+
+endif
+
+ifeq ($(DEBUG), 1)
+   CFLAGS += -O0 -g
+else
+   CFLAGS += -O3
+endif
+
+DEFINES += -DHAVE_STRNDUP -DHAVE_STRDUP -DDISABLE_THREADING -DMINIMAL_CORE=2
+
+include $(BUILD_DIR)/Makefile.common
+
+OBJS := $(SOURCES_C:.c=.o) $(SOURCES_ASM:.S=.o)
+
+DEFINES += $(PLATFORM_DEFINES) $(RETRODEFS)
+
+CFLAGS += $(CODE_DEFINES) $(fpic) $(DEFINES)
+
+%.o: %.c
+	$(CC) -c -o $@ $< $(CFLAGS) $(INCLUDES)
+%.o: %.S
+	$(CC) -c -o $@ $< $(CFLAGS) $(INCLUDES)
+
+
+ifeq ($(platform), theos_ios)
+COMMON_FLAGS := -DIOS $(COMMON_DEFINES) $(INCLUDES) -I$(THEOS_INCLUDE_PATH) -Wno-error
+$(LIBRARY_NAME)_CFLAGS += $(CFLAGS) $(COMMON_FLAGS)
+${LIBRARY_NAME}_FILES = $(SOURCES_C)
+include $(THEOS_MAKE_PATH)/library.mk
+else
+all: $(TARGET)
+
+ifneq ($(platform),genode)
+LD = $(CC)
+endif
+
+$(TARGET): $(OBJS)
+ifeq ($(STATIC_LINKING), 1)
+	$(AR) rcs $@ $(OBJS)
+else
+	$(LD) -o $@ $(SHARED) $(OBJS) $(LDFLAGS) $(LIBS)
+endif
+
+clean-objs:
+	rm -f $(OBJS)
+
+clean:
+	rm -f $(OBJS)
+	rm -f $(TARGET)
+
+install:
+	install -D -m 755 $(TARGET) $(DESTDIR)$(libdir)/$(LIBRETRO_DIR)/$(TARGET)
+
+uninstall:
+	rm $(DESTDIR)$(libdir)/$(LIBRETRO_DIR)/$(TARGET)
+
+.PHONY: clean clean-objs install uninstall
+endif
+
+endif

package/mgba-bridge/vendor/mgba/PORTING.md

@@ -0,0 +1,21 @@
+Porting
+=======
+
+Porting is preferentially done upstream so as to avoid fragmenting the codebase into individually unmergeable forks. As such, precaution must be taken to keep changes separate enough to not interfere with other ports, while still maintaining the ability to add new port-specific code seamlessly.
+
+Folders for each port should be under the `src/platform` folder, and make minimally invasive changes to the rest of the tree. If any changes are needed, try to make sure they are generic and have the ability to be ironed out in the future. For example, if a function doesn't work on a specific platform, maybe a way to make that function more portable should be added.
+
+The general porting process involves branching `master`, making the needed changes, and, when the port is mature enough to not have major effects to other ports, merged into `port/crucible`. The crucible is used for mixing upcoming ports to make sure they aren't fragile when `master` merges into it every so often. At this time, the crucible hasn't yet been merged into `master`, but in the future this may occur regularly. Until then, if a port is to get merged into master, make sure the changes to each port occur on the port-specific branch before being merged into `port/crucible`.
+
+Port-specific TODO
+------------------
+
+The following ports are considered incomplete and are thus on branches still. They may work, but should not be considered stable.
+
+### PSP (port/psp)
+* Add menu
+* Add audio
+* Thread support
+* Make it faster
+	* MIPS dynarec
+	* Hardware acceleration