@@ -2563,99 +2563,104 @@ class _Subsection:
25632563 validator = validate_float_or_None ,
25642564 description = "Minor grid line transparency. None defaults to 'grid.alpha'."
25652565 ),
2566- _Section ("Legend" ),
2566+ _Section (
2567+ "Legend" ,
2568+ description = "Default legend properties. All entries define defaults for "
2569+ "parameters of `.Legend` / `.Axes.legend` / `.Figure.legend`."
2570+ ),
25672571 _Param (
25682572 "legend.loc" ,
25692573 default = "best" ,
25702574 type = str | int | tuple [float , float ],
25712575 validator = _validate_legend_loc ,
2572- description = "The legend location. See the *loc* parameter in `.Axes.legend`."
2576+ description = "Legend location. See the *loc* parameter in `.Axes.legend`."
25732577 ),
25742578 _Param (
25752579 "legend.frameon" ,
25762580 default = True ,
25772581 type = bool ,
25782582 validator = validate_bool ,
2579- description = "if True, draw the legend on a background patch"
2583+ description = "Whether to draw the legend on a background patch. "
25802584 ),
25812585 _Param (
25822586 "legend.framealpha" ,
25832587 default = 0.8 ,
25842588 type = float | None ,
25852589 validator = validate_float_or_None ,
2586- description = "legend patch transparency "
2590+ description = "Transparency of the legend background patch. "
25872591 ),
25882592 _Param (
25892593 "legend.facecolor" ,
25902594 default = "inherit" ,
25912595 type = ':mpltype:`color` or "inherit"' ,
25922596 validator = validate_color_or_inherit ,
2593- description = "inherit from axes.facecolor; or color spec "
2597+ description = "Color of the legend background. 'inherit' uses 'axes.facecolor'. "
25942598 ),
25952599 _Param (
25962600 "legend.edgecolor" ,
25972601 default = "0.8" ,
25982602 type = ':mpltype:`color` or "inherit"' ,
25992603 validator = validate_color_or_inherit ,
2600- description = "background patch boundary color "
2604+ description = "Color of the legend frame. 'inherit' uses 'axes.facecolor'. "
26012605 ),
26022606 _Param (
26032607 "legend.linewidth" ,
26042608 default = None ,
26052609 type = float | None ,
26062610 validator = validate_float_or_None ,
2607- description = "line width of the legend frame, None means inherit from "
2608- "patch.linewidth"
2611+ description = "Line width of the legend frame. None uses 'patch.linewidth'."
26092612 ),
26102613 _Param (
26112614 "legend.fancybox" ,
26122615 default = True ,
26132616 type = bool ,
26142617 validator = validate_bool ,
2615- description = "if True, use a rounded box for the legend background, else a "
2616- "rectangle"
2618+ description = "If True, use a rounded box for the legend box, otherwise a "
2619+ "rectangle. See the *fancybox* parameter of `.Legend`. "
26172620 ),
26182621 _Param (
26192622 "legend.shadow" ,
26202623 default = False ,
26212624 type = bool ,
26222625 validator = validate_bool ,
2623- description = "if True, give background a shadow effect "
2626+ description = "Whether to draw a shadow behind the legend. "
26242627 ),
26252628 _Param (
26262629 "legend.numpoints" ,
26272630 default = 1 ,
26282631 type = int ,
26292632 validator = validate_int ,
2630- description = "the number of marker points in the legend line"
2633+ description = "Number of marker points in the legend when creating a legend "
2634+ "entry for a `.Line2D` (line)."
26312635 ),
26322636 _Param (
26332637 "legend.scatterpoints" ,
26342638 default = 1 ,
26352639 type = int ,
26362640 validator = validate_int ,
2637- description = "number of scatter points"
2641+ description = "Number of scatter points in the legend when creating a legend "
2642+ "entry for a `.PathCollection` (scatter plot)."
26382643 ),
26392644 _Param (
26402645 "legend.markerscale" ,
26412646 default = 1.0 ,
26422647 type = float ,
26432648 validator = validate_float ,
2644- description = "the relative size of legend markers vs. original "
2649+ description = "Relative size of legend markers compared to the data markers. "
26452650 ),
26462651 _Param (
26472652 "legend.fontsize" ,
26482653 default = "medium" ,
26492654 type = _FontSizeType ,
26502655 validator = validate_fontsize ,
2651- description = "The font size of legend text."
2656+ description = "Font size of legend text."
26522657 ),
26532658 _Param (
26542659 "legend.labelcolor" ,
26552660 default = "None" ,
26562661 type = ':mpltype:`color` or {"linecolor", "markerfacecolor", "markeredgecolor"}' ,
26572662 validator = _validate_color_or_linecolor ,
2658- description = "The color of the labels in legend entries. The special values "
2663+ description = "Color of the labels in legend entries. The special values "
26592664 "'linecolor', 'markerfacecolor', and 'markeredgecolor' "
26602665 "infer the color from the associated legend handle; i.e. using "
26612666 "'linecolor' will render the label of a red line also in red."
@@ -2665,55 +2670,57 @@ class _Subsection:
26652670 default = None ,
26662671 type = _FontSizeType | None ,
26672672 validator = validate_fontsize_None ,
2668- description = "None sets to the same as the default axes ."
2673+ description = "Font size of the legend title. None uses 'font.size' ."
26692674 ),
26702675 _Param (
26712676 "legend.borderpad" ,
26722677 default = 0.4 ,
26732678 type = float ,
26742679 validator = validate_float ,
2675- description = "border whitespace"
2680+ description = "Spacing between legend content and the border of the legend "
2681+ "box, in font-size units."
26762682 ),
26772683 _Param (
26782684 "legend.labelspacing" ,
26792685 default = 0.5 ,
26802686 type = float ,
26812687 validator = validate_float ,
2682- description = "the vertical space between the legend entries"
2688+ description = "Vertical spacing between the legend entries, in font-size units. "
26832689 ),
26842690 _Param (
26852691 "legend.handlelength" ,
26862692 default = 2.0 ,
26872693 type = float ,
26882694 validator = validate_float ,
2689- description = "the length of the legend lines "
2695+ description = "Length of the legend handles, in font-size units. "
26902696 ),
26912697 _Param (
26922698 "legend.handleheight" ,
26932699 default = 0.7 ,
26942700 type = float ,
26952701 validator = validate_float ,
2696- description = "the height of the legend handle "
2702+ description = "Height of the legend handles, in font-size units. "
26972703 ),
26982704 _Param (
26992705 "legend.handletextpad" ,
27002706 default = 0.8 ,
27012707 type = float ,
27022708 validator = validate_float ,
2703- description = "the space between the legend line and legend text"
2709+ description = "The pad between the legend handle and text, in font-size units. "
27042710 ),
27052711 _Param (
27062712 "legend.borderaxespad" ,
27072713 default = 0.5 ,
27082714 type = float ,
27092715 validator = validate_float ,
2710- description = "the border between the axes and legend edge "
2716+ description = "The pad between the axes and legend border, in font-size units. "
27112717 ),
27122718 _Param (
27132719 "legend.columnspacing" ,
27142720 default = 2.0 ,
27152721 type = float ,
2716- validator = validate_float , description = "column separation"
2722+ validator = validate_float ,
2723+ description = "The spacing between columns, in font-size units."
27172724 ),
27182725 _Section (
27192726 "Lines" ,
0 commit comments