fs: use async fn instead of custom futures (#1381)

Also update all the doc examples.

tokio-fs/src/remove_dir_all.rs

@@ -1,46 +1,13 @@
-use std::fs;
-use std::future::Future;
+use crate::asyncify;
+
 use std::io;
 use std::path::Path;
-use std::pin::Pin;
-use std::task::Context;
-use std::task::Poll;
 
 /// Removes a directory at this path, after removing all its contents. Use carefully!
 ///
 /// This is an async version of [`std::fs::remove_dir_all`][std]
 ///
 /// [std]: https://doc.rust-lang.org/std/fs/fn.remove_dir_all.html
-pub fn remove_dir_all<P: AsRef<Path>>(path: P) -> RemoveDirAllFuture<P> {
-    RemoveDirAllFuture::new(path)
-}
-
-/// Future returned by `remove_dir_all`.
-#[derive(Debug)]
-#[must_use = "futures do nothing unless you `.await` or poll them"]
-pub struct RemoveDirAllFuture<P>
-where
-    P: AsRef<Path>,
-{
-    path: P,
-}
-
-impl<P> RemoveDirAllFuture<P>
-where
-    P: AsRef<Path>,
-{
-    fn new(path: P) -> RemoveDirAllFuture<P> {
-        RemoveDirAllFuture { path }
-    }
-}
-
-impl<P> Future for RemoveDirAllFuture<P>
-where
-    P: AsRef<Path>,
-{
-    type Output = io::Result<()>;
-
-    fn poll(self: Pin<&mut Self>, _cx: &mut Context<'_>) -> Poll<Self::Output> {
-        crate::blocking_io(|| fs::remove_dir_all(&self.path))
-    }
+pub async fn remove_dir_all<P: AsRef<Path>>(path: P) -> io::Result<()> {
+    asyncify(|| std::fs::remove_dir_all(&path)).await
 }