Documentation formatting.

This commit is contained in:
Camilla Berglund 2013-01-24 20:56:30 +01:00
parent 7c1932381b
commit 984539cbd4

View File

@ -633,7 +633,7 @@ typedef void (* GLFWwindowiconifyfun)(GLFWwindow*,int);
* @param[in] window The window that received the event. * @param[in] window The window that received the event.
* @param[in] button The @link buttons mouse button @endlink that was pressed * @param[in] button The @link buttons mouse button @endlink that was pressed
* or released. * or released.
* @param[in] action One of @ref GLFW_PRESS or @ref GLFW_RELEASE. * @param[in] action One of @c GLFW_PRESS or @c GLFW_RELEASE.
* @ingroup input * @ingroup input
* *
* @sa glfwSetMouseButtonCallback * @sa glfwSetMouseButtonCallback
@ -674,7 +674,7 @@ typedef void (* GLFWscrollfun)(GLFWwindow*,double,double);
* @param[in] window The window that received the event. * @param[in] window The window that received the event.
* @param[in] key The @link keys keyboard key @endlink that was pressed or * @param[in] key The @link keys keyboard key @endlink that was pressed or
* released. * released.
* @param[in] action One of @ref GLFW_PRESS or @ref GLFW_RELEASE. * @param[in] action One of @c GLFW_PRESS or @c GLFW_RELEASE.
* @ingroup input * @ingroup input
* *
* @sa glfwSetKeyCallback * @sa glfwSetKeyCallback
@ -692,7 +692,7 @@ typedef void (* GLFWcharfun)(GLFWwindow*,int);
/*! @brief The function signature for monitor configuration callbacks. /*! @brief The function signature for monitor configuration callbacks.
* @param[in] monitor The monitor that was connected or disconnected. * @param[in] monitor The monitor that was connected or disconnected.
* @param[in] event One of @ref GLFW_CONNECTED or @ref GLFW_DISCONNECTED. * @param[in] event One of @c GLFW_CONNECTED or @c GLFW_DISCONNECTED.
* @ingroup monitor * @ingroup monitor
* *
* @sa glfwSetMonitorCallback * @sa glfwSetMonitorCallback
@ -907,21 +907,21 @@ GLFWAPI void glfwSetGammaRamp(const GLFWgammaramp* ramp);
/*! @brief Resets all window hints to their default values /*! @brief Resets all window hints to their default values
* *
* The @ref GLFW_RED_BITS, @ref GLFW_GREEN_BITS, @ref GLFW_BLUE_BITS, @ref * The @c GLFW_RED_BITS, @c GLFW_GREEN_BITS, @c GLFW_BLUE_BITS, @c
* GLFW_ALPHA_BITS and @ref GLFW_STENCIL_BITS hints are set to 8. * GLFW_ALPHA_BITS and @c GLFW_STENCIL_BITS hints are set to 8.
* *
* The @ref GLFW_DEPTH_BITS hint is set to 24. * The @c GLFW_DEPTH_BITS hint is set to 24.
* *
* The @ref GLFW_VISIBLE and @ref GLFW_RESIZABLE hints are set to 1. * The @c GLFW_VISIBLE and @c GLFW_RESIZABLE hints are set to 1.
* *
* The @ref GLFW_CLIENT_API hint is set to @ref GLFW_OPENGL_API. * The @c GLFW_CLIENT_API hint is set to @c GLFW_OPENGL_API.
* *
* The @ref GLFW_CONTEXT_VERSION_MAJOR and @ref GLFW_CONTEXT_VERSION_MINOR * The @c GLFW_CONTEXT_VERSION_MAJOR and @c GLFW_CONTEXT_VERSION_MINOR
* hints are set to 1 and 0, respectively. * hints are set to 1 and 0, respectively.
* *
* The @ref GLFW_CONTEXT_ROBUSTNESS hint is set to @ref GLFW_NO_ROBUSTNESS. * The @c GLFW_CONTEXT_ROBUSTNESS hint is set to @c GLFW_NO_ROBUSTNESS.
* *
* The @ref GLFW_OPENGL_PROFILE hint is set to @ref GLFW_OPENGL_NO_PROFILE. * The @c GLFW_OPENGL_PROFILE hint is set to @c GLFW_OPENGL_NO_PROFILE.
* *
* All other hints are set to 0. * All other hints are set to 0.
* *
@ -953,47 +953,45 @@ GLFWAPI void glfwDefaultWindowHints(void);
* @ref glfwGetWindowParam function. * @ref glfwGetWindowParam function.
* *
* The following hints are hard constraints: * The following hints are hard constraints:
* @arg @ref GLFW_STEREO * @arg @c GLFW_STEREO
* @arg @ref GLFW_CLIENT_API * @arg @c GLFW_CLIENT_API
* *
* The following additional hints are hard constraints if requesting an OpenGL * The following additional hints are hard constraints if requesting an OpenGL
* context: * context:
* @arg @ref GLFW_OPENGL_FORWARD_COMPAT * @arg @c GLFW_OPENGL_FORWARD_COMPAT
* @arg @ref GLFW_OPENGL_PROFILE * @arg @c GLFW_OPENGL_PROFILE
* *
* Hints that do not apply to a given type of window or context are ignored. * Hints that do not apply to a given type of window or context are ignored.
* *
* @par Framebuffer hints * @par Framebuffer hints
* *
* The @ref GLFW_RED_BITS, @ref GLFW_GREEN_BITS, @ref GLFW_BLUE_BITS, @ref * The @c GLFW_RED_BITS, @c GLFW_GREEN_BITS, @c GLFW_BLUE_BITS, @c
* GLFW_ALPHA_BITS, @ref GLFW_DEPTH_BITS and @ref GLFW_STENCIL_BITS hints * GLFW_ALPHA_BITS, @c GLFW_DEPTH_BITS and @c GLFW_STENCIL_BITS hints specify
* specify the desired bit depths of the various components of the default * the desired bit depths of the various components of the default framebuffer.
* framebuffer.
* *
* The @ref GLFW_ACCUM_RED_BITS, @ref GLFW_ACCUM_GREEN_BITS, @ref * The @c GLFW_ACCUM_RED_BITS, @c GLFW_ACCUM_GREEN_BITS, @c
* GLFW_ACCUM_BLUE_BITS and @ref GLFW_ACCUM_ALPHA_BITS hints specify the * GLFW_ACCUM_BLUE_BITS and @c GLFW_ACCUM_ALPHA_BITS hints specify the desired
* desired bit depths of the various components of the accumulation buffer. * bit depths of the various components of the accumulation buffer.
* *
* The @ref GLFW_AUX_BUFFERS hint specifies the desired number of auxiliary * The @c GLFW_AUX_BUFFERS hint specifies the desired number of auxiliary
* buffers. * buffers.
* *
* The @ref GLFW_STEREO hint specifies whether to use stereoscopic rendering. * The @c GLFW_STEREO hint specifies whether to use stereoscopic rendering.
* *
* The @ref GLFW_SAMPLES hint specifies the desired number of samples to use * The @c GLFW_SAMPLES hint specifies the desired number of samples to use
* for multisampling. * for multisampling.
* *
* The @ref GLFW_SRGB_CAPABLE hint specifies whether the framebuffer should be * The @c GLFW_SRGB_CAPABLE hint specifies whether the framebuffer should be
* sRGB capable. * sRGB capable.
* *
* @par Context hints * @par Context hints
* *
* The @ref GLFW_CLIENT_API hint specifies which client API to create the * The @c GLFW_CLIENT_API hint specifies which client API to create the context
* context for. Possible values are @ref GLFW_OPENGL_API and @ref * for. Possible values are @c GLFW_OPENGL_API and @c GLFW_OPENGL_ES_API.
* GLFW_OPENGL_ES_API.
* *
* The @ref GLFW_CONTEXT_VERSION_MAJOR and @ref GLFW_CONTEXT_VERSION_MINOR * The @c GLFW_CONTEXT_VERSION_MAJOR and @c GLFW_CONTEXT_VERSION_MINOR hints
* hints specify the client API version that the created context must be * specify the client API version that the created context must be compatible
* compatible with. * with.
* *
* For OpenGL, these hints are @em not hard constraints, as they don't have to * For OpenGL, these hints are @em not hard constraints, as they don't have to
* match exactly, but @ref glfwCreateWindow will still fail if the resulting * match exactly, but @ref glfwCreateWindow will still fail if the resulting
@ -1004,36 +1002,36 @@ GLFWAPI void glfwDefaultWindowHints(void);
* For OpenGL ES, these hints are hard constraints, as there is no backward * For OpenGL ES, these hints are hard constraints, as there is no backward
* compatibility between OpenGL ES versions. * compatibility between OpenGL ES versions.
* *
* If an OpenGL context is requested, the @ref GLFW_OPENGL_FORWARD_COMPAT hint * If an OpenGL context is requested, the @c GLFW_OPENGL_FORWARD_COMPAT hint
* specifies whether the OpenGL context should be forward-compatible, i.e. one * specifies whether the OpenGL context should be forward-compatible, i.e. one
* where all functionality deprecated in the requested version of OpenGL is * where all functionality deprecated in the requested version of OpenGL is
* removed. This may only be used if the requested OpenGL version is 3.0 or * removed. This may only be used if the requested OpenGL version is 3.0 or
* above. If another client API is requested, this hint is ignored. * above. If another client API is requested, this hint is ignored.
* *
* If an OpenGL context is requested, the @ref GLFW_OPENGL_DEBUG_CONTEXT hint * If an OpenGL context is requested, the @c GLFW_OPENGL_DEBUG_CONTEXT hint
* specifies whether to create a debug OpenGL context, which may have * specifies whether to create a debug OpenGL context, which may have
* additional error and performance issue reporting functionality. If another * additional error and performance issue reporting functionality. If another
* client API is requested, this hint is ignored. * client API is requested, this hint is ignored.
* *
* If an OpenGL context is requested, the @ref GLFW_OPENGL_PROFILE hint * If an OpenGL context is requested, the @c GLFW_OPENGL_PROFILE hint
* specifies which OpenGL profile to create the context for. Possible values * specifies which OpenGL profile to create the context for. Possible values
* are one of @ref GLFW_OPENGL_CORE_PROFILE or @ref GLFW_OPENGL_COMPAT_PROFILE, * are one of @c GLFW_OPENGL_CORE_PROFILE or @c GLFW_OPENGL_COMPAT_PROFILE,
* or @ref GLFW_OPENGL_NO_PROFILE to not request a specific profile. If * or @c GLFW_OPENGL_NO_PROFILE to not request a specific profile. If
* requesting an OpenGL version below 3.2, @ref GLFW_OPENGL_NO_PROFILE must be * requesting an OpenGL version below 3.2, @c GLFW_OPENGL_NO_PROFILE must be
* used. If another client API is requested, this hint is ignored. * used. If another client API is requested, this hint is ignored.
* *
* The @ref GLFW_CONTEXT_ROBUSTNESS hint specifies the robustness strategy to * The @c GLFW_CONTEXT_ROBUSTNESS hint specifies the robustness strategy to
* be used by the context. This can be one of @ref GLFW_NO_RESET_NOTIFICATION * be used by the context. This can be one of @c GLFW_NO_RESET_NOTIFICATION
* or @ref GLFW_LOSE_CONTEXT_ON_RESET, or @ref GLFW_NO_ROBUSTNESS to not * or @c GLFW_LOSE_CONTEXT_ON_RESET, or @c GLFW_NO_ROBUSTNESS to not
* request a robustness strategy. * request a robustness strategy.
* *
* @par Window hints * @par Window hints
* *
* The @ref GLFW_RESIZABLE hint specifies whether the window will be resizable * The @c GLFW_RESIZABLE hint specifies whether the window will be resizable
* by the user. The window will still be resizable using the @ref * by the user. The window will still be resizable using the @ref
* glfwSetWindowSize function. This hint is ignored for fullscreen windows. * glfwSetWindowSize function. This hint is ignored for fullscreen windows.
* *
* The @ref GLFW_VISIBLE hint specifies whether the window will be initially * The @c GLFW_VISIBLE hint specifies whether the window will be initially
* visible. This hint is ignored for fullscreen windows. * visible. This hint is ignored for fullscreen windows.
* *
* @note This function may only be called from the main thread. * @note This function may only be called from the main thread.
@ -1063,9 +1061,9 @@ GLFWAPI void glfwWindowHint(int target, int hint);
* can use the newly created context, you need to make it current using @ref * can use the newly created context, you need to make it current using @ref
* glfwMakeContextCurrent. * glfwMakeContextCurrent.
* *
* @remarks For fullscreen windows the initial cursor mode is @ref * @remarks For fullscreen windows the initial cursor mode is @c
* GLFW_CURSOR_CAPTURED and the screensaver is prohibited from starting. For * GLFW_CURSOR_CAPTURED and the screensaver is prohibited from starting. For
* regular windows the initial cursor mode is @ref GLFW_CURSOR_NORMAL and the * regular windows the initial cursor mode is @c GLFW_CURSOR_NORMAL and the
* screensaver is allowed to start. * screensaver is allowed to start.
* *
* @remarks In order to determine the actual properties of an opened window, * @remarks In order to determine the actual properties of an opened window,
@ -1138,7 +1136,7 @@ GLFWAPI void glfwGetWindowPos(GLFWwindow* window, int* xpos, int* ypos);
* the client area of the window. * the client area of the window.
* *
* @remarks If you wish to set an initial window position you should create * @remarks If you wish to set an initial window position you should create
* a hidden window (using @ref glfwWindowHint and @ref GLFW_VISIBLE), set its * a hidden window (using @ref glfwWindowHint and @c GLFW_VISIBLE), set its
* position and then show it. * position and then show it.
* *
* @note It is very rarely a good idea to move an already visible window, as it * @note It is very rarely a good idea to move an already visible window, as it
@ -1251,43 +1249,43 @@ GLFWAPI GLFWmonitor* glfwGetWindowMonitor(GLFWwindow* window);
* *
* @par Window properties * @par Window properties
* *
* The @ref GLFW_FOCUSED property indicates whether the window is focused. * The @c GLFW_FOCUSED property indicates whether the window is focused.
* *
* The @ref GLFW_ICONIFIED property indicates whether the window is iconified. * The @c GLFW_ICONIFIED property indicates whether the window is iconified.
* *
* The @ref GLFW_VISIBLE property indicates whether the window is visible. * The @c GLFW_VISIBLE property indicates whether the window is visible.
* *
* The @ref GLFW_RESIZABLE property indicates whether the window is resizable * The @c GLFW_RESIZABLE property indicates whether the window is resizable
* by the user. * by the user.
* *
* The @ref GLFW_SHOULD_CLOSE property indicates whether the window has been * The @c GLFW_SHOULD_CLOSE property indicates whether the window has been
* requested by the user to close. * requested by the user to close.
* *
* @par Context properties * @par Context properties
* *
* The @ref GLFW_CLIENT_API property indicates the client API provided by the * The @c GLFW_CLIENT_API property indicates the client API provided by the
* window's context; either @ref GLFW_OPENGL_API or @ref GLFW_OPENGL_ES_API. * window's context; either @c GLFW_OPENGL_API or @c GLFW_OPENGL_ES_API.
* *
* The @ref GLFW_CONTEXT_VERSION_MAJOR, @ref GLFW_CONTEXT_VERSION_MINOR and * The @c GLFW_CONTEXT_VERSION_MAJOR, @c GLFW_CONTEXT_VERSION_MINOR and @c
* @ref GLFW_CONTEXT_REVISION properties indicate the client API version of the * GLFW_CONTEXT_REVISION properties indicate the client API version of the
* window's context. * window's context.
* *
* The @ref GLFW_OPENGL_FORWARD_COMPAT property is @c GL_TRUE if the window's * The @c GLFW_OPENGL_FORWARD_COMPAT property is @c GL_TRUE if the window's
* context is an OpenGL forward-compatible one, or @c GL_FALSE otherwise. * context is an OpenGL forward-compatible one, or @c GL_FALSE otherwise.
* *
* The @ref GLFW_OPENGL_DEBUG_CONTEXT property is @c GL_TRUE if the window's * The @c GLFW_OPENGL_DEBUG_CONTEXT property is @c GL_TRUE if the window's
* context is an OpenGL debug context, or @c GL_FALSE otherwise. * context is an OpenGL debug context, or @c GL_FALSE otherwise.
* *
* The @ref GLFW_OPENGL_PROFILE property indicates the OpenGL profile used by * The @c GLFW_OPENGL_PROFILE property indicates the OpenGL profile used by the
* the context. This is @ref GLFW_OPENGL_CORE_PROFILE or @ref * context. This is @c GLFW_OPENGL_CORE_PROFILE or @c
* GLFW_OPENGL_COMPAT_PROFILE if the context uses a known profile, or @ref * GLFW_OPENGL_COMPAT_PROFILE if the context uses a known profile, or @c
* GLFW_OPENGL_NO_PROFILE if the OpenGL profile is unknown or the context is * GLFW_OPENGL_NO_PROFILE if the OpenGL profile is unknown or the context is
* for another client API. * for another client API.
* *
* The @ref GLFW_CONTEXT_ROBUSTNESS property indicates the robustness strategy * The @c GLFW_CONTEXT_ROBUSTNESS property indicates the robustness strategy
* used by the context. This is @ref GLFW_LOSE_CONTEXT_ON_RESET or @ref * used by the context. This is @c GLFW_LOSE_CONTEXT_ON_RESET or @c
* GLFW_NO_RESET_NOTIFICATION if the window's context supports robustness, or * GLFW_NO_RESET_NOTIFICATION if the window's context supports robustness, or
* @ref GLFW_NO_ROBUSTNESS otherwise. * @c GLFW_NO_ROBUSTNESS otherwise.
*/ */
GLFWAPI int glfwGetWindowParam(GLFWwindow* window, int param); GLFWAPI int glfwGetWindowParam(GLFWwindow* window, int param);
@ -1336,7 +1334,7 @@ GLFWAPI void glfwSetWindowSizeCallback(GLFWwindow* window, GLFWwindowsizefun cbf
* clicks the window's close widget. Calling @ref glfwDestroyWindow does not * clicks the window's close widget. Calling @ref glfwDestroyWindow does not
* cause this callback to be called. * cause this callback to be called.
* *
* The return value of the close callback becomes the new value of the @ref * The return value of the close callback becomes the new value of the @c
* GLFW_SHOULD_CLOSE window parameter. * GLFW_SHOULD_CLOSE window parameter.
* *
* @remarks <b>Mac OS X:</b> Selecting Quit from the application menu will * @remarks <b>Mac OS X:</b> Selecting Quit from the application menu will
@ -1401,9 +1399,9 @@ GLFWAPI void glfwWaitEvents(void);
/*! @brief Returns the value of an input option for the specified window. /*! @brief Returns the value of an input option for the specified window.
* @param[in] window The window to query. * @param[in] window The window to query.
* @param[in] mode One of the following: * @param[in] mode One of the following:
* @arg @ref GLFW_CURSOR_MODE Sets the cursor mode. * @arg @c GLFW_CURSOR_MODE Sets the cursor mode.
* @arg @ref GLFW_STICKY_KEYS Sets whether sticky keys are enabled. * @arg @c GLFW_STICKY_KEYS Sets whether sticky keys are enabled.
* @arg @ref GLFW_STICKY_MOUSE_BUTTONS Sets whether sticky mouse buttons are enabled. * @arg @c GLFW_STICKY_MOUSE_BUTTONS Sets whether sticky mouse buttons are enabled.
* @ingroup input * @ingroup input
* *
* @sa glfwSetInputMode * @sa glfwSetInputMode
@ -1412,7 +1410,7 @@ GLFWAPI int glfwGetInputMode(GLFWwindow* window, int mode);
/*! @brief Sets an input option for the specified window. /*! @brief Sets an input option for the specified window.
* @param[in] window The window whose input mode to set. * @param[in] window The window whose input mode to set.
* @param[in] mode One of @ref GLFW_CURSOR_MODE, @ref GLFW_STICKY_KEYS or @ref * @param[in] mode One of @c GLFW_CURSOR_MODE, @c GLFW_STICKY_KEYS or @c
* GLFW_STICKY_MOUSE_BUTTONS. * GLFW_STICKY_MOUSE_BUTTONS.
* @param[in] value The new value of the specified input mode. * @param[in] value The new value of the specified input mode.
* @ingroup input * @ingroup input
@ -1425,7 +1423,7 @@ GLFWAPI void glfwSetInputMode(GLFWwindow* window, int mode, int value);
* window. * window.
* @param[in] window The desired window. * @param[in] window The desired window.
* @param[in] key The desired @link keys keyboard key @endlink. * @param[in] key The desired @link keys keyboard key @endlink.
* @return One of @ref GLFW_PRESS or @ref GLFW_RELEASE. * @return One of @c GLFW_PRESS or @c GLFW_RELEASE.
* @ingroup input * @ingroup input
*/ */
GLFWAPI int glfwGetKey(GLFWwindow* window, int key); GLFWAPI int glfwGetKey(GLFWwindow* window, int key);
@ -1434,7 +1432,7 @@ GLFWAPI int glfwGetKey(GLFWwindow* window, int key);
* window. * window.
* @param[in] window The desired window. * @param[in] window The desired window.
* @param[in] button The desired @link buttons mouse buttons @endlink. * @param[in] button The desired @link buttons mouse buttons @endlink.
* @return One of @ref GLFW_PRESS or @ref GLFW_RELEASE. * @return One of @c GLFW_PRESS or @c GLFW_RELEASE.
* @ingroup input * @ingroup input
*/ */
GLFWAPI int glfwGetMouseButton(GLFWwindow* window, int button); GLFWAPI int glfwGetMouseButton(GLFWwindow* window, int button);