From 0a2cb705fbed6853d8fe5a4b4bc0bba0b4265c06 Mon Sep 17 00:00:00 2001 From: icex2 Date: Sat, 10 Apr 2021 15:04:28 +0200 Subject: [PATCH] Overhaul root readme Provide a more user/developer-friendly entry point to the project --- README.md | 66 +++++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 57 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index bdbbf34..729c4e6 100644 --- a/README.md +++ b/README.md @@ -1,16 +1,64 @@ # Segatools -Quick start on a Linux build host: +Version: `v005` -``` -# Install Meson and a recent build of MinGW-w64, then: +Loaders and hardware emulators for SEGA games that run on the Nu and ALLS platforms. -$ meson --cross cross-mingw-32.txt _build32 -$ ninja -C _build32 -$ meson --cross cross-mingw-64.txt _build64 -$ ninja -C _build64 +## List of supported games + +* Chunithm + * [Chunithm (Plus)](doc/chunihook.md) + * [Chunithm Air (Plus)](doc/chunihook.md) + * [Chunithm Star (Plus)](doc/chunihook.md) + * [Chunithm Amazon (Plus)](doc/chunihook.md) + * [Chunithm Crystal (Plus)](doc/chunihook.md) +* Initial D + * Initial D Zero + +## End-users + +For setup and configuration guides, refer to the dedicated documents available for each game, see +[the links in the previous section](#list-of-supported-games). + +## Developers + +### Building + +The root `Makefile` contains various targets that allow you to build the project easily. + +#### Local build + +For a local build, you need to install Meson and a recent build of MinGW-w64. Then you can start the +build process: + +```shell +make build ``` -Building on MSYS2 is also possible; consult Meson documentation for details. +Build output will be located in `build/build32` and `build/build64` folders. -Additional documentation will be forthcoming. +#### Cleanup local build + +```shell +make clean +``` + +#### Create distribution package (zip file) + +```shell +make dist +``` + +The output will be located in `build/zip`. + +#### Build and create distribution package using docker + +You can also build using docker which avoids having to setup a full development environment if you +are just interested in building binaries of the latest changes. Naturally, this requires you to +have the docker daemon installed. + +```shell +make build-docker +``` + +Once completed successfully, the build output is located in the `build/docker/zip` sub-folder.