Merge pull request matplotlib#25110 from eerovaher/recommend-ncols

Stop recommending `ncol` in legend examples

Author: ksunden

examples/lines_bars_and_markers/horizontal_barchart_distribution.py

@@ -60,7 +60,7 @@ def survey(results, category_names):
         r, g, b, _ = color
         text_color = 'white' if r * g * b < 0.5 else 'darkgrey'
         ax.bar_label(rects, label_type='center', color=text_color)
-    ax.legend(ncol=len(category_names), bbox_to_anchor=(0, 1),
+    ax.legend(ncols=len(category_names), bbox_to_anchor=(0, 1),
               loc='lower left', fontsize='small')
 
     return fig, ax

examples/text_labels_and_annotations/legend_demo.py

@@ -47,7 +47,7 @@
 for n in range(1, 5):
     ax0.plot(x, x**n, label=f"{n=}")
 leg = ax0.legend(loc="upper left", bbox_to_anchor=[0, 1],
-                 ncol=2, shadow=True, title="Legend", fancybox=True)
+                 ncols=2, shadow=True, title="Legend", fancybox=True)
 leg.get_title().set_color("red")
 
 # Demonstrate some more complex labels.

examples/user_interfaces/mplcvd.py

@@ -295,5 +295,5 @@ def _setup_wx(tb):
     th = np.linspace(0, 2*np.pi, 1024)
     for j in [1, 2, 4, 6]:
         axd['lines'].plot(th, np.sin(th * j), label=f'$\\omega={j}$')
-    axd['lines'].legend(ncol=2, loc='upper right')
+    axd['lines'].legend(ncols=2, loc='upper right')
     plt.show()

examples/userdemo/simple_legend01.py

@@ -15,7 +15,7 @@
 # Place a legend above this subplot, expanding itself to
 # fully use the given bounding box.
 ax.legend(bbox_to_anchor=(0., 1.02, 1., .102), loc='lower left',
-           ncol=2, mode="expand", borderaxespad=0.)
+           ncols=2, mode="expand", borderaxespad=0.)
 
 ax = fig.add_subplot(223)
 ax.plot([1, 2, 3], label="test1")

tutorials/intermediate/legend_guide.py

@@ -127,7 +127,7 @@
 # Place a legend above this subplot, expanding itself to
 # fully use the given bounding box.
 ax_dict['top'].legend(bbox_to_anchor=(0., 1.02, 1., .102), loc='lower left',
-                      ncol=2, mode="expand", borderaxespad=0.)
+                      ncols=2, mode="expand", borderaxespad=0.)
 
 ax_dict['bottom'].plot([1, 2, 3], label="test1")
 ax_dict['bottom'].plot([3, 2, 1], label="test2")