INSTALL.txt
author Ryan C. Gordon <icculus@icculus.org>
Thu, 28 May 2015 01:54:52 -0400
changeset 9671 0e1f57b051f4
parent 9025 d09d4b578e77
child 10893 54480745c410
permissions -rw-r--r--
Windows GetBasePath should use GetModuleFileNameExW() and check for overflows.

Apparently you might get strange paths from GetModuleFileName(), such as
short path names or UNC filenames, so this avoids that problem. Since you have
to tapdance with linking different libraries and defining macros depending on
what Windows you plan to target, we dynamically load the API we need, which
works on all versions of Windows (on Win7, it'll load a compatibility wrapper
for the newer API location).

What a mess.

This also now does the right thing if there isn't enough space to store the
path, looping with a larger allocated buffer each try.

Fixes Bugzilla #2435.
     1 
     2 To compile and install SDL:
     3 
     4     1.  Windows with Visual Studio:
     5         * Read VisualC.html
     6 
     7         Windows with gcc, either native or cross-compiling:
     8         * Read the FAQ at http://wiki.libsdl.org/moin.fcg/FAQWindows
     9         * Run './configure; make; make install'
    10 
    11         Mac OS X with Xcode:
    12         * Read docs/README-macosx.md
    13 
    14         Mac OS X from the command line:
    15         * Run './configure; make; make install'
    16 
    17         Linux and other UNIX systems:
    18         * Run './configure; make; make install'
    19 
    20         Android:
    21         * Read docs/README-android.md
    22 
    23         iOS:
    24         * Read docs/README-ios.md
    25 
    26         Using Cmake:
    27         * Read docs/README-cmake.md
    28 
    29     2.  Look at the example programs in ./test, and check out the online
    30         documentation at http://wiki.libsdl.org/
    31 
    32     3.  Join the SDL developer mailing list by sending E-mail to
    33     	sdl-request@libsdl.org
    34         and put "subscribe" in the subject of the message.
    35 
    36         Or alternatively you can use the web interface:
    37             http://www.libsdl.org/mailing-list.php
    38 
    39 That's it!
    40 Sam Lantinga <slouken@libsdl.org>