Moved doxy doc

This commit is contained in:
Christophe Riccio 2011-06-16 01:34:07 +01:00
parent c4851e39a1
commit fa1d6aaa59
2 changed files with 55 additions and 66 deletions

View File

@ -1,66 +0,0 @@
/*!
\defgroup core GLM Core
\brief The core of GLM, which implements exactly and only the GLSL specification to the degree possible.
The GLM core consists of \ref core_types "C++ types that mirror GLSL types",
\ref core_funcs "C++ functions that mirror the GLSL functions". It also includes
\ref core_precision "a set of precision-based types" that can be used in the appropriate
functions. The C++ types are all based on a basic set of \ref core_template "template types".
The best documentation for GLM Core is the current GLSL specification,
<a href="http://www.opengl.org/registry/doc/GLSLangSpec.4.10.6.clean.pdf">version 4.1
(pdf file)</a>.
There are a few \ref pg_differences "differences" between GLM core and GLSL.
GLM core functionnalities requires <glm/glm.hpp> to be included to be used.
**/
/*!
\defgroup core_types Types
\brief The standard types defined by the specification.
These types are all typedefs of more generalized, template types. To see the definiton
of these template types, go to \ref core_template.
\ingroup core
**/
/*!
\defgroup core_precision Precision types
\brief Non-GLSL types that are used to define precision-based types.
The GLSL language allows the user to define the precision of a particular variable.
In OpenGL's GLSL, these precision qualifiers have no effect; they are there for compatibility
with OpenGL ES's precision qualifiers, where they \em do have an effect.
C++ has no language equivalent to precision qualifiers. So GLM provides the next-best thing:
a number of typedefs of the \ref core_template that use a particular precision.
None of these types make any guarantees about the actual precision used.
\ingroup core
**/
/*!
\defgroup core_template Template types
\brief The generic template types used as the basis for the core types.
These types are all templates used to define the actual \ref core_types.
These templetes are implementation details of GLM types and should not be used explicitly.
\ingroup core
**/
/*!
\defgroup core_funcs Functions
\brief The functions defined by the specification.
\ingroup core
**/

View File

@ -24,6 +24,61 @@
/// @file glm/glm.hpp /// @file glm/glm.hpp
/// @date 2005-01-14 / 2011-05-16 /// @date 2005-01-14 / 2011-05-16
/// @author Christophe Riccio /// @author Christophe Riccio
///
/// \defgroup core GLM Core
///
/// \brief The core of GLM, which implements exactly and only the GLSL specification to the degree possible.
///
/// The GLM core consists of \ref core_types "C++ types that mirror GLSL types",
/// \ref core_funcs "C++ functions that mirror the GLSL functions". It also includes
/// \ref core_precision "a set of precision-based types" that can be used in the appropriate
/// functions. The C++ types are all based on a basic set of \ref core_template "template types".
///
/// The best documentation for GLM Core is the current GLSL specification,
/// <a href="http://www.opengl.org/registry/doc/GLSLangSpec.4.10.6.clean.pdf">version 4.1
/// (pdf file)</a>.
/// There are a few \ref pg_differences "differences" between GLM core and GLSL.
///
/// GLM core functionnalities requires <glm/glm.hpp> to be included to be used.
///
/// \defgroup core_types Types
///
/// \brief The standard types defined by the specification.
///
/// These types are all typedefs of more generalized, template types. To see the definiton
/// of these template types, go to \ref core_template.
///
/// \ingroup core
///
/// \defgroup core_precision Precision types
///
/// \brief Non-GLSL types that are used to define precision-based types.
///
/// The GLSL language allows the user to define the precision of a particular variable.
/// In OpenGL's GLSL, these precision qualifiers have no effect; they are there for compatibility
/// with OpenGL ES's precision qualifiers, where they \em do have an effect.
///
/// C++ has no language equivalent to precision qualifiers. So GLM provides the next-best thing:
/// a number of typedefs of the \ref core_template that use a particular precision.
///
/// None of these types make any guarantees about the actual precision used.
///
/// \ingroup core
///
/// \defgroup core_template Template types
///
/// \brief The generic template types used as the basis for the core types.
///
/// These types are all templates used to define the actual \ref core_types.
/// These templetes are implementation details of GLM types and should not be used explicitly.
///
/// \ingroup core
///
/// \defgroup core_funcs Functions
///
/// \brief The functions defined by the specification.
///
/// \ingroup core
/////////////////////////////////////////////////////////////////////////////////// ///////////////////////////////////////////////////////////////////////////////////
#include "core/_fixes.hpp" #include "core/_fixes.hpp"