make README clearer

jcupitt · jcupitt · commit 3b4c8d6a02f1 · 2016-09-23T10:31:16.000+01:00
diff --git a/README.md b/README.md
@@ -53,17 +53,64 @@ I used 7.0.11 and configured with:
 
 ```
 $ ./configure --prefix=/home/john/vips --enable-debug --enable-maintainer-zts \
-	--enable-cgi --enable-cli --with-readline --with-openssl --with-zlib \
-	 --with-gd --with-jpeg-dir=/usr
+    --enable-cgi --enable-cli --with-readline --with-openssl --with-zlib \
+    --with-gd --with-jpeg-dir=/usr
 ```
 
-You'll need libvips 8.0 or later, including all the headers for development. 
-On linux, install with your package manager.
-On OS X, install with `brew` or MacPorts. For Windows, download a zip from 
-the libvips
-website, or build your own. 
+You'll need libvips 8.0 or later, including all the headers for
+development.  On linux, install with your package manager.  On OS X,
+install with `brew` or MacPorts. For Windows, download a zip from the
+libvips website, or build your own.
 
-### Regenerate build system
+### Installing
+
+```
+$ pear package
+```
+
+to make `vips-0.1.0.tgz`, then:
+
+```
+$ pear install vips-0.1.0.tgz
+```
+
+to install.
+
+Add:
+
+```
+extension=vips.so
+```
+
+to your `php.ini`, perhaps in `~/vips/lib/php.ini`, if you configured php as
+above. 
+
+### Using
+
+Try:
+
+```php
+#!/usr/bin/env php
+<?php
+if (!extension_loaded("vips")) {
+    dl('vips.' . PHP_SHLIB_SUFFIX);
+}
+
+$x = vips_image_new_from_file($argv[1])["out"];
+$x = vips_call("invert", $x)["out"];
+vips_image_write_to_file($x, $argv[2]);
+?>
+```
+
+And run with:
+
+```
+$ ./try1.php ~/pics/k2.jpg x.tif
+```
+
+See `examples/`.
+
+### Development: regenerate build system
 
 Run:
 
@@ -73,7 +120,7 @@ $ phpize
 
 To scan `config.m4` and your php install and regenerate the build system.
 
-### Configuring
+### Development: configure
 
 Run
 
@@ -84,7 +131,7 @@ $ ./configure
 Check the output carefully for errors, and obviously check that it found your
 libvips.
 
-### Installing
+### Development: make, test and install
 
 Run:
 
@@ -116,31 +163,6 @@ Finally, install to your php extensions area with:
 $ make install
 ```
 
-### Using
-
-Try:
-
-```php
-#!/usr/bin/env php
-<?php
-if (!extension_loaded("vips")) {
-    dl('vips.' . PHP_SHLIB_SUFFIX);
-}
-
-$x = vips_image_new_from_file($argv[1])["out"];
-$x = vips_call("invert", $x)["out"];
-vips_image_write_to_file($x, $argv[2]);
-?>
-```
-
-And run with:
-
-```
-$ ./try1.php ~/pics/k2.jpg x.tif
-```
-
-See `examples/`.
-
 ### Links
 
 http://php.net/manual/en/internals2.php
@@ -150,26 +172,3 @@ https://devzone.zend.com/303/extension-writing-part-i-introduction-to-php-and-ze
 https://devzone.zend.com/317/extension-writing-part-ii-parameters-arrays-and-zvals/
 
 https://devzone.zend.com/446/extension-writing-part-iii-resources/
-
-### Packaging
-
-```
-$ pear package
-```
-
-to make `vips-0.1.0.tgz`, then:
-
-```
-$ pear install vips-0.1.0.tgz
-```
-
-to install.
-
-Add:
-
-```
-extension=vips.so
-```
-
-to your `php.ini`, perhaps in `~/vips/lib/php.ini`, if you configured php as
-above. 
