Doc++

* Grouping lengthy documentation into "Feature overview" page.
 * Link only to example index, where all the disclaimers are.
 * Also minor documentation updates.

doc/features.dox

@@ -0,0 +1,8 @@
+namespace Magnum {
+/** @page features Feature overview
+@brief Fundamental principles and design goals
+
+- @subpage matrix-vector - @copybrief matrix-vector
+- @subpage collision-detection - @copybrief collision-detection
+*/
+}

doc/mainpage.dox

@@ -48,10 +48,10 @@ help you with object hierarchy, transformations and resource management.
 
 @subsection getting-started-examples Tutorials and examples
 
-The best way to get started is to @ref examples-triangle "render your first triangle"
+The best way to get started is to render your first triangle in
-in step-by-step tutorial. Then you can dig deeper and try @ref example-index
+@ref example-index "step-by-step tutorial". Then you can dig deeper and try
-"other examples", read about fundamental principles in the documentation or
+other examples, read about @ref features "fundamental principles" in the
-start experimenting on your own!
+documentation or start experimenting on your own!
 
 @subsection getting-started-hacking Hacking Magnum
 

doc/namespaces.dox

@@ -90,7 +90,7 @@ Collection of shaders for testing purposes.
 /** @namespace Magnum::Physics
 @brief %Physics library
 
-Collision detection system and rigid body objects. See @ref physics
+Collision detection system and rigid body objects. See @ref collision-detection
 for introduction.
 */
 

doc/physics.dox

@@ -1,7 +0,0 @@
-namespace Magnum { namespace Physics {
-/** @page physics Physics library
-@brief Collision detection and rigid body dynamics.
-
-@subpage collision-detection
-*/
-}}

src/AbstractShaderProgram.h

@@ -47,6 +47,7 @@ typedef Attribute<2, Vector2> TextureCoords;
 @endcode
    @todoc Output attribute location (for bindFragmentDataLocationIndexed(),
         referenced also from Framebuffer::mapDefaultForDraw() / Framebuffer::mapForDraw())
+
  - **Layers for texture uniforms** to which the textures will be bound before
    rendering, for example:
 @code