Doc++

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

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]);

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