diff --git a/README.md b/README.md
index c16721a0c3..071a01a9dc 100644
--- a/README.md
+++ b/README.md
@@ -44,11 +44,11 @@
  - [Destructuring](FEATURES.md#destructuring)
  - [For-of](FEATURES.md#for-of)
  - [Modules](FEATURES.md#modules)
- - [Numeric Literals](FEATURES.md#numeric-literals)
- - [Spread](FEATURES.md#spread)
+ - [Numeric literals](FEATURES.md#numeric-literals)
  - [Property method assignment](FEATURES.md#property-method-assignment)
  - [Property name shorthand](FEATURES.md#property-name-shorthand)
  - [Rest parameters](FEATURES.md#rest-parameters)
+ - [Spread](FEATURES.md#spread)
  - [Template literals](FEATURES.md#template-literals)
 
 To be implemented:
@@ -82,9 +82,9 @@ var to5 = require("6to5");
 
 to5.transform("code();");
 
-to5.transformFileSync("script.js");
+to5.transformFileSync("filename.js");
 
-to5.transformFile("script.js", function (err, data) {
+to5.transformFile("filename.js", function (err, data) {
 
 });
 ```
@@ -105,6 +105,9 @@ to5.transform("code();", {
   // Append source map and comment to bottom of returned output.
   sourceMap: false,
 
+  // Returns an object `{ code: "", map: {} }` instead of an appended string.
+  sourceMapObject: false,
+
   // Filename for use in errors etc.
   filename: "unknown",
 
@@ -154,6 +157,8 @@ browserify()
 
 ### For-of
 
+Iterator/Symbol polyfill required.
+
 ### Classes
 
 Cannot subclass built-ins such as `Date`, `Array`, `DOM` etc.