diff --git a/README.md b/README.md
index 8f6f949..d722130 100644
--- a/README.md
+++ b/README.md
@@ -34,9 +34,10 @@ The easiest way to install tippecanoe on OSX is with [Homebrew](http://brew.sh/)
Usage
-----
- tippecanoe -o file.mbtiles [file.json]
+ tippecanoe -o file.mbtiles [file.json ...]
-If the file is not specified, it reads GeoJSON from the standard input.
+If no files are specified, it reads GeoJSON from the standard input.
+If multiple files are specified, each is placed in its own layer.
The GeoJSON features need not be wrapped in a FeatureCollection.
You can concatenate multiple GeoJSON features or files together,
@@ -46,18 +47,33 @@ it encounters.
Options
-------
- * -l name: Layer name (default "file" if source is file.json)
+### Naming
+
+ * -l name: Layer name (default "file" if source is file.json or output is file.mbtiles). Only works if there is only one layer.
* -n name: Human-readable name (default file.json)
+
+### File control
+
+ * -o file.mbtiles: Name the output file.
+ * -f: Delete the mbtiles file if it already exists instead of giving an error
+
+### Zoom levels and resolution
+
* -z zoom: Base (maxzoom) zoom level (default 14)
* -Z zoom: Lowest (minzoom) zoom level (default 0)
* -d detail: Detail at base zoom level (default 26-basezoom, ~0.5m, for tile resolution of 4096 if -z14)
* -D detail: Detail at lower zoom levels (default 10, for tile resolution of 1024)
+ * -b pixels: Buffer size where features are duplicated from adjacent tiles (default 5)
+
+### Properties
+
* -x name: Exclude the named properties from all features
* -y name: Include the named properties in all features, excluding all those not explicitly named
* -X: Exclude all properties and encode only geometries
- * -f: Delete the mbtiles file if it already exists instead of giving an error
+
+### Point simplification
+
* -r rate: Rate at which dots are dropped at lower zoom levels (default 2.5)
- * -b pixels: Buffer size where features are duplicated from adjacent tiles (default 5)
* -g gamma: Rate at which especially dense dots are dropped (default 0, for no effect). A gamma of 2 reduces the number of dots less than a pixel apart to the square root of their original number.
Example