clean up AtRuleKind docs

This commit is contained in:
ConnorSkees 2020-05-25 15:52:53 -04:00
parent d6ac99f1d7
commit a7d6af9cc8

View File

@ -10,10 +10,12 @@ pub enum AtRuleKind {
/// Loads mixins, functions, and variables from other Sass /// Loads mixins, functions, and variables from other Sass
/// stylesheets, and combines CSS from multiple stylesheets together /// stylesheets, and combines CSS from multiple stylesheets together
Use, Use,
/// Loads a Sass stylesheet and makes its mixins, functions, /// Loads a Sass stylesheet and makes its mixins, functions,
/// and variables available when your stylesheet is loaded /// and variables available when your stylesheet is loaded
/// with the `@use` rule /// with the `@use` rule
Forward, Forward,
/// Extends the CSS at-rule to load styles, mixins, functions, /// Extends the CSS at-rule to load styles, mixins, functions,
/// and variables from other stylesheets /// and variables from other stylesheets
/// ///
@ -21,45 +23,49 @@ pub enum AtRuleKind {
/// the @import rule refers to a plain css import /// the @import rule refers to a plain css import
/// e.g. `@import url(foo);` /// e.g. `@import url(foo);`
Import, Import,
Mixin, Mixin,
Content, Content,
Include, Include,
/// Defines custom functions that can be used in SassScript /// Defines custom functions that can be used in SassScript
/// expressions /// expressions
Function, Function,
Return, Return,
/// Allows selectors to inherit styles from one another /// Allows selectors to inherit styles from one another
Extend, Extend,
/// Puts styles within it at the root of the CSS document /// Puts styles within it at the root of the CSS document
AtRoot, AtRoot,
/// Causes compilation to fail with an error message /// Causes compilation to fail with an error message
Error, Error,
/// Prints a warning without stopping compilation entirely /// Prints a warning without stopping compilation entirely
Warn, Warn,
/// Prints a message for debugging purposes /// Prints a message for debugging purposes
Debug, Debug,
If, If,
// @else is considered a part of @each, and so is not parsed individually
// TODO: give proper error message for encountering @else? right now
// it is parsed as an unknown at rule
// Else,
Each, Each,
For, For,
While, While,
Media,
// CSS @rules // CSS @rules
/// Defines the character set used by the style sheet /// Defines the character set used by the style sheet
Charset, Charset,
/// A conditional group rule that will apply its content if the /// A conditional group rule that will apply its content if the
/// browser meets the criteria of the given condition /// browser meets the criteria of the given condition
Supports, Supports,
/// Describes the aspect of intermediate steps in a CSS animation sequence /// Describes the aspect of intermediate steps in a CSS animation sequence
Keyframes, Keyframes,
Media,
/// An unknown at rule. /// An unknown at-rule
/// For forward compatibility, they are parsed the same as @media
Unknown(String), Unknown(String),
} }