Document need to tick clock when using pyglet audio outside of pyglet app
@@ -508,3 +508,15 @@ describe the position of the user in 3D space.
Note that only mono sounds can be positioned. Stereo sounds will play back as
normal, and only their volume and pitch properties will affect the sound.
+
+Ticking the clock
+----------------
+
+If you are using pyglet's media libraries outside of a pyglet app, you will need
+to use some kind of loop to tick the pyglet clock periodically (perhaps every
+200ms or so), otherwise only the first small sample of media will be played:
+
+ pyglet.clock.tick()
+
+If you are inside a pyglet app then calling `pyglet.app.run()` takes care of
+this for you.
