Bug 1380768 (part 1) - Update comments to reflect API changes and a changed, r=sfink.

js/public/HeapAPI.h

@@ -104,7 +104,7 @@ struct Zone;
 /* Default size for the generational nursery in bytes. */
 const uint32_t DefaultNurseryBytes = 16 * js::gc::ChunkSize;
 
-/* Default maximum heap size in bytes to pass to JS_NewRuntime(). */
+/* Default maximum heap size in bytes to pass to JS_NewContext(). */
 const uint32_t DefaultHeapMaxBytes = 32 * 1024 * 1024;
 
 namespace shadow {

js/public/Initialization.h

@@ -50,7 +50,7 @@ JS_SetICUMemoryFunctions(JS_ICUAllocFn allocFn,
 
 /**
  * Initialize SpiderMonkey, returning true only if initialization succeeded.
- * Once this method has succeeded, it is safe to call JS_NewRuntime and other
+ * Once this method has succeeded, it is safe to call JS_NewContext and other
  * JSAPI methods.
  *
  * This method must be called before any other JSAPI method is used on any

js/src/jsapi.h

@@ -999,7 +999,7 @@ JS_IsBuiltinFunctionConstructor(JSFunction* fun);
  * It is important that SpiderMonkey be initialized, and the first context
  * be created, in a single-threaded fashion.  Otherwise the behavior of the
  * library is undefined.
- * See: http://developer.mozilla.org/en/docs/Category:JSAPI_Reference
+ * See: https://developer.mozilla.org/en-US/docs/Mozilla/Projects/SpiderMonkey/JSAPI_reference
  */
 
 // Create a new runtime, with a single cooperative context for this thread.