aboutsummaryrefslogtreecommitdiffhomepage
path: root/INSTALL.md
diff options
context:
space:
mode:
authorMatthew Gregan <[email protected]>2016-09-22 01:40:55 +1200
committerMatthew Gregan <[email protected]>2016-10-12 17:06:10 +1300
commit0aea9e0438cabfe6703d587547c3a74e11380489 (patch)
treee676269f45f44b69176207df0e1c918fcac119b1 /INSTALL.md
parent22557d466eceb6ff6ba70ae30d2dcd87648cde0b (diff)
downloadcubeb-0aea9e0438cabfe6703d587547c3a74e11380489.tar.gz
cubeb-0aea9e0438cabfe6703d587547c3a74e11380489.zip
Replace autotools build system with CMake.
Diffstat (limited to 'INSTALL.md')
-rw-r--r--INSTALL.md54
1 files changed, 21 insertions, 33 deletions
diff --git a/INSTALL.md b/INSTALL.md
index 83d66a9..eacb5fc 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -1,36 +1,24 @@
# Build instructions for libcubeb
-Note Also:Cubeb does not currently build under Cygwin, but this is being worked on.
-
-0. Change directory into the source directory.
-1. Run |autoreconf --install| to generate configure.
-2. Run |./configure| to configure the build.
-3. Run |make| to build.
-4. Run |make check| to run the test suite.
-
-# Debugging
-
-Debugging tests can be done like so:
-
-```libtool --mode=execute gdb test/test_tone```
-
-# Windows build prerequisite, using `msys2`
-
-Cubeb for Windows uses win32 threads
-
-- Download and install `msys2` 32-bits from <https://msys2.github.io>. Let it
- install in `C:\msys32`.
-- Download and install `7z` from <http://www.7-zip.org/>.
-- Run `msys2` (a shortcut has been added to the start menu, or use the `.bat`
- script: `C:\msys32\mingw32_shell.bat`), and issue the following commands to
- install the dependencies:
-```
-pacman -S git automake autoconf libtool m4 make pkg-config gdb
-```
-- Download a `mingw` compiler with the WIN32 thread model [here](http://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win32/Personal%20Builds/mingw-builds/4.9.2/threads-win32/sjlj/i686-4.9.2-release-win32-sjlj-rt_v3-rev0.7z/download). `msys2` does not have `mingw` builds with win32 threads,
-so we have to install another compiler.
-- Unzip the compiler, and copy all folders in `C:\msys32\opt`
-- Exit the `msys2` shell, and run `C:\msys32\autorebase.bat` (double clicking
- works).
-- Open an `msys2` shell and follow the build instructions.
+You must have CMake v3.1 or later installed.
+
+1. `git clone https://github.com/kinetiknz/cubeb.git`
+2. `mkdir cubeb-build`
+3. `cd cubeb-build`
+3. `cmake ../cubeb`
+4. `cmake --build .`
+5. `ctest`
+
+# Windows build notes
+
+Windows builds can use Microsoft Visual Studio 2015 (the default) or MinGW-w64
+with Win32 threads (by passing `cmake -G` to generate the appropriate build
+configuration). To build with MinGW-w64, install the following items:
+
+- Download and install MinGW-w64 with Win32 threads.
+- Download and install CMake.
+- Run MinGW-w64 Terminal from the Start Menu.
+- Follow the build steps above, but at step 3 run:
+ `cmake -G "MinGW Makefiles" ..`
+- Continue the build steps above.