diff --git a/js/public/HeapAPI.h b/js/public/HeapAPI.h
index dc2a9f0449ae..3fb92ffaae81 100644
--- a/js/public/HeapAPI.h
+++ b/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 {
diff --git a/js/public/Initialization.h b/js/public/Initialization.h
index 8a1cf9101a1a..4d45d010334c 100644
--- a/js/public/Initialization.h
+++ b/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
diff --git a/js/src/jsapi.h b/js/src/jsapi.h
index 05a262364479..7a23aea5dfa2 100644
--- a/js/src/jsapi.h
+++ b/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.