some more documentation tweaking

carhartl · carhartl · commit e60f7e8ce141 · 2012-07-07T19:34:58.000+02:00
diff --git a/README.md b/README.md
@@ -18,29 +18,29 @@ Create expiring cookie, 7 days from then:
 
     $.cookie('the_cookie', 'the_value', { expires: 7 });
 
-Create expiring cookie, valid across entire page:
+Create expiring cookie, valid across entire site:
 
     $.cookie('the_cookie', 'the_value', { expires: 7, path: '/' });
 
 Read cookie:
 
-    $.cookie('the_cookie'); // => 'the_value'
-    $.cookie('the_cookie', {raw: true}); // => 'the_value' NOT URL decoded
+    $.cookie('the_cookie'); // => "the_value"
+    $.cookie('the_cookie', { raw: true }); // => "the_value" not URL decoded
     $.cookie('not_existing'); // => null
 
 Delete cookie by passing null as value:
 
     $.cookie('the_cookie', null);
 
-*Note: when deleting a cookie, you must pass the exact same path, domain and secure options that were used to set the cookie.*
+*Note: when deleting a cookie, you must pass the exact same path, domain and secure options that were used to set the cookie, unless you're relying on the default options that is.*
 
 ## Options
 
 Options can be set globally by setting properties of the `$.cookie.defaults` object or individually for each call to `$.cookie()` by passing a plain object to the options argument. Per-call options override the ones set by `$.cookie.defaults`.
 
     expires: 365
 
-Define lifetime of the cookie. Value can be a `Number` (which will be interpreted as days from time of creation) or a `Date` object. If omitted, the cookie becomes a session cookie.
+Define lifetime of the cookie. Value can be a `Number` which will be interpreted as days from time of creation or a `Date` object. If omitted, the cookie becomes a session cookie.
 
     path: '/'
 
@@ -56,7 +56,7 @@ If true, the cookie transmission requires a secure protocol (https). Default: `f
 
     raw: true
 
-By default the cookie is encoded/decoded when creating/reading, using `encodeURIComponent`/`decodeURIComponent`. Turn off by setting `raw: true`. Default: `false`.
+By default the cookie value is encoded/decoded when creating/reading, using `encodeURIComponent`/`decodeURIComponent`. Turn off by setting `raw: true`. Default: `false`.
 
 ## Changelog
 
