diff -r 000000000000 -r cc66ad6b0d75 README
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README	Sat Mar 27 17:43:08 2010 +0000
@@ -0,0 +1,56 @@
+# XMOO Readme file.
+
+#Creating a new class
+In this example, we will create a torch.
+
+Start with the line:
+	classes.obj_torch = { } -- This creates an empty class
+
+What you call the class does not matter, it is not visible to users.
+
+Now we must define some things, such as its name, and what it looks like, its properties.
+
+	classes.obj_torch._properties = {
+								name = "torch",
+								longname = "An electric torch",
+								desc = "A small portable electric torch, to help you see when it is dark"
+							}
+							
+Simple, eh? :)
+
+Now, we want the user to be able to do things with the torch, let's say that 'twisting' it, switches it on and off.
+So we must define the method 'twist':
+
+	function classes.obj_torch:twist(info)
+		
+	end
+
+info is a variable we get, that contains information useful to use, such as who twisted it (info.person), and what room we are in (info.room), etc.
+
+Now we must also keep track of whether the torch is lit or unlit. We will store this as a property. In a method, 'self' always refers to the curent object.
+
+	function classes.obj_torch:twist(info)
+		if self._properties.state == "lit" then self._properties.state == "unlit" -- if it is lit, make it unlit
+		else self._properties.state == "lit" end -- Otherwise, make it lit
+	end
+
+Very good, but we must show everyone in the room what is going on:
+
+	function classes.obj_torch:twist(info)
+		if self._properties.state == "lit" then 
+			self._properties.state == "unlit" -- if it is lit, make it unlit
+			self._properties.desc = "A small portable electric torch, to help you see when it is dark. It is not lit."
+			info.person:_say("/me turns off the torch")
+		else
+			self._properties.state == "lit" -- Otherwise, make it lit
+			self._properties.desc = "A small portable electric torch, to help you see when it is dark. It is lit."
+			info.person:_say("/me lights the torch")
+		end 
+	end
+
+As you can see, the colon ':' is used to call methods, or functions of another object. Remember that people are objects too!
+The default 'look' method uses the 'desc' property, so we have changed it, to show whether the torch is lit or not.
+
+It's done!
+
+More to come, including creating new rooms :)
\ No newline at end of file