include/SDL_loadso.h
branchSDL-1.3
changeset 1662 782fd950bd46
parent 1358 c71e05b4dc2e
child 1668 4da1ee79c9af
     1.1 --- a/include/SDL_loadso.h	Sun May 21 17:27:13 2006 +0000
     1.2 +++ b/include/SDL_loadso.h	Sun May 28 13:04:16 2006 +0000
     1.3 @@ -20,23 +20,24 @@
     1.4      slouken@libsdl.org
     1.5  */
     1.6  
     1.7 -/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
     1.8 -/* System dependent library loading routines                           */
     1.9 -
    1.10 -/* Some things to keep in mind:                                        
    1.11 -   - These functions only work on C function names.  Other languages may
    1.12 -     have name mangling and intrinsic language support that varies from
    1.13 -     compiler to compiler.
    1.14 -   - Make sure you declare your function pointers with the same calling
    1.15 -     convention as the actual library function.  Your code will crash
    1.16 -     mysteriously if you do not do this.
    1.17 -   - Avoid namespace collisions.  If you load a symbol from the library,
    1.18 -     it is not defined whether or not it goes into the global symbol
    1.19 -     namespace for the application.  If it does and it conflicts with
    1.20 -     symbols in your code or other shared libraries, you will not get
    1.21 -     the results you expect. :)
    1.22 -*/
    1.23 -
    1.24 +/**
    1.25 + * \file SDL_loadso.h
    1.26 + *
    1.27 + * System dependent library loading routines
    1.28 + *
    1.29 + * Some things to keep in mind:                                        
    1.30 + * - These functions only work on C function names.  Other languages may
    1.31 + *   have name mangling and intrinsic language support that varies from
    1.32 + *   compiler to compiler.
    1.33 + * - Make sure you declare your function pointers with the same calling
    1.34 + *   convention as the actual library function.  Your code will crash
    1.35 + *   mysteriously if you do not do this.
    1.36 + * - Avoid namespace collisions.  If you load a symbol from the library,
    1.37 + *   it is not defined whether or not it goes into the global symbol
    1.38 + *   namespace for the application.  If it does and it conflicts with
    1.39 + *   symbols in your code or other shared libraries, you will not get
    1.40 + *   the results you expect. :)
    1.41 + */
    1.42  
    1.43  #ifndef _SDL_loadso_h
    1.44  #define _SDL_loadso_h
    1.45 @@ -47,28 +48,35 @@
    1.46  #include "begin_code.h"
    1.47  /* Set up for C function definitions, even when using C++ */
    1.48  #ifdef __cplusplus
    1.49 +/* *INDENT-OFF* */
    1.50  extern "C" {
    1.51 +/* *INDENT-ON* */
    1.52  #endif
    1.53  
    1.54  /* This function dynamically loads a shared object and returns a pointer
    1.55   * to the object handle (or NULL if there was an error).
    1.56   * The 'sofile' parameter is a system dependent name of the object file.
    1.57   */
    1.58 -extern DECLSPEC void * SDLCALL SDL_LoadObject(const char *sofile);
    1.59 +extern DECLSPEC void *SDLCALL SDL_LoadObject (const char *sofile);
    1.60  
    1.61  /* Given an object handle, this function looks up the address of the
    1.62   * named function in the shared object and returns it.  This address
    1.63   * is no longer valid after calling SDL_UnloadObject().
    1.64   */
    1.65 -extern DECLSPEC void * SDLCALL SDL_LoadFunction(void *handle, const char *name);
    1.66 +extern DECLSPEC void *SDLCALL SDL_LoadFunction (void *handle,
    1.67 +                                                const char *name);
    1.68  
    1.69  /* Unload a shared object from memory */
    1.70 -extern DECLSPEC void SDLCALL SDL_UnloadObject(void *handle);
    1.71 +extern DECLSPEC void SDLCALL SDL_UnloadObject (void *handle);
    1.72  
    1.73  /* Ends C function definitions when using C++ */
    1.74  #ifdef __cplusplus
    1.75 +/* *INDENT-OFF* */
    1.76  }
    1.77 +/* *INDENT-ON* */
    1.78  #endif
    1.79  #include "close_code.h"
    1.80  
    1.81  #endif /* _SDL_loadso_h */
    1.82 +
    1.83 +/* vi: set ts=4 sw=4 expandtab: */