From c4bfd1541640d65169327f9a750d8f50b55473df Mon Sep 17 00:00:00 2001
From: Molly Rossow <mrossow@chapinhall.org>
Date: Fri, 11 Jan 2019 12:36:46 -0600
Subject: [PATCH] Add explanatory comment for annotation box example

---
 .../demo_annotation_box.py                    | 29 +++++++++++++++++--
 1 file changed, 27 insertions(+), 2 deletions(-)

diff --git a/examples/text_labels_and_annotations/demo_annotation_box.py b/examples/text_labels_and_annotations/demo_annotation_box.py
index 9ffbc65b021a..e4576d3e6559 100644
--- a/examples/text_labels_and_annotations/demo_annotation_box.py
+++ b/examples/text_labels_and_annotations/demo_annotation_box.py
@@ -1,9 +1,14 @@
-"""
-===================
+"""===================
 Demo Annotation Box
 ===================
 
+The AnnotationBbox Artist creates an annotation using an OffsetBox. This
+example demonstrates three different OffsetBoxes: TextArea, DrawingArea and
+OffsetImage. AnnotationBbox gives more fine-grained control than using the axes
+method annotate.
+
 """
+
 import matplotlib.pyplot as plt
 import numpy as np
 
@@ -95,3 +100,23 @@
 ax.set_ylim(0, 1)
 
 plt.show()
+
+#############################################################################
+#
+# ------------
+#
+# References
+# """"""""""
+#
+# The use of the following functions, methods and classes is shown in this
+# example:
+
+Circle
+TextArea
+DrawingArea
+OffsetImage
+AnnotationBbox
+get_sample_data
+plt.subplots
+plt.imread
+plt.show