diff --git a/doc/cmake.dox b/doc/cmake.dox index b6ab4f3a9..b80791ca6 100644 --- a/doc/cmake.dox +++ b/doc/cmake.dox @@ -156,12 +156,12 @@ variable along with `MAGNUM_PLUGINS_*_DEBUG_DIR` / `MAGNUM_PLUGINS_*_RELEASE_DIR variables to decide in preprocessing step. Features of found %Magnum library are exposed in these CMake variables, they -are also available as preprocessor variables if including Magnum.h: +are also available as preprocessor variables if including @ref Magnum/Magnum.h: - `MAGNUM_BUILD_DEPRECATED` -- Defined if compiled with deprecated APIs included -- `MAGNUM_BUILD_STATIC` -- Defined if built as static libraries. Default are - shared libraries. +- `MAGNUM_BUILD_STATIC` -- Defined if compiled as static libraries. Default + are shared libraries. - `MAGNUM_TARGET_GLES` -- Defined if compiled for OpenGL ES - `MAGNUM_TARGET_GLES2` -- Defined if compiled for OpenGL ES 2.0 - `MAGNUM_TARGET_GLES3` -- Defined if compiled for OpenGL ES 3.0 diff --git a/src/Magnum/Context.h b/src/Magnum/Context.h index e68221939..93eee5bef 100644 --- a/src/Magnum/Context.h +++ b/src/Magnum/Context.h @@ -381,6 +381,7 @@ class MAGNUM_EXPORT Context { * as it does most operations in compile time. * @see @ref supportedExtensions(), @ref Extension::extensions(), * @ref MAGNUM_ASSERT_EXTENSION_SUPPORTED() + * @todoc Explicit reference when Doxygen can handle const */ bool isExtensionSupported(const Extension& extension) const { return isVersionSupported(_extensionRequiredVersion[extension._index]) && extensionStatus[extension._index]; @@ -414,6 +415,7 @@ class MAGNUM_EXPORT Context { * Can be used e.g. for listing extensions available on current * hardware, but for general usage prefer isExtensionDisabled() const, * as it does most operations in compile time. + * @todoc Explicit reference when Doxygen can handle const */ bool isExtensionDisabled(const Extension& extension) const { return isVersionSupported(extension._requiredVersion) && extensionStatus[extension._index] && !isVersionSupported(_extensionRequiredVersion[extension._index]); diff --git a/src/Magnum/Magnum.h b/src/Magnum/Magnum.h index 77a551697..93e0915d0 100644 --- a/src/Magnum/Magnum.h +++ b/src/Magnum/Magnum.h @@ -73,7 +73,7 @@ using Corrade::Utility::Error; Defined if the library contains deprecated API (which will be removed in the future). To preserve backward compatibility, %Magnum is by default built with deprecated API included. -@see @ref building +@see @ref building, @ref cmake */ #define MAGNUM_BUILD_DEPRECATED /* (enabled by default) */ @@ -82,7 +82,7 @@ deprecated API included. @brief Static library build Defined if built as static libraries. Default are shared libraries. -@see @ref building +@see @ref building, @ref cmake */ #define MAGNUM_BUILD_STATIC #undef MAGNUM_BUILD_STATIC @@ -92,7 +92,7 @@ Defined if built as static libraries. Default are shared libraries. Defined if the engine is built for OpenGL ES 3.0 or OpenGL ES 2.0. @see @ref MAGNUM_TARGET_GLES2, @ref MAGNUM_TARGET_GLES3, - @ref MAGNUM_TARGET_DESKTOP_GLES, @ref building + @ref MAGNUM_TARGET_DESKTOP_GLES, @ref building, @ref cmake */ #define MAGNUM_TARGET_GLES #undef MAGNUM_TARGET_GLES @@ -102,7 +102,8 @@ Defined if the engine is built for OpenGL ES 3.0 or OpenGL ES 2.0. Defined if the engine is built for OpenGL ES 2.0. Implies also @ref MAGNUM_TARGET_GLES. -@see @ref MAGNUM_TARGET_GLES3, @ref MAGNUM_TARGET_DESKTOP_GLES, @ref building +@see @ref MAGNUM_TARGET_GLES3, @ref MAGNUM_TARGET_DESKTOP_GLES, @ref building, + @ref cmake */ #define MAGNUM_TARGET_GLES2 #undef MAGNUM_TARGET_GLES2 @@ -112,7 +113,8 @@ Defined if the engine is built for OpenGL ES 2.0. Implies also Defined if the engine is built for OpenGL ES 3.0. Implies also @ref MAGNUM_TARGET_GLES. -@see @ref MAGNUM_TARGET_GLES2, @ref MAGNUM_TARGET_DESKTOP_GLES, @ref building +@see @ref MAGNUM_TARGET_GLES2, @ref MAGNUM_TARGET_DESKTOP_GLES, @ref building, + @ref cmake */ #define MAGNUM_TARGET_GLES3 #undef MAGNUM_TARGET_GLES3 @@ -122,7 +124,8 @@ Defined if the engine is built for OpenGL ES 3.0. Implies also Defined if the engine is built for OpenGL ES 3.0 or OpenGL ES 2.0 emulated within standard desktop OpenGL. Implies also @ref MAGNUM_TARGET_GLES. -@see @ref MAGNUM_TARGET_GLES2, @ref MAGNUM_TARGET_GLES3, @ref building +@see @ref MAGNUM_TARGET_GLES2, @ref MAGNUM_TARGET_GLES3, @ref building, + @ref cmake */ #define MAGNUM_TARGET_DESKTOP_GLES #undef MAGNUM_TARGET_DESKTOP_GLES @@ -136,7 +139,7 @@ differently, but there are some [specific restrictions and features](http://www.khronos.org/registry/webgl/specs/latest/1.0/#6) which you might want to be aware of. Implies also @ref MAGNUM_TARGET_GLES and @ref MAGNUM_TARGET_GLES2. -@see @ref CORRADE_TARGET_EMSCRIPTEN, @ref building +@see @ref CORRADE_TARGET_EMSCRIPTEN, @ref building, @ref cmake */ #define MAGNUM_TARGET_WEBGL #undef MAGNUM_TARGET_WEBGL