In this commit I am using an editor feature called "Save All" before I commit.

OpenSim/Region/ScriptEngine/Common/LSL_Types.cs

@@ -33,6 +33,9 @@ namespace OpenSim.Region.ScriptEngine.Common
     [Serializable]
     public class LSL_Types
     {
+
+        // Types are kept is separate .dll to avoid having to add whatever .dll it is in it to script AppDomain
+
         [Serializable]
         public struct Vector3
         {

OpenSim/Region/ScriptEngine/DotNetEngine/AppDomainManager.cs

@@ -36,6 +36,18 @@ namespace OpenSim.Region.ScriptEngine.DotNetEngine
 {
     public class AppDomainManager
     {
+
+        //
+        // This class does AppDomain handling and loading/unloading of scripts in it.
+        // It is instanced in "ScriptEngine" and controlled from "ScriptManager"
+        //
+        // 1. Create a new AppDomain if old one is full (or doesn't exist)
+        // 2. Load scripts into AppDomain
+        // 3. Unload scripts from AppDomain (stopping them and marking them as inactive)
+        // 4. Unload AppDomain completely when all scripts in it has stopped
+        //
+
+
         private int maxScriptsPerAppDomain = 1;
 
         /// <summary>

OpenSim/Region/ScriptEngine/DotNetEngine/Common.cs

@@ -33,6 +33,8 @@ namespace OpenSim.Region.ScriptEngine.DotNetEngine
         public static bool debug = true;
         public static ScriptEngine mySE;
 
+        // This class just contains some static log stuff used for debugging.
+
         //public delegate void SendToDebugEventDelegate(string Message);
         //public delegate void SendToLogEventDelegate(string Message);
         //static public event SendToDebugEventDelegate SendToDebugEvent;

OpenSim/Region/ScriptEngine/DotNetEngine/Compiler/LSL/LSL2CSConverter.cs

@@ -33,6 +33,10 @@ namespace OpenSim.Region.ScriptEngine.DotNetEngine.Compiler.LSL
 {
     public class LSL2CSConverter
     {
+
+
+        // Uses regex to convert LSL code to C# code.
+
         //private Regex rnw = new Regex(@"[a-zA-Z0-9_\-]", RegexOptions.Compiled);
         private Dictionary<string, string> dataTypes = new Dictionary<string, string>();
         private Dictionary<string, string> quotes = new Dictionary<string, string>();

OpenSim/Region/ScriptEngine/DotNetEngine/ScriptEngine.cs

@@ -35,8 +35,9 @@ using OpenSim.Region.Environment.Scenes;
 namespace OpenSim.Region.ScriptEngine.DotNetEngine
 {
     /// <summary>
-    /// This is the root object for ScriptEngine
+    /// This is the root object for ScriptEngine. Objects access each other trough this class.
     /// </summary>
+    /// 
     [Serializable]
     public class ScriptEngine : IRegionModule
     {