small cleanups

TODO

@@ -1,3 +1,5 @@
+- try new binding with python3
+
 - use vips_resize() in vipsthumbnail?
 
   should the sharpening filter be selectable?

python/Makefile.am

@@ -4,4 +4,16 @@ pygioverrides_PYTHON = \
        Vips.py 
 
 EXTRA_DIST = \
-	README.txt
+	README.md
+
+# if we build in a separate tree, we need to symlink the *.py files from the
+# source tree; Python does not accept the extensions and modules in different
+# paths
+build_pylinks:
+	for f in $(pygioverrides_PYTHON); do \
+	    [ -e $(builddir)/$$f ] || $(LN_S) $(srcdir)/$$f $(builddir)/$$f; \
+	done
+
+all-local: build_pylinks
+check-local: build_pylinks
+

python/README.md

@@ -0,0 +1,15 @@
+# vips8 binding for Python
+
+This overrides file adds a few small helper functions to the 
+gobject-introspection binding for libvips.
+
+There's a chapter in the libvips API docs on these overrides, see "Using
+libvips from Python". 
+
+vips-x.y.z/test has a test suite. 
+
+Vips.py needs to be in the overrides directory of your gobject-introspection
+pygobject area, for example:
+
+    sudo cp Vips.py /usr/lib/python2.7/dist-packages/gi/overrides
+

python/README.txt

@@ -1,13 +0,0 @@
-vips8 binding for Python
-
-This binding adds a few small helper functions to the gobject-introspection
-binding for libvips.
-
-The test/ directory has a test suite. 
-
-Vips.py needs to be in the overrides directory of your gobject-introspection
-pygobject area, for example:
-
-sudo cp Vips.py /usr/lib/python2.7/dist-packages/gi/overrides
-
-

python/Vips.py

@@ -1,7 +1,12 @@
 # -*- Mode: Python; py-indent-offset: 4 -*-
 # vim: tabstop=4 shiftwidth=4 expandtab
 
-# copy this file to /usr/lib/python2.7/dist-packages/gi/overrides/
+# copy this file to /usr/lib/python2.7/dist-packages/gi/overrides, eg.
+# 
+#   sudo cp Vips.py /usr/lib/python2.7/dist-packages/gi/overrides
+#
+# Alternatively, build vips to another prefix, then copy Vips.py and Vips.pyc
+# from $prefix/lib/python2.7/dist-packages/gi/overrides to /usr
 
 # This file is part of VIPS.
 #