Made suggested changes

Author: Impaler343

doc/users/next_whats_new/histogram_vectorized_parameters.rst

@@ -1,15 +1,15 @@
 Vectorized ``hist`` style parameters
 ------------------------------------
 
-The parameters ``hatch``, ``edgecolor``, ``facecolor``, ``linewidth`` and ``linestyle``
+The parameters *hatch*, *edgecolor*, *facecolor*, *linewidth* and *linestyle*
 of the `~matplotlib.axes.Axes.hist` method are now vectorized.
 This means that you can pass in individual parameters for each histogram
 when the input *x* has multiple datasets.
 
 
 .. plot::
     :include-source: true
-    :alt: Four charts, each displaying stacked histograms of three Poisson distributions. Each chart differentiates the histograms using various parameters: ax1 uses different linewidths, ax2 uses different hatches, ax3 uses different edgecolors, and ax4 uses different facecolors. Each histogram in ax1 and ax3 also has a different edgecolor.
+    :alt: Four charts, each displaying stacked histograms of three Poisson distributions. Each chart differentiates the histograms using various parameters: top left uses different linewidths, top right uses different hatches, bottom left uses different edgecolors, and bottom right uses different facecolors. Each histogram on the left side also has a different edgecolor.
 
     import matplotlib.pyplot as plt
     import numpy as np

galleries/examples/statistics/histogram_multihist.py

@@ -61,7 +61,7 @@
 #
 #
 # edgecolor
-# ...........................
+# .........
 
 fig, ax = plt.subplots()
 
@@ -76,7 +76,7 @@
 
 # %%
 # facecolor
-# ...........................
+# .........
 
 fig, ax = plt.subplots()
 
@@ -90,7 +90,7 @@
 
 # %%
 # hatch
-# .......................
+# .....
 
 fig, ax = plt.subplots()
 
@@ -104,7 +104,7 @@
 
 # %%
 # linewidth
-# ..........................
+# .........
 
 fig, ax = plt.subplots()
 
@@ -120,7 +120,7 @@
 
 # %%
 # linestyle
-# ..........................
+# .........
 
 fig, ax = plt.subplots()
 

lib/matplotlib/axes/_axes.py

@@ -6940,9 +6940,10 @@ def hist(self, x, bins=None, range=None, density=False, weights=None,
             `~matplotlib.patches.Patch` properties. The following properties
             additionally accept a sequence of values corresponding to the
             datasets in *x*:
-            *edgecolors*, *facecolors*, *linewidths*, *linestyles*, *hatches*.
+            *edgecolors*, *facecolors*, *lines*, *linestyles*, *hatches*.
 
             .. versionadded:: 3.10
+               Allowing sequences of values in above listed Patch properties.
 
         See Also
         --------

lib/matplotlib/tests/test_axes.py

@@ -4627,6 +4627,10 @@ def test_hist_vectorized_params(fig_test, fig_ref, kwargs):
 
 
 @pytest.mark.parametrize('kwargs, patch_face, patch_edge',
+                         # 'C0'(blue) stands for the first color of the
+                         # default color cycle as well as the patch.facecolor rcParam
+                         # When the expected edgecolor is 'k'(black),
+                         # it corresponds to the patch.edgecolor rcParam
                          [({'histtype': 'stepfilled', 'color': 'r',
                             'facecolor': 'y', 'edgecolor': 'g'}, 'y', 'g'),
                           ({'histtype': 'step', 'color': 'r',
@@ -4653,10 +4657,6 @@ def test_hist_vectorized_params(fig_test, fig_ref, kwargs):
                           ({'histtype': 'step'}, ('C0', 0), 'C0')])
 def test_hist_color_semantics(kwargs, patch_face, patch_edge):
     _, _, patches = plt.figure().subplots().hist([1, 2, 3], **kwargs)
-    # 'C0'(blue) stands for the first color of the default color cycle
-    # as well as the patch.facecolor rcParam
-    # When the expected edgecolor is 'k'(black), it corresponds to the
-    # patch.edgecolor rcParam
     assert all(mcolors.same_color([p.get_facecolor(), p.get_edgecolor()],
                                   [patch_face, patch_edge]) for p in patches)