Initial community commit

Src/external_dependencies/openmpt-trunk/libopenmpt/dox/tests.md

@@ -0,0 +1,44 @@
+
+Tests {#tests}
+=====
+
+
+libopenmpt provides some basic unit tests that check the platform for general
+sanity and do some basic internal functionality testing. The test suite
+requires a special libopenmpt build that includes file saving functionality
+which is not included in normal builds. This is handled by all provided build
+systems automatically.
+
+### Running Tests
+
+#### On Unix-like systems
+
+Compile with
+
+    make $YOURMAKEOPTIONS clean
+    make $YOURMAKEOPTIONS
+
+and run
+
+    make $YOURMAKEOPTIONS check
+
+As the build system retains no state between make invocations, you have to
+provide your make options on every make invocation.
+
+#### Autotools-based build system
+
+    ./configure
+    make check
+
+#### On Windows
+
+Using Visual Studio 20??, compile
+
+    build\vs20??\libopenmpt_test.sln
+
+and run
+
+    bin\$ARCH\libopenmpt_test.exe
+
+from the root of the source tree.
+