Add missing docs

Author: prokopyl

src/handler.rs

@@ -86,7 +86,7 @@ pub trait WindowHandler: 'static {
     /// The goal is for all external update logic to be contained within this method.
     /// Therefore, this method will be called in various cases, including (but not limited to):
     ///
-    /// * As a result of calling [`Window::request_poll`], at the platform's earliest convenience;
+    /// * As a result of calling [`Window::request_poll`] or [`WindowWaker::request_poll`], at the platform's earliest convenience;
     /// * Whenever a new frame has been scheduled, right before actually calling [`WindowHandler::draw`].
     ///
     /// This all means that this method will be invoked very regularly, possibly multiple times per frame interval.

src/waker.rs

@@ -1,5 +1,10 @@
 use std::time::Duration;
 
+/// A simple, weak handle to the [`Window`](crate::Window), which can be used to "wake" it from
+/// external events or threads.
+///
+/// It can be cheaply [cloned](Clone) and [send](Send) to be used from other threads with minimal
+/// overhead.
 #[derive(Clone)]
 pub struct WindowWaker {
     pub(crate) inner: crate::platform::WindowWaker,
@@ -12,14 +17,18 @@ const _: () = {
 };
 
 impl WindowWaker {
+    /// Schedules a new frame to be drawn.
     pub fn request_redraw(&self) {
         self.inner.request_redraw()
     }
 
+    /// Schedules a new frame to be drawn after the given `duration`.
     pub fn request_redraw_after(&self, duration: Duration) {
         self.inner.request_redraw_after(duration)
     }
 
+    /// Schedules a call to the [`WindowHandler::poll`](crate::WindowHandler::poll) callback, at
+    /// the platform's earliest convenience.
     pub fn request_poll(&self) {
         self.inner.request_poll()
     }