include/SDL_thread.h
changeset 7191 75360622e65f
parent 6885 700f1b25f77f
child 7391 a29895dc5e9a
     1.1 --- a/include/SDL_thread.h	Sat May 18 12:48:50 2013 -0700
     1.2 +++ b/include/SDL_thread.h	Sat May 18 14:17:52 2013 -0700
     1.3 @@ -24,7 +24,7 @@
     1.4  
     1.5  /**
     1.6   *  \file SDL_thread.h
     1.7 - *  
     1.8 + *
     1.9   *  Header for the SDL thread management routines.
    1.10   */
    1.11  
    1.12 @@ -37,9 +37,7 @@
    1.13  #include "begin_code.h"
    1.14  /* Set up for C function definitions, even when using C++ */
    1.15  #ifdef __cplusplus
    1.16 -/* *INDENT-OFF* */
    1.17  extern "C" {
    1.18 -/* *INDENT-ON* */
    1.19  #endif
    1.20  
    1.21  /* The SDL thread structure, defined in SDL_thread.c */
    1.22 @@ -67,22 +65,22 @@
    1.23  #if defined(__WIN32__) && !defined(HAVE_LIBC)
    1.24  /**
    1.25   *  \file SDL_thread.h
    1.26 - *  
    1.27 + *
    1.28   *  We compile SDL into a DLL. This means, that it's the DLL which
    1.29   *  creates a new thread for the calling process with the SDL_CreateThread()
    1.30   *  API. There is a problem with this, that only the RTL of the SDL.DLL will
    1.31 - *  be initialized for those threads, and not the RTL of the calling 
    1.32 + *  be initialized for those threads, and not the RTL of the calling
    1.33   *  application!
    1.34 - *  
    1.35 + *
    1.36   *  To solve this, we make a little hack here.
    1.37 - *  
    1.38 + *
    1.39   *  We'll always use the caller's _beginthread() and _endthread() APIs to
    1.40   *  start a new thread. This way, if it's the SDL.DLL which uses this API,
    1.41   *  then the RTL of SDL.DLL will be used to create the new thread, and if it's
    1.42   *  the application, then the RTL of the application will be used.
    1.43 - *  
    1.44 + *
    1.45   *  So, in short:
    1.46 - *  Always use the _beginthread() and _endthread() of the calling runtime 
    1.47 + *  Always use the _beginthread() and _endthread() of the calling runtime
    1.48   *  library!
    1.49   */
    1.50  #define SDL_PASSED_BEGINTHREAD_ENDTHREAD
    1.51 @@ -150,7 +148,7 @@
    1.52  
    1.53  /**
    1.54   *  Get the thread identifier for the specified thread.
    1.55 - *  
    1.56 + *
    1.57   *  Equivalent to SDL_ThreadID() if the specified thread is NULL.
    1.58   */
    1.59  extern DECLSPEC SDL_threadID SDLCALL SDL_GetThreadID(SDL_Thread * thread);
    1.60 @@ -162,7 +160,7 @@
    1.61  
    1.62  /**
    1.63   *  Wait for a thread to finish.
    1.64 - *  
    1.65 + *
    1.66   *  The return code for the thread function is placed in the area
    1.67   *  pointed to by \c status, if \c status is not NULL.
    1.68   */
    1.69 @@ -171,9 +169,7 @@
    1.70  
    1.71  /* Ends C function definitions when using C++ */
    1.72  #ifdef __cplusplus
    1.73 -/* *INDENT-OFF* */
    1.74  }
    1.75 -/* *INDENT-ON* */
    1.76  #endif
    1.77  #include "close_code.h"
    1.78