More rust docs

Author: devongovett

src/macros.rs

@@ -117,13 +117,23 @@ pub(crate) use enum_property;
 
 macro_rules! shorthand_property {
   (
-    $name: ident$(<$l: lifetime>)?
-    { $first_key: ident: $first_type: ty, $( $key: ident: $type: ty, )* }
+    $(#[$outer:meta])*
+    $vis:vis struct $name: ident$(<$l: lifetime>)? {
+      $(#[$first_meta: meta])*
+      $first_key: ident: $first_type: ty,
+      $(
+        $(#[$meta: meta])*
+        $key: ident: $type: ty,
+      )*
+    }
   ) => {
+    $(#[$outer])*
     #[derive(Debug, Clone, PartialEq)]
     pub struct $name$(<$l>)? {
+      $(#[$first_meta])*
       pub $first_key: $first_type,
       $(
+        $(#[$meta])*
         pub $key: $type,
       )*
     }

src/properties/css_modules.rs

@@ -1,3 +1,5 @@
+//! Properties related to CSS modules.
+
 use crate::error::{ParserError, PrinterError};
 use crate::printer::Printer;
 use crate::traits::{Parse, ToCss};
@@ -6,18 +8,25 @@ use crate::values::string::CowArcStr;
 use cssparser::*;
 use smallvec::SmallVec;
 
-/// The `composes` property from CSS modules.
-/// https://github.com/css-modules/css-modules/#dependencies
+/// A value for the [composes](https://github.com/css-modules/css-modules/#dependencies) property from CSS modules.
 #[derive(Debug, Clone, PartialEq)]
 pub struct Composes<'i> {
+  /// A list of class names to compose.
   pub names: CustomIdentList<'i>,
+  /// Where the class names are composed from.
   pub from: Option<ComposesFrom<'i>>,
+  /// The source location of the `composes` property.
   pub loc: SourceLocation,
 }
 
+/// Defines where the class names referenced in the `composes` property are located.
+///
+/// See [Composes](Composes).
 #[derive(Debug, Clone, PartialEq)]
 pub enum ComposesFrom<'i> {
+  /// The class name is global.
   Global,
+  /// The class name comes from the specified file.
   File(CowArcStr<'i>),
 }
 

src/properties/display.rs

@@ -1,3 +1,5 @@
+//! CSS properties related to display.
+
 use super::custom::UnparsedProperty;
 use super::{Property, PropertyId};
 use crate::context::PropertyHandlerContext;
@@ -12,13 +14,15 @@ use crate::vendor_prefix::VendorPrefix;
 use cssparser::*;
 
 enum_property! {
+  /// A [`<display-outside>`](https://drafts.csswg.org/css-display-3/#typedef-display-outside) value.
   pub enum DisplayOutside {
     "block": Block,
     "inline": Inline,
     "run-in": RunIn,
   }
 }
 
+/// A [`<display-inside>`](https://drafts.csswg.org/css-display-3/#typedef-display-inside) value.
 #[derive(Debug, Clone, PartialEq)]
 pub enum DisplayInside {
   Flow,
@@ -91,10 +95,16 @@ impl DisplayInside {
   }
 }
 
+/// A pair of inside and outside display values, as used in the `display` property.
+///
+/// See [Display](Display).
 #[derive(Debug, Clone, PartialEq)]
 pub struct DisplayPair {
+  /// The outside display value.
   pub outside: DisplayOutside,
+  /// The inside display value.
   pub inside: DisplayInside,
+  /// Whether this is a list item.
   pub is_list_item: bool,
 }
 
@@ -277,6 +287,9 @@ impl ToCss for DisplayPair {
 }
 
 enum_property! {
+  /// A `display` keyword.
+  ///
+  /// See [Display](Display).
   pub enum DisplayKeyword {
     "none": None,
     "contents": Contents,
@@ -295,9 +308,12 @@ enum_property! {
   }
 }
 
+/// A value for the [display](https://drafts.csswg.org/css-display-3/#the-display-properties) property.
 #[derive(Debug, Clone, PartialEq)]
 pub enum Display {
+  /// A display keyword.
   Keyword(DisplayKeyword),
+  /// The inside and outside display values.
   Pair(DisplayPair),
 }
 
@@ -325,10 +341,13 @@ impl ToCss for Display {
 }
 
 enum_property! {
-  /// https://drafts.csswg.org/css-display-3/#visibility
+  /// A value for the [visibility](https://drafts.csswg.org/css-display-3/#visibility) property.
   pub enum Visibility {
+    /// The element is visible.
     Visible,
+    /// The element is hidden.
     Hidden,
+    /// The element is collapsed.
     Collapse,
   }
 }