@@ -722,7 +722,7 @@ def _fontsize_to_pt(size):
722722
723723@warnings ._rename_kwargs ('0.6' , units = 'dest' )
724724def units (
725- value , numeric = None , dest = None , * , axes = None , figure = None , width = True , fontsize = None
725+ value , numeric = None , dest = None , * , fontsize = None , figure = None , axes = None , width = None
726726):
727727 """
728728 Convert values and lists of values between arbitrary physical units. This
@@ -738,7 +738,7 @@ def units(
738738 where the number is the magnitude and ``'unit'`` matches a key in
739739 the below table.
740740
741- .. _units_table : :
741+ .. _units_table:
742742
743743 ========= =====================================================
744744 Key Description
@@ -772,6 +772,10 @@ def units(
772772 The units associated with numeric input. Default is inches.
773773 dest : str, optional
774774 The destination units. Default is the same as `numeric`.
775+ fontsize : size-spec, optional
776+ The font size in points used for scaling. Default is
777+ :rcraw:`font.size` for ``em`` and ``en`` units and
778+ :rcraw:`axes.titlesize` for ``Em`` and ``En`` units.
775779 axes : `~matplotlib.axes.Axes`, optional
776780 The axes to use for scaling units that look like ``'0.1ax'``.
777781 figure : `~matplotlib.figure.Figure`, optional
@@ -780,10 +784,6 @@ def units(
780784 width : bool, optional
781785 Whether to use the width or height for the axes and figure
782786 relative coordinates.
783- fontsize : size-spec, optional
784- The font size in points used for scaling. Default is
785- :rcraw:`font.size` for ``em`` and ``en`` units and
786- :rcraw:`axes.titlesize` for ``Em`` and ``En`` units.
787787 """
788788 # Scales for converting physical units to inches
789789 fontsize_small = _not_none (fontsize , rc_matplotlib ['font.size' ]) # always absolute
0 commit comments