Support marker="none" to mean "no marker".

anntzer · anntzer · commit bf547db8529f · 2021-09-12T16:44:41.000+02:00
As for other APIs, this is less likely to be confused with the None
object.
diff --git a/doc/users/next_whats_new/marker_none.rst b/doc/users/next_whats_new/marker_none.rst
@@ -0,0 +1,4 @@
+``marker`` can now be set to the string "none"
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+... to mean "no-marker", consistently with other APIs which support the
+lowercase version.
diff --git a/lib/matplotlib/legend_handler.py b/lib/matplotlib/legend_handler.py
@@ -566,7 +566,7 @@ def create_artists(self, legend, orig_handle,
             self.update_prop(legline, plotlines, legend)
 
             legline.set_drawstyle('default')
-            legline.set_marker('None')
+            legline.set_marker('none')
 
             self.update_prop(legline_marker, plotlines, legend)
             legline_marker.set_linestyle('None')
diff --git a/lib/matplotlib/markers.py b/lib/matplotlib/markers.py
@@ -45,7 +45,8 @@
 ``9`` (``CARETRIGHTBASE``)     |m34|  caretright (centered at base)
 ``10`` (``CARETUPBASE``)       |m35|  caretup (centered at base)
 ``11`` (``CARETDOWNBASE``)     |m36|  caretdown (centered at base)
-``"None"``, ``" "`` or  ``""``        nothing
+``"None"`` or ``"None"``              nothing
+``" "`` or  ``""``                    nothing
 ``'$...$'``                    |m37|  Render the string using mathtext.
                                       E.g ``"$f$"`` for marker showing the
                                       letter ``f``.
@@ -199,6 +200,7 @@ class MarkerStyle:
         CARETUPBASE: 'caretupbase',
         CARETDOWNBASE: 'caretdownbase',
         "None": 'nothing',
+        "none": 'nothing',
         None: 'nothing',
         ' ': 'nothing',
         '': 'nothing'
@@ -223,8 +225,7 @@ def __init__(self, marker=None, fillstyle=None):
         marker : str, array-like, Path, MarkerStyle, or None, default: None
             - Another instance of *MarkerStyle* copies the details of that
               ``marker``.
-            - *None* means no marker.
-            - For other possible marker values see the module docstring
+            - For other possible marker values, see the module docstring
               `matplotlib.markers`.
 
         fillstyle : str, default: 'full'
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
@@ -4117,8 +4117,9 @@ def test_eventplot_orientation(data, orientation):
 @image_comparison(['marker_styles.png'], remove_text=True)
 def test_marker_styles():
     fig, ax = plt.subplots()
-    for y, marker in enumerate(sorted(matplotlib.markers.MarkerStyle.markers,
-                                      key=lambda x: str(type(x))+str(x))):
+    for y, marker in enumerate(sorted(
+            {*matplotlib.markers.MarkerStyle.markers} - {"none"},
+            key=lambda x: str(type(x))+str(x))):
         ax.plot((y % 2)*5 + np.arange(10)*10, np.ones(10)*10*y, linestyle='',
                 marker=marker, markersize=10+y/5, label=marker)
 
