DOC: add markerstyles

jklymak · jklymak · commit 2e0c2bb020ac · 2021-11-16T19:59:45.000+01:00
diff --git a/tutorials/introductory/usage.py b/tutorials/introductory/usage.py
@@ -260,8 +260,19 @@ def my_plotter(ax, data1, data2, param_dict):
 # Marker size depends on the method being used.  `~.Axes.plot` specifies
 # markersize in points, and is generally the "diameter" or width of the
 # marker.  `~.Axes.scatter` specifies markersize as approximately
-# proportional to the visual area of the marker.
-#
+# proportional to the visual area of the marker.  There are also an array of
+# markerstyles available as string codes (see :mod:`~.matplotlib.markers`) or
+# users can define their own `~.MarkerStyle` (see
+# :doc:`/gallery/lines_bars_markers/marker_reference`):
+
+fig, ax = plt.subplots(figsize=(5, 2.7))
+ax.plot(data1, 'o', label='data1')
+ax.plot(data2, 'd', label='data2')
+ax.plot(data3, 'v', label='data3')
+ax.plot(data4, 's', label='data4')
+ax.legend()
+
+################################################################################
 #
 # Labelling plots
 # ===============
