From 4b3d0fb08d5b2e84c1061fa601b71363b6719f59 Mon Sep 17 00:00:00 2001
From: Héctor Ramón Jiménez <hector0193@gmail.com>
Date: Thu, 10 Nov 2022 01:10:28 +0100
Subject: Write documentation for `iced_style`

---
 style/src/pick_list.rs | 11 +++++++++++
 1 file changed, 11 insertions(+)

(limited to 'style/src/pick_list.rs')

diff --git a/style/src/pick_list.rs b/style/src/pick_list.rs
index a09772d7..8d93dff2 100644
--- a/style/src/pick_list.rs
+++ b/style/src/pick_list.rs
@@ -1,22 +1,33 @@
+//! Change the appearance of a pick list.
 use iced_core::{Background, Color};
 
 /// The appearance of a pick list.
 #[derive(Debug, Clone, Copy)]
 pub struct Appearance {
+    /// The text [`Color`] of the pick list.
     pub text_color: Color,
+    /// The placeholder [`Color`] of the pick list.
     pub placeholder_color: Color,
+    /// The [`Background`] of the pick list.
     pub background: Background,
+    /// The border radius of the pick list.
     pub border_radius: f32,
+    /// The border width of the pick list.
     pub border_width: f32,
+    /// The border color of the pick list.
     pub border_color: Color,
+    /// The size of the arrow icon of the pick list.
     pub icon_size: f32,
 }
 
 /// A set of rules that dictate the style of a container.
 pub trait StyleSheet {
+    /// The supported style of the [`StyleSheet`].
     type Style: Default + Clone;
 
+    /// Produces the active [`Appearance`] of a pick list.
     fn active(&self, style: &<Self as StyleSheet>::Style) -> Appearance;
 
+    /// Produces the hovered [`Appearance`] of a pick list.
     fn hovered(&self, style: &<Self as StyleSheet>::Style) -> Appearance;
 }
-- 
cgit