more docs and history.md notes

History.md

@@ -82,11 +82,15 @@ MISC
 
 * Check that the argument to `EJSON.parse` is a string.  #1401
 
+* `EJSON.stringify` now takes options: #1136
+  - `canonical` causes objects keys to be stringified in sorted order
+  - `indent` allows formatting control over the EJSON stringification
+
+* EJSON now supports `Infinity`, `-Infinity` and `NaN`.
+
 * Better error from functions that use `Meteor._wrapAsync` (eg collection write
   methods and `HTTP` methods) and in DDP server message processing.  #1387
 
-* XXX: Does appconfig branch have any visible effects that need to be here?
-
 * Support `appcache` on Chrome for iOS.
 
 * Support literate CoffeeScript files with the extension `.coffee.md` (in

docs/client/api.js

@@ -98,7 +98,7 @@ Template.api.ejsonStringify = {
      descr: "Indents objects and arrays for easy readability.  When `true`, indents by 2 spaces; when an integer, indents by that number of spaces; and when a string, uses the string as the indentation pattern."},
     {name: "canonical",
      type: "Boolean",
-     descr: "Stringifies keys in an object in sorted order.  Without this option, object keys are emitted in the native JSON stringifier's order."}
+     descr: "When `true`, stringifies keys in an object in sorted order."}
   ],
   descr: ["Serialize a value to a string.\n\nFor EJSON values, the serialization " +
           "fully represents the value. For non-EJSON values, serializes the " +
@@ -131,7 +131,7 @@ Template.api.ejsonEquals = {
   options: [
     {name: "keyOrderSensitive",
      type: "Boolean",
-     descr: "Compare in key sensitive order, if supported by the JavaScript implementation.  For example, `{a: 1, b: 2}` is not equal to `{b: 2, a: 1}` with this option, but they are equal when this option is not specified."}
+     descr: "Compare in key sensitive order, if supported by the JavaScript implementation.  For example, `{a: 1, b: 2}` is equal to `{b: 2, a: 1}` only when `keyOrderSensitive` is `false`.  The default is `false`."}
   ],
   descr: ["Return true if `a` and `b` are equal to each other.  Return false otherwise." +
           "  Uses the `equals` method on `a` if present, otherwise performs a deep comparison."]