DOC: clarify why artists should be returned

phobson · phobson · commit 0a00e9a75eb1 · 2016-10-23T09:00:34.000-07:00
diff --git a/examples/statistics/errorbars_and_boxes.py b/examples/statistics/errorbars_and_boxes.py
@@ -13,11 +13,12 @@
   2. the function operates on the `Axes` methods directly, not through
      the `pyplot` interface
   3. plotting kwargs that could be abbreviated are spelled out for
-     better code readability in the figure (for example we use
+     better code readability in the future (for example we use
      `facecolor` instead of `fc`)
   4. the artists returned by the `Axes` plotting methods are then
      returned by the function so that, if desired, their styles
-     can be modified later (they are not modified in this example).
+     can be modified later outside of the function. (they are not
+     modified in this example).
 """
 
 import numpy as np
