Expanded docs on init and terminate.

This commit is contained in:
Camilla Berglund 2013-03-12 19:53:29 +01:00
parent 378c75d153
commit 23f6176fbf

View File

@ -727,6 +727,9 @@ typedef struct
* a program terminates GLFW should be terminated in order to free allocated * a program terminates GLFW should be terminated in order to free allocated
* resources, memory, etc. * resources, memory, etc.
* *
* If this function fails, it calls @ref glfwTerminate before returning. If it
* succeeds, you should call @ref glfwTerminate before the program exits.
*
* @return `GL_TRUE` if successful, or `GL_FALSE` if an error occurred. * @return `GL_TRUE` if successful, or `GL_FALSE` if an error occurred.
* @ingroup init * @ingroup init
* *
@ -752,14 +755,19 @@ GLFWAPI int glfwInit(void);
/*! @brief Terminates the GLFW library. /*! @brief Terminates the GLFW library.
* @ingroup init * @ingroup init
* *
* This function destroys all remaining windows, frees any allocated resources
* and sets the library to an uninitialized state. Once this is called, you
* must again call @ref glfwInit successfully before you will be able to use
* most GLFW functions.
*
* If GLFW has been successfully initialized, this function should be called
* before the program exits. If @ref glfwInit fails, there is no need to call
* this function, as it is called before @ref glfwInit returns failure.
*
* @remarks This function may be called before @ref glfwInit. * @remarks This function may be called before @ref glfwInit.
* *
* @note This function may only be called from the main thread. * @note This function may only be called from the main thread.
* *
* @note This function closes all GLFW windows.
*
* @note This function should be called before the program exits.
*
* @warning No window's context may be current on another thread when this * @warning No window's context may be current on another thread when this
* function is called. * function is called.
* *