SDL/test
Simon McVittie 2dc788cb9f build: Expand version info in SDL_REVISION and SDL_GetRevision()
Instead of using a URL and git sha1, this uses `git describe` to
describe the version relative to the nearest previous git tag, which
gives a better indication of whether this is a release, a prerelease,
a slightly patched prerelease, or a long way after the last release
during active development.

This serves two purposes: it makes those APIs more informative, and it
also puts this information into the binary in a form that is easy to
screen-scrape using strings(1). For instance, if the bundled version of
SDL in a game has this, we can see at a glance what version it is.

It's also shorter than using the web address of the origin git
repository and the full git commit sha1.

Also write the computed version into a file ./VERSION in `make dist`
tarballs, so that when we build from a tarball on a system that doesn't
have git available, we still get the version details.

For the Perforce code path in showrev.sh, output the version number
followed by the Perforce revision, in a format reminiscent of
`git describe` (with p instead of g to indicate Perforce).

For the code path with no VCS available at all, put a suffix on the
version number to indicate that this is just a guess (we can't know
whether this SDL version is actually a git snapshot or has been
patched locally or similar).

Resolves: https://github.com/libsdl-org/SDL/issues/6418
Signed-off-by: Simon McVittie <smcv@collabora.com>
2022-10-22 09:27:10 -07:00
..
emscripten
n3ds N3DS port (squashed) 2022-10-10 08:50:59 -07:00
nacl
shapes
CMakeLists.txt N3DS port (squashed) 2022-10-10 08:50:59 -07:00
COPYING
Makefile.in
Makefile.os2 watcom: add ENABLE_WERROR option to makefiles 2022-10-08 23:41:07 +02:00
Makefile.w32 watcom: add ENABLE_WERROR option to makefiles 2022-10-08 23:41:07 +02:00
README
acinclude.m4
autogen.sh
axis.bmp
button.bmp
checkkeys.c
checkkeysthreads.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
configure build: Expand version info in SDL_REVISION and SDL_GetRevision() 2022-10-22 09:27:10 -07:00
configure.ac cmake: don't error on apple when using deprecated declarations 2022-10-08 23:41:07 +02:00
controllermap.bmp
controllermap.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
controllermap_back.bmp
icon.bmp
loopwave.c
loopwavequeue.c
moose.dat
picture.xbm
relative_mode.markdown
sample.bmp
sample.wav
template.test.in
testatomic.c
testaudiocapture.c
testaudiohotplug.c
testaudioinfo.c testaudioinfo: Initialize deviceName unconditionally 2022-09-29 11:36:07 -04:00
testautomation.c
testautomation_audio.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testautomation_clipboard.c Add support for X11 primary selection (#6132) 2022-09-14 09:28:35 -07:00
testautomation_events.c
testautomation_guid.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testautomation_hints.c SDL_ResetHint() no longer clears the callbacks associated with a hint 2022-10-02 17:17:31 -07:00
testautomation_joystick.c
testautomation_keyboard.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testautomation_main.c automation_main.c: fix -Wformat-zero-length warning due to SDL_SetError("") 2022-10-08 23:41:07 +02:00
testautomation_math.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testautomation_mouse.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testautomation_pixels.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testautomation_platform.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testautomation_rect.c
testautomation_render.c
testautomation_rwops.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testautomation_sdltest.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testautomation_stdlib.c testautomation: avoid format related warnings by using a few pragma's 2022-10-08 23:41:07 +02:00
testautomation_suites.h
testautomation_surface.c Fix SDL_PIXELFORMAT_INDEX1LSB test case 2022-09-17 13:18:32 -07:00
testautomation_syswm.c
testautomation_timer.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testautomation_video.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testbounds.c
testcustomcursor.c testcustomcursor: fix Wswitch warning by casting the arg to an int 2022-10-08 23:41:07 +02:00
testdisplayinfo.c
testdraw2.c
testdrawchessboard.c
testdropfile.c
testerror.c
testevdev.c testevdev: Explain why the test data is encoded the way it is 2022-10-12 19:20:40 +03:00
testfile.c
testfilesystem.c
testgamecontroller.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testgeometry.c testgeometry: fix conversion from 'double' to 'float', possible loss of data 2022-10-08 23:41:07 +02:00
testgesture.c
testgl2.c PSP: Fix `Wformat` warnings. 2022-10-10 22:31:16 -07:00
testgles.c
testgles2.c testgles2: Fix typo in help text 2022-08-16 20:38:55 -07:00
testgles2_sdf.c
testgles2_sdf_img_normal.bmp
testgles2_sdf_img_sdf.bmp
testhaptic.c testhaptic: fix watcom "&array may not produce intended result" warning 2022-10-09 12:01:02 +03:00
testhittesting.c
testhotplug.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testiconv.c tests: avoid MSVC preaching about unsafe functions 2022-10-08 23:41:07 +02:00
testime.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testintersections.c testintersections: fix conversion from `time_t` to `unsigned int` 2022-10-08 23:41:07 +02:00
testjoystick.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testkeys.c
testloadso.c
testlocale.c
testlock.c
testmessage.c testmessage: fix conversion from `intptr_t` to `Uint32` 2022-10-08 23:41:07 +02:00
testmouse.c testmouse: add explicit int-cast to avoid warning about converting `float` to `int` 2022-10-08 23:41:07 +02:00
testmultiaudio.c
testnative.c testnative: fix conversion from `time_t` to `unsigned int` 2022-10-08 23:41:07 +02:00
testnative.h
testnativecocoa.m
testnativeos2.c
testnativew32.c
testnativex11.c
testoffscreen.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testoverlay2.c
testplatform.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testpower.c
testqsort.c
testrelative.c
testrendercopyex.c
testrendertarget.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testresample.c
testrumble.c
testscale.c
testsem.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testsensor.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testshader.c
testshape.c
testsprite2.c
testspriteminimal.c testspriteminimal: fix conversion from `time_t` to `unsigned int` 2022-10-08 23:41:07 +02:00
teststreaming.c
testsurround.c
testthread.c
testtimer.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testurl.c
testutils.c
testutils.h
testver.c
testviewport.c
testvulkan.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testwm2.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testyuv.bmp
testyuv.c N3DS: Fix `-Wformat` warnings in tests. 2022-10-10 08:50:59 -07:00
testyuv_cvt.c
testyuv_cvt.h
torturethread.c
unifont-13.0.06-license.txt
unifont-13.0.06.hex
utf8.txt
watcom.mif tests, watcom: silence lots of W202 warnings from new vulkan headers. 2022-09-18 17:33:04 +03:00

README

These are test programs for the SDL library:

	checkkeys	Watch the key events to check the keyboard
	loopwave	Audio test -- loop playing a WAV file
	loopwavequeue	Audio test -- loop playing a WAV file with SDL_QueueAudio
	testsurround	Audio test -- play test tone on each audio channel
	testaudioinfo	Lists audio device capabilities
	testerror	Tests multi-threaded error handling
	testfile	Tests RWops layer
	testgl2		A very simple example of using OpenGL with SDL
	testiconv	Tests international string conversion
	testjoystick	List joysticks and watch joystick events
	testkeys	List the available keyboard keys
	testloadso	Tests the loadable library layer
	testlocale  Test Locale API
	testlock	Hacked up test of multi-threading and locking
	testmouse	Tests mouse coordinates
	testmultiaudio	Tests using several audio devices
	testoverlay2	Tests the overlay flickering/scaling during playback.
	testplatform	Tests types, endianness and cpu capabilities
	testsem		Tests SDL's semaphore implementation
	testshape	Tests shaped windows
	testsprite2	Example of fast sprite movement on the screen
	testthread	Hacked up test of multi-threading
	testtimer	Test the timer facilities
	testver		Check the version and dynamic loading and endianness
	testwm2		Test window manager -- title, icon, events
	torturethread	Simple test for thread creation/destruction
	controllermap   Useful to generate Game Controller API compatible maps



This directory contains sample.wav, which is a sample from Will Provost's
song, The Living Proof:

     From the album The Living Proof
     Publisher: 5 Guys Named Will
     Copyright 1996 Will Provost

You can get a copy of the full song (and album!) from iTunes...

    https://itunes.apple.com/us/album/the-living-proof/id4153978

or Amazon...

    http://www.amazon.com/The-Living-Proof-Will-Provost/dp/B00004R8RH

Thanks to Will for permitting us to distribute this sample with SDL!