From 0f9f379cec057255fa5f86b613d10d8c39d2a217 Mon Sep 17 00:00:00 2001 From: iris <2+iris@noreply.localhost> Date: Sun, 13 Sep 2026 21:37:44 -0400 Subject: [PATCH] Say what these do without naming what they lean on A doc comment that names something outside the method goes stale when that thing changes, and nobody editing it looks here. --- src/default/task.rs | 4 ++-- src/harness.rs | 9 ++++----- 2 files changed, 6 insertions(+), 7 deletions(-) diff --git a/src/default/task.rs b/src/default/task.rs index 4fd655c..46a946e 100644 --- a/src/default/task.rs +++ b/src/default/task.rs @@ -13,8 +13,8 @@ impl TaskUpdate /// Hands an update from a task to the thread that owns the ui. Delivery and /// waking are one act: a host posts the update as a message its loop already -/// carries -- winit's `EventLoopProxy`, Android's looper -- so nothing has to -/// wake the loop separately, or claim a redraw to be looked at. +/// carries, so nothing has to wake the loop separately, or claim a redraw to +/// be looked at. pub trait TaskQueue: Send + Sync + 'static { fn send(&self, update: Box>); } diff --git a/src/harness.rs b/src/harness.rs index b2a0eb0..8e25562 100644 --- a/src/harness.rs +++ b/src/harness.rs @@ -151,9 +151,8 @@ impl Harness { self.sense(); } - /// A wheel carries no position, so this goes wherever - /// [`move_to`](Self::move_to) last put the cursor -- nowhere, until it has - /// been called. + /// A wheel carries no position, so this goes wherever the cursor was last + /// moved to -- nowhere, until it has been moved. pub fn scroll(&mut self, delta: impl Into) { self.cursor.scroll_delta = delta.into(); self.sense(); @@ -174,8 +173,8 @@ impl Harness { } } - /// Dispatches against the last [`frame`](Self::frame)'s layout, which is - /// what a window delivers input against too. + /// Dispatches against the layout of the last frame, which is what a + /// window delivers input against too. fn sense(&mut self) { let cursor = self.cursor.clone(); let size = self.render.output_size();