diff --git a/examples/canvas/lines.py b/examples/canvas/lines.py
index ea7381dfa..0f83b419c 100644
--- a/examples/canvas/lines.py
+++ b/examples/canvas/lines.py
@@ -1,3 +1,16 @@
+'''
+Line (SmoothLine) Experiment
+============================
+
+This demonstrates the experimental and unfinished SmoothLine feature
+for fast line drawing.  You should see a multi-segment
+path at the top of the screen, and sliders and buttons along the bottom.
+You can click to add new points to the segment, change the transparency
+and width of the line, or hit 'Animate' to see a set of sine and cosine
+animations.   The Cap and Joint buttons don't work:  SmoothLine has not
+implemented these features yet.
+'''
+
 from kivy.app import App
 from kivy.properties import OptionProperty, NumericProperty, ListProperty, \
         BooleanProperty