README
author Sam Lantinga <slouken@libsdl.org>
Sat, 12 Feb 2005 18:03:54 +0000
changeset 1036 50f4e7e4d117
parent 702 61b7f5eed0e8
child 1276 ca3718c215af
permissions -rw-r--r--
[SDL] [PATCH] fix FB_VideoQuit for ia64
Jesse Barnes
Fri Jan 14 11:13:54 PST 2005

I noticed that on my ia64 machine when SDL_Quit was called, the machine would
hang in weird ways. It turned out to be caused by a machine check in the
memset() call near the top of FB_VideoQuit. Generally memset shouldn't be
used on I/O regions like the framebuffer or other I/O device memory (the
Linux kernel has special routines for dealing with I/O memory), so I changed
the #ifdef __powerpc__ to #if defined(__powerpc__) || defined(__ia64__) and
SDL_Quit now works properly. The change should probably be made
unconditional though since doing one byte at a time is the only way to be
portable, afaik.
slouken@0
     1
slouken@0
     2
                         Simple DirectMedia Layer
slouken@0
     3
slouken@0
     4
                                  (SDL)
slouken@0
     5
slouken@0
     6
                                Version 1.2
slouken@0
     7
slouken@0
     8
---
slouken@0
     9
http://www.libsdl.org/
slouken@0
    10
slouken@602
    11
This is the Simple DirectMedia Layer, a general API that provides low
slouken@0
    12
level access to audio, keyboard, mouse, joystick, 3D hardware via OpenGL,
slouken@0
    13
and 2D framebuffer across multiple platforms.
slouken@0
    14
slouken@0
    15
SDL is written in C, but works with C++ natively, and has bindings to
slouken@579
    16
several other languages, including Ada, C#, Eiffel, Java, Lua, ML,
slouken@579
    17
Objective C, Perl, PHP, Pike, Python, and Ruby.
slouken@0
    18
slouken@0
    19
The current version supports Linux, Windows, BeOS, MacOS, MacOS X,
slouken@702
    20
FreeBSD, OpenBSD, BSD/OS, Solaris, IRIX, and QNX.  The code contains
slouken@702
    21
support for Windows CE, AmigaOS, Dreamcast, Atari, NetBSD, AIX, OSF/Tru64,
slouken@630
    22
RISC OS, and SymbianOS, but these are not officially supported.
slouken@0
    23
slouken@0
    24
This library is distributed under GNU LGPL version 2, which can be
slouken@0
    25
found in the file  "COPYING".  This license allows you to use SDL
slouken@0
    26
freely in commercial programs as long as you link with the dynamic
slouken@0
    27
library.
slouken@0
    28
slouken@0
    29
The best way to learn how to use SDL is to check out the header files in
slouken@0
    30
the "include" subdirectory and the programs in the "test" subdirectory.
slouken@0
    31
The header files and test programs are well commented and always up to date.
slouken@0
    32
More documentation is available in HTML format in "./docs/index.html"
slouken@0
    33
slouken@0
    34
The test programs in the "test" subdirectory are in the public domain.
slouken@0
    35
slouken@0
    36
Frequently asked questions are answered online:
slouken@369
    37
	http://www.libsdl.org/faq.php
slouken@0
    38
slouken@0
    39
If you need help with the library, or just want to discuss SDL related
slouken@0
    40
issues, you can join the developers mailing list:
slouken@369
    41
	http://www.libsdl.org/mailing-list.php
slouken@0
    42
slouken@0
    43
Enjoy!
slouken@0
    44
	Sam Lantinga				(slouken@libsdl.org)
slouken@0
    45