Added documentation for native API.

include/GL/glfw3native.h

@@ -35,6 +35,18 @@ extern "C" {
 #endif
 
 
+/*************************************************************************
+ * Doxygen documentation
+ *************************************************************************/
+
+/*! @defgroup native Native API
+ *
+ *  By using the native API, you assert that you know what you are doing and how
+ *  to fix problems caused by using it.  If you don't, you shouldn't be using
+ *  it.
+ */
+
+
 /*************************************************************************
  * System headers and types
  *************************************************************************/
@@ -71,19 +83,50 @@ extern "C" {
 
 #if defined(GLFW_EXPOSE_NATIVE_WIN32_WGL)
 
+/*! @brief Returns the @c HWND of the specified window.
+ *  @return The @c HWND of the specified window.
+ *  @ingroup native
+ */
 GLFWAPI HWND glfwGetWin32Window(GLFWwindow window);
+
+/*! @brief Returns the @c HGLRC of the specified window.
+ *  @return The @c HGLRC of the specified window.
+ *  @ingroup native
+ */
 GLFWAPI HGLRC glfwGetWGLContext(GLFWwindow window);
 
 #elif defined(GLFW_EXPOSE_NATIVE_COCOA_NSGL)
 
+/*! @brief Returns the @c NSWindow of the specified window.
+ *  @return The @c NSWindow of the specified window.
+ *  @ingroup native
+ */
 GLFWAPI id glfwGetCocoaWindow(GLFWwindow window);
+
+/*! @brief Returns the @c NSOpenGLContext of the specified window.
+ *  @return The @c NSOpenGLContext of the specified window.
+ *  @ingroup native
+ */
 GLFWAPI id glfwGetNSGLContext(GLFWwindow window);
 
 #elif defined(GLFW_EXPOSE_NATIVE_X11_GLX)
 
+/*! @brief Returns the @c Display used by GLFW.
+ *  @return The @c Display used by GLFW.
+ *  @ingroup native
+ */
 GLFWAPI Display* glfwGetX11Display(void);
 
+/*! @brief Returns the @c Window of the specified window.
+ *  @return The @c Window of the specified window.
+ *  @ingroup native
+ */
 GLFWAPI Window glfwGetX11Window(GLFWwindow window);
+
+/*! @brief Returns the @c GLXContext of the specified window.
+ *  @return The @c GLXContext of the specified window.
+ *  @ingroup native
+ */
 GLFWAPI GLXContext glfwGetGLXContext(GLFWwindow window);
 
 #endif