sdl12-compat: README: add some notes on building the library

From 4acc507783a545976ce9802e683786f6612df957 Mon Sep 17 00:00:00 2001
From: "Ryan C. Gordon" <[EMAIL REDACTED]>
Date: Fri, 25 Feb 2022 13:20:37 -0500
Subject: [PATCH] README: add some notes on building the library

--- | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/ b/
index 942bc94..afdfedd 100644
--- a/
+++ b/
@@ -35,6 +35,36 @@ new headers are also under the zlib license. Note that sdl12-compat itself
 does not use these headers, so if you just want the library, you don't need
+# Building the library:
+These are quick-start instructions; there isn't anything out of the ordinary
+here if you're used to using CMake. 
+You'll need to use CMake to build sdl12-compat. Download at
+[]( or install from your package manager
+(`sudo apt-get install cmake` on Ubuntu, etc).
+Please refer to the [CMake documentation](
+for complete details, as platform and build tool details vary.
+Now just point CMake at sdl12-compat's directory. Here's a command-line
+cd sdl12-compat
+cmake -Bbuild -DCMAKE_BUILD_TYPE=Release .
+cmake --build build
+On Windows or macOS, you might prefer to use CMake's GUI, but it's the same
+idea: give it the directory where sdl12-compat is located, click "Configure,"
+choose your favorite compiler, then click "Generate." Then you can build
+however you like with Visual Studio, Xcode, etc.
+When the build is complete, you'll have a shared library you can drop in
+as a replacement for an existing SDL 1.2 build. This will also build
+the original SDL 1.2 test apps, so you can verify the library is working.
 # Configuration options:
 sdl12-compat has a number of configuration options which can be used to work