From 21d3db82dfb8e0c905fa24055e00ca9025411d13 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vladim=C3=ADr=20Vondru=C5=A1?= <mosra@centrum.cz>
Date: Sun, 29 Jun 2014 13:23:53 +0200
Subject: [PATCH] Doc++

---
 doc/building.dox        | 50 +++++++++++++++++++++--------------------
 doc/troubleshooting.dox |  2 +-
 src/Magnum/Shader.h     |  4 +---
 3 files changed, 28 insertions(+), 28 deletions(-)

diff --git a/doc/building.dox b/doc/building.dox
index d1319ce55..ff3a6dfe3 100644
--- a/doc/building.dox
+++ b/doc/building.dox
@@ -167,26 +167,27 @@ CMake and C++ sources, see @ref cmake and @ref Magnum/Magnum.h for more
 information. See also @ref corrade-cmake and @ref Corrade/Corrade.h for
 additional information.
 
-By default the engine is built with nearly everything except Audio library,
-plugins and application libraries (see below). Using `WITH_*` CMake parameters
-you can specify which parts will be built and which not:
-
--   `WITH_AUDIO` - Audio library. Depends on **OpenAL** library, not built by
-    default.
--   `WITH_DEBUGTOOLS` - DebugTools library. Enables also building of MeshTools,
-    Primitives, SceneGraph, Shaders and Shapes libraries.
--   `WITH_MESHTOOLS` - MeshTools library. Enabled automatically if
+By default the engine is built with nearly everything except @ref Audio
+library, plugins and application libraries (see below). Using `WITH_*` CMake
+parameters you can specify which parts will be built and which not:
+
+-   `WITH_AUDIO` - @ref Audio library. Depends on **OpenAL** library, not built
+    by default.
+-   `WITH_DEBUGTOOLS` - @ref DebugTools library. Enables also building of
+    %MeshTools, %Primitives, %SceneGraph, %Shaders and %Shapes libraries.
+-   `WITH_MESHTOOLS` - @ref MeshTools library. Enabled automatically if
     `WITH_DEBUGTOOLS` is enabled.
--   `WITH_PRIMITIVES` - Primitives library. Enabled automatically if
+-   `WITH_PRIMITIVES` - @ref Primitives library. Enabled automatically if
     `WITH_DEBUGTOOLS` is enabled.
--   `WITH_SCENEGRAPH` - SceneGraph library. Enabled automatically if
+-   `WITH_SCENEGRAPH` - @ref SceneGraph library. Enabled automatically if
     `WITH_DEBUGTOOLS` or `WITH_SHAPES` is enabled.
--   `WITH_SHADERS` - Shaders library. Enabled automatically if `WITH_DEBUGTOOLS`
-    is enabled.
--   `WITH_SHAPES` - Shapes library. Enables also building of SceneGraph
+-   `WITH_SHADERS` - @ref Shaders library. Enabled automatically if
+    `WITH_DEBUGTOOLS` is enabled.
+-   `WITH_SHAPES` - @ref Shapes library. Enables also building of %SceneGraph
     library. Enabled automatically if `WITH_DEBUGTOOLS` is enabled.
--   `WITH_TEXT` - Text library. Enables also building of TextureTools library.
--   `WITH_TEXTURETOOLS` - TextureTools library. Enabled automatically if
+-   `WITH_TEXT` - @ref Text library. Enables also building of %TextureTools
+    library.
+-   `WITH_TEXTURETOOLS` - @ref TextureTools library. Enabled automatically if
     `WITH_TEXT` or `WITH_DISTANCEFIELDCONVERTER` is enabled.
 
 None of the @ref Platform "application libraries" is built by default (and you
@@ -207,15 +208,16 @@ platform best:
 There are also a few command-line utilities. They are currently available only
 on Linux, Mac OS X and Windows, also disabled by default:
 
--   `WITH_MAGNUMINFO` - `magnum-info` executable, provides information about
-    the engine and OpenGL capabilities.
--   `WITH_FONTCONVERTER` - `magnum-fontconverter` executable for converting
-    fonts to raster ones. Enables also building of Text library.
--   `WITH_DISTANCEFIELDCONVERTER` - `magnum-distancefieldconverter` executable
-    for converting black&white images to distance field textures. Enables also
-    building of TextureTools library.
+-   `WITH_MAGNUMINFO` - @ref magnum-info "magnum-info" executable, provides
+    information about the engine and OpenGL capabilities.
+-   `WITH_DISTANCEFIELDCONVERTER` - @ref magnum-distancefieldconverter "magnum-distancefieldconverter"
+    executable for converting black&white images to distance field textures.
+    Enables also building of %TextureTools library.
+-   `WITH_FONTCONVERTER` - @ref magnum-fontconverter "magnum-fontconverter"
+    executable for converting fonts to raster ones. Enables also building of
+    %Text library.
 
-Magnum also contains a set of dependency-less plugins for importing essential
+%Magnum also contains a set of dependency-less plugins for importing essential
 file formats. Additional plugins are provided in separate plugin repository,
 see @ref building-plugins for more information. None of the plugins is built by
 default.
diff --git a/doc/troubleshooting.dox b/doc/troubleshooting.dox
index f9a096240..08aaeae5f 100644
--- a/doc/troubleshooting.dox
+++ b/doc/troubleshooting.dox
@@ -55,7 +55,7 @@ try these things:
 -   Check that you use only extensions that are
     @ref Context::isExtensionSupported() "available on your system".
 -   Check that you didn't exceed any implementation-defined limit (see
-    `magnum-info` output for list of all of them).
+    @ref magnum-info output for list of all of them).
 -   Enable @ref DebugMessage "debug output" to see more detailed errors,
     warnings and performance hints.
 -   If using framebuffer objects, @ref Framebuffer::checkStatus() "check that they are complete".
diff --git a/src/Magnum/Shader.h b/src/Magnum/Shader.h
index 55525e4e3..1afd37c31 100644
--- a/src/Magnum/Shader.h
+++ b/src/Magnum/Shader.h
@@ -41,9 +41,7 @@ namespace Magnum {
 /**
 @brief %Shader
 
-See @ref AbstractShaderProgram for more information.
-
-@todoc Usage...
+See @ref AbstractShaderProgram for usage information.
 
 ## Performance optimizations