GL: minor doc improvements for textures.

Not great, not terrible.

src/Magnum/GL/AbstractTexture.h

@@ -55,10 +55,10 @@ namespace Implementation {
 /**
 @brief Base for textures
 
-Encapsulates one OpenGL texture object. See @ref Texture, @ref TextureArray,
+Wraps an OpenGL texture object. Meant to be only used through
-@ref CubeMapTexture, @ref CubeMapTextureArray, @ref RectangleTexture,
+subclasses, see @ref Texture, @ref TextureArray, @ref CubeMapTexture,
-@ref BufferTexture and @ref MultisampleTexture documentation for more
+@ref CubeMapTextureArray, @ref RectangleTexture, @ref BufferTexture and
-information and usage examples.
+@ref MultisampleTexture documentation for more information and usage examples.
 
 @section GL-AbstractTexture-webgl-restrictions WebGL restrictions
 

src/Magnum/GL/Texture.h

@@ -65,8 +65,7 @@ namespace Implementation {
 /**
 @brief Texture
 
-Template class for one- to three-dimensional textures. See also
+Template class for one- to three-dimensional textures. See @ref AbstractTexture documentation for a common interface shared by all texture types.
-@ref AbstractTexture documentation for more information.
 
 @section GL-Texture-usage Usage
 
@@ -83,12 +82,12 @@ trilinear anisotropic filtering, i.e. the best you can ask for:
     of the mip chain or call @ref setMinificationFilter() with another value to
     disable mipmapping.
 
-In shader, the texture is used via @glsl sampler1D @ce / @glsl sampler2D @ce /
+In a shader, the texture is used via @glsl sampler1D @ce / @glsl sampler2D @ce
-@glsl sampler3D @ce, @glsl sampler1DShadow @ce / @glsl sampler2DShadow @ce /
+/ @glsl sampler3D @ce, @glsl sampler1DShadow @ce / @glsl sampler2DShadow @ce,
-@glsl sampler3DShadow @ce, @glsl isampler1D @ce / @glsl isampler2D @ce /
+@glsl isampler1D @ce / @glsl isampler2D @ce / @glsl isampler3D @ce or
-@glsl isampler3D @ce or @glsl usampler1D @ce / @glsl usampler2D @ce /
+@glsl usampler1D @ce / @glsl usampler2D @ce / @glsl usampler3D @ce. See
-@glsl usampler3D @ce. See @ref AbstractShaderProgram documentation for more
+@ref AbstractShaderProgram documentation for more information about usage in
-information about usage in shaders.
+shaders.
 
 @see @ref Texture1D, @ref Texture2D, @ref Texture3D, @ref TextureArray,
     @ref CubeMapTexture, @ref CubeMapTextureArray, @ref RectangleTexture,