Improve readme. Add remove_all function to mac as unimplemented.

Cargo.toml

@@ -2,7 +2,6 @@
 name = "trash"
 version = "0.1.0"
 authors = ["Artur Kovacs <kovacs.artur.barnabas@gmail.com>"]
-license = "MIT"
 license-file = "LICENSE.TXT"
 readme = "Readme.md"
 description = "A Rust library for moving files to the Recycle Bin"

Readme.md

@@ -1,6 +1,32 @@
 
+[![Crates.io](https://img.shields.io/crates/v/trash.svg)](https://crates.io/crates/trash)
+
 ## About
 
-Trash is a Rust library that provides functionality to move files to the operating system's Recycle Bin.
+Trash is a Rust library that provides functionality to move files and folders to the operating system's Recycle Bin (or Trash or Rubbish Bin or what have you).
+
+The library currently supports Windows and Linux. Contribution to MacOS support would be very much appretiated.
+
+## Usage
+
+```rust
+extern crate trash;
+use std::fs::File;
+
+fn main() {
+    // Let's create and remove a single file
+    File::create("remove-me").unwrap();
+    trash::remove("remove-me").unwrap();
+    assert!(File::open("remove-me").is_err());
 
-Note that this libaray is in early development. It is planned to be multi-platform but I only have a Windows and a Linux system, so creating a pull request with MacOS support would be very much appretiated.
+    // Now let's remove multiple files at once
+    let the_others = ["remove-me-too", "dont-forget-about-me-either"];
+    for name in the_others.iter() {
+        File::create(name).unwrap();
+    }
+    trash::remove_all(&the_others).unwrap();
+    for name in the_others.iter() {
+        assert!(File::open(name).is_err());
+    }
+}
+```

src/lib.rs

@@ -33,7 +33,7 @@ pub enum Error {
     },
 }
 
-/// Removes a single file.
+/// Removes a single file or directory.
 /// 
 /// # Example
 /// 
@@ -49,7 +49,7 @@ pub fn remove<T: AsRef<Path>>(path: T) -> Result<(), Error> {
     platform::remove(path)
 }
 
-/// Removes all files specified by the collection of paths provided as an argument.
+/// Removes all files/directories specified by the collection of paths provided as an argument.
 /// 
 /// # Example
 /// 

src/macos.rs

@@ -7,6 +7,14 @@ pub fn is_implemented() -> bool {
     false
 }
 
+pub fn remove_all<I, T>(paths: I) -> Result<(), Error>
+where
+    I: IntoIterator<Item = T>,
+    T: AsRef<Path>,
+{
+    unimplemented!();
+}
+
 pub fn remove<T: AsRef<Path>>(path: T) -> Result<(), Error> {
     unimplemented!();
 }