README clarifications

README.md

@@ -23,15 +23,15 @@ caml!(build_tuple(i) {
 });
 
 caml!(average(arr) {
-    let arr = Array::new(arr);
+    let arr = Array::from(arr);
     let len = arr.len();
     let sum = 0f64;
 
     for i in 0..len {
         sum += arr.get_double_unchecked(i);
     }
 
-    return Value::f64(sum / len as f64);
+    Value::f64(sum / len as f64)
 })
 ```
 
@@ -54,19 +54,24 @@ Instead of:
 
 ```rust
 caml!(function_name, |a, b, c|, <local> {
-  ...
+    ...
 } -> local);
 ```
 
 you can now write:
 
 ```rust
 caml!(function_name(a, b, c) {
-  caml_local!(local);
-  ...
-  return local;
-})
+    caml_local!(local);
+    ...
+    return local;
+});
 ```
 
-However, when using the type wrappers provided by `ocaml-rs` (`Array`, `List`, `Tuple`, `Str`, `Array1`, ...), `caml_local!` is already called internally.
+However, when using the type wrappers provided by `ocaml-rs` (`Array`, `List`, `Tuple`, `Str`, `Array1`, ...), `caml_local!` is already called internally. This means that the following is valid without having to declare a local value for the result:
+
+```rust
+caml!(example(a, b, c){
+    List::from(&[a, b, c])
+});
 ```

src/lib.rs

@@ -37,19 +37,18 @@
 //!     let i = i.val_i32();
 //!     Tuple::from(&[i + 1, i + 2, i + 3])
 //! });
-//! ```
-//! ```norun
+//!
 //! caml!(average(arr) {
-//!     let arr = Array::new(arr);
+//!     let arr = Array::from(arr);
 //!     let len = arr.len();
 //!     let sum = 0f64;
 //!
 //!     for i in 0..len {
 //!         sum += arr.get_double_unchecked(i);
 //!     }
 //!
-//!      return Value::f64(sum / len as f64);
-//! })
+//!     Value::f64(sum / len as f64)
+//! });
 //! ```
 //!
 //! In OCaml the stubs for these functions looks like this:
@@ -59,7 +58,8 @@
 //! external average: float array -> float = "average"
 //! ```
 //!
-//! For more examples see [./example](https://github.com/zshipko/ocaml-rs/blob/master/example) or [ocaml-vec](https://github.com/zshipko/ocaml-vec).
+//! For more examples see [./example](https://github.com/zshipko/ocaml-rs/blob/master/example)
+//! or [ocaml-vec](https://github.com/zshipko/ocaml-vec).
 
 #[macro_use]
 mod macros;