Write missing docs and reenable deny statements

native/src/lib.rs

@@ -34,7 +34,7 @@
 //! [`Windowed`]: renderer/trait.Windowed.html
 //! [`UserInterface`]: struct.UserInterface.html
 //! [renderer]: renderer/index.html
-//#![deny(missing_docs)]
+#![deny(missing_docs)]
 #![deny(missing_debug_implementations)]
 #![deny(unused_results)]
 #![deny(unsafe_code)]

native/src/renderer.rs

@@ -44,6 +44,11 @@ pub trait Renderer: Sized {
     /// [`Renderer`]: trait.Renderer.html
     type Output;
 
+    /// The default styling attributes of the [`Renderer`].
+    ///
+    /// This type can be leveraged to implement style inheritance.
+    ///
+    /// [`Renderer`]: trait.Renderer.html
     type Defaults: Default;
 
     /// Lays out the elements of a user interface.

native/src/renderer/null.rs

@@ -11,6 +11,9 @@ use crate::{
 pub struct Null;
 
 impl Null {
+    /// Creates a new [`Null`] renderer.
+    ///
+    /// [`Null`]: struct.Null.html
     pub fn new() -> Null {
         Null
     }

native/src/renderer/windowed.rs

@@ -4,6 +4,7 @@ use raw_window_handle::HasRawWindowHandle;
 
 /// A renderer that can target windows.
 pub trait Windowed: super::Renderer + Sized {
+    /// The settings of the renderer.
     type Settings: Default;
 
     /// The type of target.

native/src/widget/button.rs

@@ -114,6 +114,9 @@ where
         self
     }
 
+    /// Sets the style of the [`Button`].
+    ///
+    /// [`Button`]: struct.Button.html
     pub fn style(mut self, style: impl Into<Renderer::Style>) -> Self {
         self.style = style.into();
         self
@@ -246,6 +249,7 @@ where
 /// [`Button`]: struct.Button.html
 /// [renderer]: ../../renderer/index.html
 pub trait Renderer: crate::Renderer + Sized {
+    /// The style supported by this renderer.
     type Style: Default;
 
     /// Draws a [`Button`].

native/src/widget/checkbox.rs

@@ -183,6 +183,7 @@ where
 /// [`Checkbox`]: struct.Checkbox.html
 /// [renderer]: ../../renderer/index.html
 pub trait Renderer: crate::Renderer {
+    /// The style supported by this renderer.
     type Style: Default;
 
     /// Returns the default size of a [`Checkbox`].

native/src/widget/container.rs

@@ -183,7 +183,15 @@ where
     }
 }
 
+/// The renderer of a [`Container`].
+///
+/// Your [renderer] will need to implement this trait before being
+/// able to use a [`Container`] in your user interface.
+///
+/// [`Container`]: struct.Container.html
+/// [renderer]: ../../renderer/index.html
 pub trait Renderer: crate::Renderer {
+    /// The style supported by this renderer.
     type Style: Default;
 
     /// Draws a [`Container`].

native/src/widget/progress_bar.rs

@@ -127,6 +127,7 @@ where
 /// [`ProgressBar`]: struct.ProgressBar.html
 /// [renderer]: ../../renderer/index.html
 pub trait Renderer: crate::Renderer {
+    /// The style supported by this renderer.
     type Style: Default;
 
     /// The default height of a [`ProgressBar`].

native/src/widget/radio.rs

@@ -181,6 +181,7 @@ where
 /// [`Radio`]: struct.Radio.html
 /// [renderer]: ../../renderer/index.html
 pub trait Renderer: crate::Renderer {
+    /// The style supported by this renderer.
     type Style: Default;
 
     /// Returns the default size of a [`Radio`] button.

native/src/widget/scrollable.rs

@@ -458,6 +458,7 @@ pub struct Scroller {
 /// [`Scrollable`]: struct.Scrollable.html
 /// [renderer]: ../../renderer/index.html
 pub trait Renderer: crate::Renderer + Sized {
+    /// The style supported by this renderer.
     type Style: Default;
 
     /// Returns the [`Scrollbar`] given the bounds and content bounds of a

native/src/widget/slider.rs

@@ -217,6 +217,7 @@ where
 /// [`Slider`]: struct.Slider.html
 /// [renderer]: ../../renderer/index.html
 pub trait Renderer: crate::Renderer {
+    /// The style supported by this renderer.
     type Style: Default;
 
     /// Returns the height of the [`Slider`].

native/src/widget/text_input.rs

@@ -407,6 +407,7 @@ where
 /// [`TextInput`]: struct.TextInput.html
 /// [renderer]: ../../renderer/index.html
 pub trait Renderer: crate::Renderer + Sized {
+    /// The style supported by this renderer.
     type Style: Default;
 
     /// Returns the default size of the text of the [`TextInput`].

src/lib.rs

@@ -174,7 +174,7 @@
 //! [documentation]: https://docs.rs/iced
 //! [examples]: https://github.com/hecrj/iced/tree/master/examples
 //! [`Application`]: trait.Application.html
-//#![deny(missing_docs)]
+#![deny(missing_docs)]
 #![deny(missing_debug_implementations)]
 #![deny(unused_results)]
 #![deny(unsafe_code)]

src/settings.rs

@@ -1,7 +1,7 @@
 //! Configure your application.
 
 /// The settings of an application.
-#[derive(Debug, Clone, Copy, PartialEq)]
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
 pub struct Settings {
     /// The [`Window`] settings.
     ///
@@ -10,19 +10,13 @@ pub struct Settings {
     /// [`Window`]: struct.Window.html
     pub window: Window,
 
+    /// The bytes of the font that will be used by default.
+    ///
+    /// If `None` is provided, a default system font will be chosen.
     // TODO: Add `name` for web compatibility
     pub default_font: Option<&'static [u8]>,
 }
 
-impl Default for Settings {
-    fn default() -> Settings {
-        Settings {
-            window: Window::default(),
-            default_font: None,
-        }
-    }
-}
-
 /// The window settings of an application.
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
 pub struct Window {

wgpu/src/defaults.rs

@@ -1,7 +1,10 @@
+//! Use default styling attributes to inherit styles.
 use iced_native::Color;
 
+/// Some default styling attributes.
 #[derive(Debug, Clone, Copy)]
 pub struct Defaults {
+    /// Text styling
     pub text: Text,
 }
 
@@ -13,8 +16,10 @@ impl Default for Defaults {
     }
 }
 
+/// Some default text styling attributes.
 #[derive(Debug, Clone, Copy)]
 pub struct Text {
+    /// The default color of text
     pub color: Color,
 }
 

wgpu/src/lib.rs

@@ -19,7 +19,7 @@
 //! [`wgpu`]: https://github.com/gfx-rs/wgpu-rs
 //! [WebGPU API]: https://gpuweb.github.io/gpuweb/
 //! [`wgpu_glyph`]: https://github.com/hecrj/wgpu_glyph
-//#![deny(missing_docs)]
+#![deny(missing_docs)]
 #![deny(missing_debug_implementations)]
 #![deny(unused_results)]
 #![deny(unsafe_code)]

wgpu/src/settings.rs

@@ -1,4 +1,10 @@
+/// The settings of a [`Renderer`].
+///
+/// [`Renderer`]: struct.Renderer.html
 #[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
 pub struct Settings {
+    /// The bytes of the font that will be used by default.
+    ///
+    /// If `None` is provided, a default system font will be chosen.
     pub default_font: Option<&'static [u8]>,
 }

wgpu/src/widget.rs

@@ -1,3 +1,12 @@
+//! Use the widgets supported out-of-the-box.
+//!
+//! # Re-exports
+//! For convenience, the contents of this module are available at the root
+//! module. Therefore, you can directly type:
+//!
+//! ```
+//! use iced_wgpu::{button, Button};
+//! ```
 pub mod button;
 pub mod checkbox;
 pub mod container;
@@ -6,3 +15,20 @@ pub mod radio;
 pub mod scrollable;
 pub mod slider;
 pub mod text_input;
+
+#[doc(no_inline)]
+pub use button::Button;
+#[doc(no_inline)]
+pub use checkbox::Checkbox;
+#[doc(no_inline)]
+pub use container::Container;
+#[doc(no_inline)]
+pub use progress_bar::ProgressBar;
+#[doc(no_inline)]
+pub use radio::Radio;
+#[doc(no_inline)]
+pub use scrollable::Scrollable;
+#[doc(no_inline)]
+pub use slider::Slider;
+#[doc(no_inline)]
+pub use text_input::TextInput;