Text: direct to the full distance field param docs from here as well.

Plus fix some other weirdness like abrupt holes in sentences or
misleading descriptions.

doc/snippets/Text-gl.cpp

@@ -131,9 +131,9 @@ shader
 PluginManager::Manager<Text::AbstractFont> manager;
 /* [DistanceFieldGlyphCacheGL-usage] */
 Containers::Pointer<Text::AbstractFont> font = DOXYGEN_ELLIPSIS(manager.loadAndInstantiate(""));
-font->openFile("font.ttf", 96.0f);
+font->openFile("font.ttf", 48.0f);
 
-Text::DistanceFieldGlyphCacheGL cache{Vector2i{1024}, Vector2i{128}, 12};
+Text::DistanceFieldGlyphCacheGL cache{{512, 512}, {128, 128}, 12};
 if(!font->fillGlyphCache(cache, "abcdefghijklmnopqrstuvwxyz"
                                 "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
                                 "0123456789?!:;,. "))

src/Magnum/Text/DistanceFieldGlyphCacheGL.h

@@ -42,31 +42,31 @@ namespace Magnum { namespace Text {
 @brief OpenGL glyph cache with distance field rendering
 @m_since_latest
 
-Unlike the base @ref GlyphCacheGL, this class converts each binary image to a
+Extends @ref GlyphCacheGL by processing rendered glyphs to a signed distance
-distance field. It's possible to only use this cache for monochrome glyphs as
+field texture using @ref TextureTools::DistanceFieldGL, allowing them to be
-the internal texture format is single-channel.
+drawn at different sizes and with various transformations without aliasing
+artifacts. It's possible to only use this cache for monochrome glyphs as the
+internal texture format is single-channel.
 
 @section Text-DistanceFieldGlyphCacheGL-usage Usage
 
 In order to create a distance field glyph cache, the font has to be loaded at a
 size significantly larger than what the resulting text will be. The distance
-field conversion process then converts the input to a fraction of its size
+field conversion, then converts the input to a fraction of its size again,
-again, transferring the the extra spatial resolution to distance values. The
+transferring the the extra spatial resolution to distance values. The distance
-distance values are then used to render an arbitrarily sized text without it
+values are then used to render an arbitrarily sized text without it being jaggy
-being jaggy at small sizes and blurry when large.
+at small sizes and blurry when large.
 
 The process requires three input parameters, size of the source image, size of
 the resulting glyph cache image and a radius for the distance field creation.
-The ratio between the input and output image size is usually four or eight
+Their relation and effect on output quality and memory use is described in
-times, and the size of the font should match the larger size. So, for example,
+detail in @ref TextureTools-DistanceFieldGL-parameters "TextureTools::DistanceFieldGL docs".
-if a @cpp {128, 128} @ce @ref GlyphCacheGL was filled with a 12 pt font, a
+In short, the ratio between the input and output image size is usually four or
-@cpp {1024, 1024} @ce source image for the distance field should use a 96 pt
+eight times, and the size of the font should match the larger size. So, for
-font. The radius should then be chosen so it's at least one or two pixels in
+example, if a @cpp {128, 128} @ce @ref GlyphCacheGL would be filled with a 12
-the scaled-down result, so in this case at least 8. Values less than that will
+pt font, a @cpp {512, 512} @ce source image for the distance field should use a
-result in aliasing artifacts. Very high radius values are needed only if
+48 pt font. The radius should then be chosen so it's at least one or two pixels
-outlining, thinning, thickening or shadow effects will be used when rendering,
+in the scaled-down result, so in this case at least @cpp 4 @ce:
-using them leads to precision loss when the distance field is stored in 8-bit
-channels.
 
 @snippet Text-gl.cpp DistanceFieldGlyphCacheGL-usage
 
@@ -112,17 +112,18 @@ class MAGNUM_TEXT_EXPORT DistanceFieldGlyphCacheGL: public GlyphCacheGL {
          * @brief Constructor
          * @param size              Size of the source image
          * @param processedSize     Resulting distance field texture size
-         * @param radius            Distance field computation radius
+         * @param radius            Distance field calculation radius
          *
-         * See @ref TextureTools::DistanceField for more information about the
+         * See @ref TextureTools::DistanceFieldGL for more information about
-         * parameters. Size restrictions from it apply here as well, in
+         * the parameters. Size restrictions from it apply here as well, in
          * particular the ratio of @p size and @p processedSize is expected to
          * be a multiple of 2.
          *
          * Sets the @ref processedFormat() to @ref PixelFormat::R8Unorm, if
-         * available. On OpenGL ES 3.0+ and WebGL 2 uses  always. On desktop
+         * available. On OpenGL ES 3.0+ and WebGL 2 uses
-         * OpenGL requires @gl_extension{ARB,texture_rg} (part of OpenGL 3.0),
+         * @ref PixelFormat::R8Unorm always. On desktop OpenGL requires
-         * on ES2 uses  @gl_extension{EXT,texture_rg} if available and uses
+         * @gl_extension{ARB,texture_rg} (part of OpenGL 3.0), on ES2 uses
+         * @gl_extension{EXT,texture_rg} if available and uses
          * @ref PixelFormat::RGB8Unorm as fallback if not, on WebGL 1 uses
          * @ref PixelFormat::RGB8Unorm always.
          */