Document relative font sizes

Author: DominikStiller

galleries/users_explain/text/text_props.py

@@ -34,7 +34,7 @@
 picker                      [None|float|bool|callable]
 position                    (x, y)
 rotation                    [ angle in degrees | ``'vertical'`` | ``'horizontal'`` ]
-size or fontsize            [ size in points | relative size, e.g., ``'smaller'``, ``'x-large'`` ]
+        size or fontsize            [ size in points | relative size, e.g., ``'small'``, ``'x-large'`` ]
 style or fontstyle          [ ``'normal'`` | ``'italic'`` | ``'oblique'`` ]
 text                        string or anything printable with '%s' conversion
 transform                   `~matplotlib.transforms.Transform` subclass
@@ -48,6 +48,9 @@
 ==========================  ======================================================================================================================
 
 
+Text alignment
+==============
+
 You can lay out text with the alignment arguments
 ``horizontalalignment``, ``verticalalignment``, and
 ``multialignment``.  ``horizontalalignment`` controls whether the x
@@ -69,8 +72,8 @@
 import matplotlib.patches as patches
 
 # build a rectangle in axes coords
-left, width = .25, .5
-bottom, height = .25, .5
+left, width = 0.25, 0.5
+bottom, height = 0.25, 0.5
 right = left + width
 top = bottom + height
 
@@ -144,6 +147,25 @@
 plt.show()
 
 # %%
+# Relative font sizes
+# ===================
+#
+# Font sizes can be specified in points, or as a string that indicates the size
+# relative to the default font size. The following are valid values for relative font sizes:
+#
+# ====================    ================================
+# Relative font size      Scaling of default font size
+# ====================    ================================
+# xx-small                0.579
+# x-small                 0.694
+# small                   0.833
+# medium                  1.000
+# large                   1.200
+# x-large                 1.440
+# xx-large                1.728
+# ====================    ================================
+#
+#
 # ==============
 #  Default Font
 # ==============