avm2: Reword some comments

Author: Lord-McSweeney

core/src/avm2/globals.rs

@@ -441,8 +441,9 @@ pub fn load_player_globals<'gc>(
     // everything has to circularly reference everything else:
     //
     //  - Object is an instance of itself, as well as its prototype
-    //  - All other types are instances of Class, which is an instance of
-    //    itself
+    //  - All types are instances of Class, which is an instance of itself
+    //  - Object has prototype methods, but creating them requires the Function
+    //    class, and creating the Function class requires the Object class to exist
     //
     // Hence, this ridiculously complicated dance of classdef, type allocation,
     // and partial initialization.

core/src/avm2/globals/object.rs

@@ -10,8 +10,7 @@ use crate::avm2::value::Value;
 use crate::avm2::{Error, Multiname, QName};
 use crate::string::AvmString;
 
-/// Implements `Object`'s instance initializer. This method is unreachable because
-/// `Object` has a custom constructor (`object_constructor`).
+/// Implements `Object`'s instance initializer.
 fn instance_init<'gc>(
     _activation: &mut Activation<'_, 'gc>,
     _this: Value<'gc>,
@@ -20,7 +19,8 @@ fn instance_init<'gc>(
     Ok(Value::Undefined)
 }
 
-/// Implements `Object`'s custom constructor.
+/// Implements `Object`'s custom constructor, called when ActionScript code runs
+/// `new Object(...)` directly.
 fn object_constructor<'gc>(
     activation: &mut Activation<'_, 'gc>,
     args: &[Value<'gc>],