README on how to run examples

diff --git a/examples/README.rst b/examples/README.rst
new file mode 100644 (file)
index 0000000..9c76280
--- /dev/null
+++ b/examples/README.rst
@@ -0,0 +1,17 @@
+
+========
+Examples
+========
+
+This directory contains pypol examples programs.
+
+Running Examples
+================
+
+To run the individual examples one needs to have Python version ≥ 3.4 installed and pypol must be in your ``PYTHONPATH`` environment variable.
+Most examples can be run from the command line ``python3`` and the name of the example::
+
+    vivien@bardo:~/pypol/examples$ export PYTHONPATH=$PWD/..:$PYTHONPATH
+    vivien@bardo:~/pypol/examples$ python3 squares.py
+
+Note: on most systems, the current directory is searched by Python automatically, so ``python3 examples/squares.py`` works from the pypol root directory, however there are systems (Ubuntu Intrepid) where this doesn't work by default, unless you put ``PYTHONPATH=.`` into your .bashrc for example.