doxygen comments and config file

[xonotic/darkplaces.git] / sys.h

diff --git a/sys.h b/sys.h
index f42d2771efccf80cbc6b1c7ca80d7b185df822c4..aa99f79bb5cc4da732f7d8297e5b668a8f06b1d0 100644 (file)
--- a/sys.h
+++ b/sys.h
@@ -37,48 +37,63 @@ typedef HMODULE dllhandle_t;
   typedef void* dllhandle_t;
 #endif
 
-typedef struct
+typedef struct dllfunction_s
 {
        const char *name;
        void **funcvariable;
 }
 dllfunction_t;
 
-dllhandle_t Sys_LoadLibrary (const char* name);
-void Sys_UnloadLibrary (dllhandle_t handle);
+/*! Loads a library. 
+ * \param dllnames a NULL terminated array of possible names for the DLL you want to load.
+ * \param handle
+ * \param fcts
+ */
+qboolean Sys_LoadLibrary (const char** dllnames, dllhandle_t* handle, const dllfunction_t *fcts);
+void Sys_UnloadLibrary (dllhandle_t* handle);
 void* Sys_GetProcAddress (dllhandle_t handle, const char* name);
 
+/// called early in Host_Init
+void Sys_InitConsole (void);
+/// called after command system is initialized but before first Con_Print
+void Sys_Init_Commands (void);
+
+
+/// \returns current timestamp
+char *Sys_TimeString(const char *timeformat);
 
 //
-// system IO
+// system IO interface (these are the sys functions that need to be implemented in a new driver atm)
 //
-void Sys_Error (const char *error, ...);
-// an error will cause the entire program to exit
 
-void Sys_Print(const char *msg);
-void Sys_Printf(const char *fmt, ...);
-// send text to the quake console (and possibly to terminal)
+/// an error will cause the entire program to exit
+void Sys_Error (const char *error, ...) DP_FUNC_PRINTF(1);
 
+/// (may) output text to terminal which launched program
 void Sys_PrintToTerminal(const char *text);
-// (may) output text to terminal which launched program
 
-void Sys_Quit (void);
+/// INFO: This is only called by Host_Shutdown so we dont need testing for recursion
+void Sys_Shutdown (void);
+void Sys_Quit (int returnvalue);
+
+/*! on some build/platform combinations (such as Linux gcc with the -pg
+ * profiling option) this can turn on/off profiling, used primarily to limit
+ * profiling to certain areas of the code, such as ingame performance without
+ * regard for loading/shutdown performance (-profilegameonly on commandline)
+ */
+void Sys_AllowProfiling (qboolean enable);
 
 double Sys_DoubleTime (void);
 
 char *Sys_ConsoleInput (void);
 
-void Sys_Sleep(int milliseconds);
-// called to yield for a little bit so as
-// not to hog cpu when paused or debugging
+/// called to yield for a little bit so as not to hog cpu when paused or debugging
+void Sys_Sleep(int microseconds);
 
+/// Perform Key_Event () callbacks until the input que is empty
 void Sys_SendKeyEvents (void);
-// Perform Key_Event () callbacks until the input que is empty
 
-// called after Com_InitArgv
-void Sys_Shared_EarlyInit (void);
-// called after Host_init
-void Sys_Shared_LateInit (void);
+char *Sys_GetClipboardData (void);
 
 #endif