Comment elaboration.

game/gamesrc/parents/examples/red_button.py

@@ -15,7 +15,9 @@ def cmd_push_button(command):
 class RedButton(BasicObject):
     def __init__(self, scripted_obj, *args, **kwargs):
         """
-        
+        This is called when class_factory() instantiates a temporary instance
+        of the script parent. This is typically not something you want to
+        mess with much.
         """
         # Calling the super classes __init__ is critical! Never forget to do
         # this or everything else from here on out will fail.

src/script_parents/basicobject.py

@@ -18,6 +18,7 @@ class EvenniaBasicObject(object):
         most Python objects. This is only called when the script parent is
         cached or recalled on an object. This means that this function is not
         called until someone does something to warrant calling get_scriptlink().
+        This happens very often, so nothing too intense should be done here.
         
         If you're wanting to do something on object/player creation, override
         at_object_creation() (in basicobject.py) or at_player_creation()