From 132a640df2176b40a5ee1d88fe44fa844f5877fc Mon Sep 17 00:00:00 2001
From: Jonathan Turner <jonathandturner@users.noreply.github.com>
Date: Wed, 2 Mar 2016 14:53:12 -0500
Subject: [PATCH] Update README.md

---
 README.md | 46 +++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 43 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index c804a441..dcaceedb 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,8 @@
 # Rhai - embedded scripting for Rust
 
-Rhai is a simple embedded scripting language for Rust that doesn't use any additional dependencies, unsafe code, or a set of APIs outside of what you provide in your program.  This allows you to have rich control over the functionality exposed to the scripting context.
+Rhai is a simple embedded scripting language for Rust.  Thou that doesn't use any additional dependencies, unsafe code, or a set of APIs outside of what you provide in your program.  This allows you to have rich control over the functionality exposed to the scripting context.
+
+
 
 Currently, it's pre-0.1, and is likely to change a bit before it stabilizes enough for a crates.io release.
 
@@ -13,10 +15,48 @@ if let Ok(result) = engine.eval("40 + 2".to_string()).unwrap().downcast::<i32>()
     println!("Answer: {}", *result);  // prints 42
 }
 ```
+# Example 2: Working with functions
 
-# Example 2: Working with Rust
+Rhai's scripting engine is very lightweight.  It gets its ability from the functions in your program.  To call these functions, you need to register them with the scripting engine.
+
+```Rust
+fn add(x: i32, y: i32) -> i32 {
+    x + y
+}
+
+fn main() {
+    let mut engine = Engine::new();
+
+    &(add as fn(x: i32, y: i32)->i32).register(&mut engine, "add");
+ 
+    if let Ok(result) = engine.eval("add(40, 2)".to_string()).unwrap().downcast::<i32>() {
+       println!("Answer: {}", *result);  // prints 42
+    }
+}
+```
+
+# Example 3: Working with generic functions
+
+Generic functions can be used in Rhai, but you'll need to register separate instances for each concrete type:
+
+```Rust
+fn showit<T: Display>(x: &mut T) -> () {
+    println!("{}", x)
+}
+
+fn main() {
+    let mut engine = Engine::new();
+
+    &(showit as fn(x: &mut i32)->()).register(&mut engine, "print");
+    &(showit as fn(x: &mut bool)->()).register(&mut engine, "print");
+    &(showit as fn(x: &mut String)->()).register(&mut engine, "print");
+}
+```
+
+# Example 4: Working with custom types and methods
 
 Here's an example of working with Rust.  First, the full example, and then we'll break it down:
+
 ```Rust
 #[derive(Debug, Clone)]
 struct TestStruct {
@@ -73,7 +113,7 @@ engine.register_type::<TestStruct>();
 
 To use methods and functions with the engine, we need to register them.  There are some convenience functions to help with this.  Below I register update and new with the engine.
 
-Note: the engine follows the convention that functions take ownership of all their parameters and methods take ownership of all but their first parameter (which is a &mut). 
+*Note: the engine follows the convention that methods use a &mut first parameter so that invoking methods can update the value in memory.*
 
 ```Rust
 &(TestStruct::update as fn(&mut TestStruct)->()).register(&mut engine, "update");