Skip to content

Commit

Permalink
update documents for 1.2.16 changes so far.
Browse files Browse the repository at this point in the history
  • Loading branch information
@sezero
sezero committed Aug 3, 2019
1 parent 762dbb3 commit 11cb97b
Show file tree
Hide file tree
Showing 2 changed files with 308 additions and 0 deletions.
93 changes: 93 additions & 0 deletions WhatsNew
View file
Expand Up @@ -3,6 +3,99 @@ This is a list of API changes in SDL's version history.

Version 1.0:

1.2.16: This is mostly multiple bug fixes since the previous version.
Changes include:
- Audio, wav loader: security fixes for ADPCM decoding (CVE-2019-7572,
CVE-2019-7573, CVE-2019-7574, CVE-2019-7575, CVE-2019-7576,
CVE-2019-7577, CVE-2019-7578 -- bugs 4490, 4491, 4492, 4493, 4494,
4495, 4496, and 4522.)
- Video, bmp loader: security fixes for CVE-2019-7635, CVE-2019-7636,
CVE-2019-7637, CVE-2019-7638, CVE-2019-13616 (bugs 4498, 4499, 4500,
4517, and 4538.)
- Video, blit: fix handling of alpha channel in Altivec accelerated
blit functions (bug 1424.)
- Video, blit: use fast path for RGB 565 -> 32-bit XRGB 8888
- Video, blit: fix RGBA<->RGBA blit broken with the optimization from
bug 11 (bug 2976.)
- Mouse: fix SDL_ResetMouse() using a bogus mouse button causing a
negative shift (bug 3593.)
- Cdrom: fix SDL_CDResume() and SDL_CDStop() not returning failure
when they should (bug 4108.)
- Unix, pthread: Fix SDL_SemWaitTimeout() returning -1 instead of
SDL_MUTEX_TIMEDOUT upon timeout (bug 1426.)
- NetBSD: wscons support.
- NetBSD, audio: use AUDIO_GETBUFINFO when available.
- OpenBSD, audio: add sndio support.
- Haiku/BeOS, audio: fix error in buffer size setting (bug 1679.)
- OpenBSD: fix dynamic loading of X libs (bug 1434.)
- X11video: fix missing symbol X11_KeyToUnicode in .so file (bug 1390.
not being an official SDL function, the use of X11_KeyToUnicode() is
discouraged.)
- X11video: fix compilation with libX11 >= 1.5.99.902 (bug 1769.)
- X11video: fix for XChangeProperty() crash (bug 1427.)
- X11video: fix SDL_EnableUNICODE sometimes dropping keyboard events
completely (bug 2325.)
- X11video: fixed no SDL_VIDEORESIZE event being generated when the
window manager sets the window size (bug 1859.)
- X11video: fix X11_SetGammaRamp not checking the return value of
XStoreColors (bugs 1979, 3770.)
- X11video: fix SDL_VIDEORESIZE events not received when resizing
window from the corner (inverted logic in X11 ConfigureNotify, i.e.
resize handling - bug 1430.)
- X11video: unblock SDL_WM_GrabInput() GrabNotViewable case (bug 1155.)
- Mac OS X: fixed crash on any input in Quartz code (bug 2560.)
- Mac OS X: fixed crash in Quartz gamma ramp code.
- Mac OS X: fixed build for 10.9 Mavericks or newer (bug 2085.)
- Mac OS X, joystick: update to support Saitek p2500 gamepad (bug 2025)
- Mac OS X, main: updates for -psn_XXX command line arg for Finder
launches in new macOS versions.
- Mac OS X, main: replace deprecated CPS apis in new OSX versions
(bug 4114.)
- Windows, video: fix other window positions/sizes when exiting
fullscreen (bug 3315.)
- Windows, keyboard: reset deadkeys upon SDL_EnableUNICODE() or upon
quit (bug 3332.)
- Windows: Visual Studio project file updates.
- OS/2: Watcom makefile updates.
- FreeBSD, joystick: compile fixes.
- BSD, joystick: increase the number of uhid devices to scan (bug 1561)
- Linux, evdev: ignore joystick axis events if they aren't in a sane
range.
- Linux, joystick: fix Dualshock 3's motion sensors overwrite analog
stick: protect against any axis that isn't reported by EVIOCGBIT but
still sending EV_ABS events (bug 3193.)
- FreeBSD, cdrom: fix CDROM detection misbehaviour for 7.x and newer
(bug 1529.)
- Solaris, audio: fix pulseaudio dynamic linking.
- Solaris, cpuinfo: fix asm syntax error causing build failures.
- Atari: multiple platform code updates.
- RiscOS: cleanups to platform code.
- RiscOS: fix thread starvation in fullscreen mode.
- RiscOS: fix returning from full-screen to 16M colour modes.
- RiscOS: fix receiving PreQuit messages.
- RiscOS: ensure the window size is consistent at different DPIs.
- RiscOS, video: add support for more pixel formats.
- RiscOS: mouse fixes. restore mouse palette when exiting while mouse
is in focus. don't reset mouse focus when recreating the window.
- RiscOS: support Windows and Menu key input.
- Configuration: fix library detection selecting wrong lib (bug 2795.)
- Configuration: fix detecting dynamic library support on powerpc64le
(bug 3481.)
- SDL error: string formatting fixes to deal with nasty corner cases
(bug 2049.)
- SDL_error: handle %lu, %li and %ld in format string (bug 3739.)
- stdlib: updated SDL_qsort() code.
- stdlib: use _strtoi64() and _strtoui64() when available for windows.
- headers, close_code.h: fix unbalanced #pragma pack(pop) for watcom
builds (bug 3781.)
- headers, begin_code.h, close_code.h: updates to SDLCALL and DECLSPEC
macros for OS/2.
- headers, endian: add Watcom inline asm for SDL_Swap16 and SDL_Swap32
- headers, config: updates to default windows and os2 config files.
- headers, SDL_syswm.h, SDL_stdinc.h: include system headers before
packing alignment changes (bug 4149.)


1.2.15: This is a minor bug fix release:

General Notes:
Expand Down
215 changes: 215 additions & 0 deletions docs.html
View file
Expand Up @@ -16,6 +16,221 @@ <H2> <A HREF="docs/index.html">API Documentation</A> </H2>

<IMG SRC="docs/images/rainbow.gif" ALT="[separator]" WIDTH="100%">

<H2> SDL 1.2.16 Release Notes </H2>
<P>
SDL 1.2.16 is mostly multiple bug fixes since the previous version.
Changes include:
</P>
<BLOCKQUOTE>
<P>
Audio, wav loader: security fixes for ADPCM decoding (CVE-2019-7572,
CVE-2019-7573, CVE-2019-7574, CVE-2019-7575, CVE-2019-7576,
CVE-2019-7577, CVE-2019-7578 -- bugs <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4490">4490</a>, <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4491">4491</a>, <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4492">4492</a>, <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4493">4493</a>, <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4494">4494</a>,
<a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4495">4495</a>, <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4496">4496</a>, and <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4522">4522</a>.)
</P>
<P>
Video, bmp loader: security fixes for CVE-2019-7635, CVE-2019-7636,
CVE-2019-7637, CVE-2019-7638, CVE-2019-13616 (bugs <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4498">4498</a>, <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4499">4499</a>, <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4500">4500</a>,
<a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4517">4517</a>, and <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4538">4538</a>.)
</P>
<P>
Video, blit: fix handling of alpha channel in Altivec accelerated
blit functions (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1424">1424</a>.)
</P>
<P>
Video, blit: use fast path for RGB 565 -> 32-bit XRGB 8888
</P>
<P>
Video, blit: fix RGBA<->RGBA blit broken with the optimization from
<a href="https://bugzilla.libsdl.org/show_bug.cgi?id=11">bug 11</a> (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=2976">2976</a>.)
</P>
<P>
Mouse: fix SDL_ResetMouse() using a bogus mouse button causing a
negative shift (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=3593">3593</a>.)
</P>
<P>
Cdrom: fix SDL_CDResume() and SDL_CDStop() not returning failure
when they should (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4108">4108</a>.)
</P>
<P>
Unix, pthread: Fix SDL_SemWaitTimeout() returning -1 instead of
SDL_MUTEX_TIMEDOUT upon timeout (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1426">1426</a>.)
</P>
<P>
NetBSD: wscons support.
</P>
<P>
NetBSD, audio: use AUDIO_GETBUFINFO when available.
</P>
<P>
OpenBSD, audio: add sndio support.
</P>
<P>
Haiku/BeOS, audio: fix error in buffer size setting (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1679">1679</a>.)
</P>
<P>
OpenBSD: fix dynamic loading of X libs (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1434">1434</a>.)
</P>
<P>
X11video: fix missing symbol X11_KeyToUnicode in .so file (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1390">1390</a>.
not being an official SDL function, the use of X11_KeyToUnicode() is
discouraged.)
</P>
<P>
X11video: fix compilation with libX11 >= 1.5.99.902 (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1769">1769</a>.)
</P>
<P>
X11video: fix for XChangeProperty() crash (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1427">1427</a>.)
</P>
<P>
X11video: fix SDL_EnableUNICODE sometimes dropping keyboard events
completely (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=2325">2325</a>.)
</P>
<P>
X11video: fixed no SDL_VIDEORESIZE event being generated when the
window manager sets the window size (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1859">1859</a>.)
</P>
<P>
X11video: fix X11_SetGammaRamp not checking the return value of
XStoreColors (bugs <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1979">1979</a>, <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=3770">3770</a>.)
</P>
<P>
X11video: fix SDL_VIDEORESIZE events not received when resizing
window from the corner (inverted logic in X11 ConfigureNotify, i.e.
resize handling - bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1430">1430</a>.)
</P>
<P>
X11video: unblock SDL_WM_GrabInput() GrabNotViewable case (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1155">1155</a>.)
</P>
<P>
Mac OS X: fixed crash on any input in Quartz code (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=2560">2560</a>.)
</P>
<P>
Mac OS X: fixed crash in Quartz gamma ramp code.
</P>
<P>
Mac OS X: fixed build for 10.9 Mavericks or newer (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=2085">2085</a>.)
</P>
<P>
Mac OS X, joystick: update to support Saitek p2500 gamepad (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=2025">2025</a>)
</P>
<P>
Mac OS X, main: updates for -psn_XXX command line arg for Finder
launches in new macOS versions.
</P>
<P>
Mac OS X, main: replace deprecated CPS apis in new OSX versions
(bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4114">4114</a>.)
</P>
<P>
Windows, video: fix other window positions/sizes when exiting
fullscreen (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=3315">3315</a>.)
</P>
<P>
Windows, keyboard: reset deadkeys upon SDL_EnableUNICODE() or upon
quit (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=3332">3332</a>.)
</P>
<P>
Windows: Visual Studio project file updates.
</P>
<P>
OS/2: Watcom makefile updates.
</P>
<P>
FreeBSD, joystick: compile fixes.
</P>
<P>
BSD, joystick: increase the number of uhid devices to scan (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1561">1561</a>)
</P>
<P>
Linux, evdev: ignore joystick axis events if they aren't in a sane
range.
</P>
<P>
Linux, joystick: fix Dualshock 3's motion sensors overwrite analog
stick: protect against any axis that isn't reported by EVIOCGBIT but
still sending EV_ABS events (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=3193">3193</a>.)
</P>
<P>
FreeBSD, cdrom: fix CDROM detection misbehaviour for 7.x and newer
(bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=1529">1529</a>.)
</P>
<P>
Solaris, audio: fix pulseaudio dynamic linking.
</P>
<P>
Solaris, cpuinfo: fix asm syntax error causing build failures.
</P>
<P>
Atari: multiple platform code updates.
</P>
<P>
RiscOS: cleanups to platform code.
</P>
<P>
RiscOS: fix thread starvation in fullscreen mode.
</P>
<P>
RiscOS: fix returning from full-screen to 16M colour modes.
</P>
<P>
RiscOS: fix receiving PreQuit messages.
</P>
<P>
RiscOS: ensure the window size is consistent at different DPIs.
</P>
<P>
RiscOS, video: add support for more pixel formats.
</P>
<P>
RiscOS: mouse fixes. restore mouse palette when exiting while mouse
is in focus. don't reset mouse focus when recreating the window.
</P>
<P>
RiscOS: support Windows and Menu key input.
</P>
<P>
Configuration: fix library detection selecting wrong lib (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=2795">2795</a>.)
</P>
<P>
Configuration: fix detecting dynamic library support on powerpc64le
(bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=3481">3481</a>.)
</P>
<P>
SDL error: string formatting fixes to deal with nasty corner cases
(bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=2049">2049</a>.)
</P>
<P>
SDL_error: handle %lu, %li and %ld in format string (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=3739">3739</a>.)
</P>
<P>
stdlib: updated SDL_qsort() code.
</P>
<P>
stdlib: use _strtoi64() and _strtoui64() when available for windows.
</P>
<P>
headers, close_code.h: fix unbalanced #pragma pack(pop) for watcom
builds (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=3781">3781</a>.)
</P>
<P>
headers, begin_code.h, close_code.h: updates to SDLCALL and DECLSPEC
macros for OS/2.
</P>
<P>
headers, endian: add Watcom inline asm for SDL_Swap16 and SDL_Swap32
</P>
<P>
headers, config: updates to default windows and os2 config files.
</P>
<P>
headers, SDL_syswm.h, SDL_stdinc.h: include system headers before
packing alignment changes (bug <a href="https://bugzilla.libsdl.org/show_bug.cgi?id=4149">4149</a>.)
</P>
</BLOCKQUOTE>

<IMG SRC="docs/images/rainbow.gif" ALT="[separator]" WIDTH="100%">

<H2> SDL 1.2.15 Release Notes </H2>
<P>
SDL 1.2.15 is a minor bug fix release.
Expand Down

0 comments on commit 11cb97b

Please sign in to comment.