From 2f52000b10526dd214e0e4d51e019f1619fe99ba Mon Sep 17 00:00:00 2001
From: Vivien Maisonneuve <v.maisonneuve@gmail.com>
Date: Wed, 25 Jun 2014 18:11:07 +0200
Subject: [PATCH 1/1] README on how to run examples

---
 examples/README.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 examples/README.rst

diff --git a/examples/README.rst b/examples/README.rst
new file mode 100644
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.
-- 
2.20.1