Port · Parity: the last long comments are short

examples/gallery/capture.rs

@@ -114,7 +114,7 @@ pub fn number(window: &Window) -> Result<u32> {
     u32::try_from(number).context("window number out of range")
 }
 
-/// Takes posted mouse moves; gpui's tracking area takes only real ones.
+/// Takes posted mouse moves; a tracking area takes real ones.
 #[cfg(target_os = "macos")]
 fn take_posted_moves(window: &Window) -> Result<()> {
     use cocoa::{appkit::NSWindow, base::YES};

src/interaction/rotatable.rs

@@ -28,7 +28,7 @@ fn angle_at(bounds: Bounds<Pixels>, at: Point<Pixels>, snap: bool) -> f32 {
 
 type OnTurn = Rc<dyn Fn(f32, &mut Window, &mut App)>;
 
-/// An svg turned clockwise by degrees, with a knob to drag.
+/// An svg turned clockwise by degrees, with a knob.
 #[derive(IntoElement)]
 pub struct Rotatable {
     id: ElementId,

src/primitives/layer.rs

@@ -16,7 +16,7 @@ fn nested() -> bool {
     LAYERS.with_borrow(|layers| !layers.is_empty())
 }
 
-/// Draws `child` over the page; inside a raise, last within it.
+/// Draws `child` over the page, last inside a raise.
 pub fn raise(id: impl Into<ElementId>, child: impl IntoElement) -> Raised {
     let layer = Layer {
         child: child.into_any_element(),

src/typography/fit.rs

@@ -111,7 +111,7 @@ fn offset(align: TextAlign, free: Pixels) -> Pixels {
     }
 }
 
-/// One line in the text style around it, cut by `fit` to its box and set by its alignment.
+/// One line, cut by `fit` to its box and aligned.
 fn cut_line(text: SharedString, fit: fn(&str, Pixels, &mut Window) -> String) -> Div {
     let line = text.clone();
     div()