style: Prefer doc comments to #[doc] annotations.

This commit is contained in:
Emilio Cobos Álvarez 2017-11-27 15:10:28 +01:00
parent ac6e04ebfb
commit c786fd2e55
No known key found for this signature in database
GPG key ID: 056B727BB9C1027C

View file

@ -13,41 +13,47 @@ use properties::ComputedValues;
use std::fmt; use std::fmt;
bitflags! { bitflags! {
#[doc = "Individual layout actions that may be necessary after restyling."] /// Individual layout actions that may be necessary after restyling.
pub struct ServoRestyleDamage: u8 { pub struct ServoRestyleDamage: u8 {
#[doc = "Repaint the node itself."] /// Repaint the node itself.
#[doc = "Currently unused; need to decide how this propagates."] ///
/// Currently unused; need to decide how this propagates.
const REPAINT = 0x01; const REPAINT = 0x01;
#[doc = "The stacking-context-relative position of this node or its descendants has \ /// The stacking-context-relative position of this node or its
changed."] /// descendants has changed.
#[doc = "Propagates both up and down the flow tree."] ///
/// Propagates both up and down the flow tree.
const REPOSITION = 0x02; const REPOSITION = 0x02;
#[doc = "Recompute the overflow regions (bounding box of object and all descendants)."] /// Recompute the overflow regions (bounding box of object and all descendants).
#[doc = "Propagates down the flow tree because the computation is bottom-up."] ///
/// Propagates down the flow tree because the computation is bottom-up.
const STORE_OVERFLOW = 0x04; const STORE_OVERFLOW = 0x04;
#[doc = "Recompute intrinsic inline_sizes (minimum and preferred)."] /// Recompute intrinsic inline_sizes (minimum and preferred).
#[doc = "Propagates down the flow tree because the computation is"] ///
#[doc = "bottom-up."] /// Propagates down the flow tree because the computation is.
/// bottom-up.
const BUBBLE_ISIZES = 0x08; const BUBBLE_ISIZES = 0x08;
#[doc = "Recompute actual inline-sizes and block-sizes, only taking out-of-flow children \ /// Recompute actual inline-sizes and block-sizes, only taking
into account. \ /// out-of-flow children into account.
Propagates up the flow tree because the computation is top-down."] ///
/// Propagates up the flow tree because the computation is top-down.
const REFLOW_OUT_OF_FLOW = 0x10; const REFLOW_OUT_OF_FLOW = 0x10;
#[doc = "Recompute actual inline_sizes and block_sizes."] /// Recompute actual inline_sizes and block_sizes.
#[doc = "Propagates up the flow tree because the computation is"] ///
#[doc = "top-down."] /// Propagates up the flow tree because the computation is top-down.
const REFLOW = 0x20; const REFLOW = 0x20;
#[doc = "Re-resolve generated content. \ /// Re-resolve generated content.
Propagates up the flow tree because the computation is inorder."] ///
/// Propagates up the flow tree because the computation is inorder.
const RESOLVE_GENERATED_CONTENT = 0x40; const RESOLVE_GENERATED_CONTENT = 0x40;
#[doc = "The entire flow needs to be reconstructed."] /// The entire flow needs to be reconstructed.
const RECONSTRUCT_FLOW = 0x80; const RECONSTRUCT_FLOW = 0x80;
} }
} }