Docs: add a separate page with examples

mgeier · mgeier · commit fb8ca298c1f5 · 2015-07-21T12:44:56.000+02:00
diff --git a/README.rst b/README.rst
@@ -213,17 +213,3 @@ Blocking Read/Write Streams
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Coming soon!
-
-More Examples
-^^^^^^^^^^^^^
-
-Have a look in the ``examples/`` directory.
-
-Copyright Information
----------------------
-
-python-sounddevice (MIT License)
-   Copyright (c) 2015 Matthias Geier
-
-PortAudio_ Portable Real-Time Audio Library (MIT License)
-   Copyright (c) 1999-2011 Ross Bencina and Phil Burk
diff --git a/doc/examples.rst b/doc/examples.rst
@@ -0,0 +1,11 @@
+:orphan:
+
+Example Program(s)
+==================
+
+Play a Sound File
+-----------------
+
+:download:`play_file.py <../examples/play_file.py>`
+
+.. literalinclude:: ../examples/play_file.py
diff --git a/doc/index.rst b/doc/index.rst
@@ -2,6 +2,13 @@
 
 .. include:: ../README.rst
 
+.. only:: html
+
+   More Examples
+   ^^^^^^^^^^^^^
+
+   For more examples, have a look at the :doc:`examples`.
+
 .. include:: ../CONTRIBUTING.rst
 
 .. default-role::
