summaryrefslogtreecommitdiffstats
path: root/winit/src/lib.rs
diff options
context:
space:
mode:
Diffstat (limited to 'winit/src/lib.rs')
-rw-r--r--winit/src/lib.rs23
1 files changed, 23 insertions, 0 deletions
diff --git a/winit/src/lib.rs b/winit/src/lib.rs
index a708b1bd..0a2bf7dd 100644
--- a/winit/src/lib.rs
+++ b/winit/src/lib.rs
@@ -1,3 +1,26 @@
+//! A windowing shell for Iced, on top of [`winit`].
+//!
+//! ![`iced_winit` crate graph](https://github.com/hecrj/iced/blob/cae26cb7bc627f4a5b3bcf1cd023a0c552e8c65e/docs/graphs/winit.png?raw=true)
+//!
+//! `iced_winit` offers some convenient abstractions on top of [`iced_native`]
+//! to quickstart development when using [`winit`].
+//!
+//! It exposes a renderer-agnostic [`Application`] trait that can be implemented
+//! and then run with a simple call. The use of this trait is optional.
+//!
+//! Additionally, a [`conversion`] module is available for users that decide to
+//! implement a custom event loop.
+//!
+//! [`iced_native`]: https://github.com/hecrj/iced/tree/master/native
+//! [`winit`]: https://github.com/rust-windowing/winit
+//! [`Application`]: trait.Application.html
+//! [`conversion`]: conversion
+#![deny(missing_docs)]
+#![deny(missing_debug_implementations)]
+#![deny(unused_results)]
+#![deny(unsafe_code)]
+#![deny(rust_2018_idioms)]
+
#[doc(no_inline)]
pub use iced_native::*;
pub use winit;