Bump version for release

Author: stouset

Cargo.toml

@@ -1,14 +1,14 @@
 [package]
 name    = "secrets"
-version = "0.0.0"
+version = "0.10.0"
 license = "MIT"
 
 authors     = ["Stephen Touset <stephen@touset.org>"]
 description = "Protected-access memory for cryptographic secrets"
 
 homepage      = "https://github.com/stouset/secrets"
+repository    = "https://github.com/stouset/secrets"
 documentation = "https://stouset.github.io/secrets"
-repository    = "git@github.com:stouset/secrets"
 readme        = "README.md"
 
 keywords = [ "crypto", "cryptography", "allocator" ]

README.md

@@ -21,7 +21,29 @@ Buffers allocated through this library:
 Example
 -------
 
-Coming soon. Library very much in flux.
+Generating a random secret:
+
+```rust
+use secrets::Secret;
+
+let secret   = Secret::random(32);
+let secret_r = secret.borrow();
+
+println!("{:?}", secret_r.as_slice());
+```
+
+Creating a secret from existing data:
+
+```rust
+use secrets::Secret;
+
+let mut string   = "password".to_string();
+let     secret   = Secret::from(unsafe { string.as_mut_vec() });
+let     secret_r = secret.borrow();
+
+println!("{}",   string);              // NUL bytes
+println!("{:?}", secret_r.as_slice()); // b"string"
+```
 
 Documentation
 -------------