Prune commentary and stale Rust port notes

core/src/widget/data.rs

@@ -3,7 +3,6 @@ use crate::Widget;
 pub struct WidgetData {
     pub widget: Box<dyn Widget>,
     pub label: String,
-    /// dynamic borrow checking
     pub borrowed: bool,
 }
 

core/src/widget/handle.rs

@@ -7,11 +7,6 @@ use crate::{
 
 pub type WidgetId = SlotId;
 
-/// An identifier for a widget that can index a UI or event ctx to get it.
-/// This is a strong handle that does not impl Clone, and when it is dropped,
-/// a signal is sent to the owning UI to clean up the resources.
-///
-/// TODO: ergonomic clones when they get put in rust-analyzer & don't cause ICEs?
 pub struct StrongWidget<W: ?Sized = dyn Widget> {
     pub(super) id: WidgetId,
     counter: RefCounter,
@@ -19,8 +14,6 @@ pub struct StrongWidget<W: ?Sized = dyn Widget> {
     ty: *const W,
 }
 
-/// A weak handle to a widget.
-/// Will not keep it alive, but can still be used for indexing like WidgetHandle.
 pub struct WeakWidget<W: ?Sized = dyn Widget> {
     pub(super) id: WidgetId,
     #[allow(unused)]

core/src/widget/like.rs

@@ -43,7 +43,6 @@ impl<Rsc, const LEN: usize> WidgetArrLike<Rsc, LEN, ArrTag> for WidgetArr<LEN> {
     }
 }
 
-// variadic generics please save us
 macro_rules! impl_widget_arr {
     ($n:expr;$($W:ident)*) => {
         impl_widget_arr!($n;$($W)*;$(${concat($W,Tag)})*);

core/src/widget/mod.rs

@@ -18,12 +18,10 @@ pub use widgets::*;
 pub trait Widget: Any {
     fn draw(&mut self, painter: &mut Painter);
 
-    /// An exact, context-free length known without drawing or inspecting children.
     fn size_hint(&self, _axis: Axis) -> Option<Len> {
         None
     }
 
-    /// Whether the draw result is independent of the offered region.
     fn is_size_independent(&self) -> bool {
         false
     }
@@ -32,12 +30,10 @@ pub trait Widget: Any {
         false
     }
 
-    /// The AccessKit role for a labelled widget.
     fn access_role(&self) -> accesskit::Role {
         accesskit::Role::Unknown
     }
 
-    /// Advance an animation and report whether it needs another frame.
     #[allow(unused_variables)]
     fn tick(&mut self, now: std::time::Instant) -> bool {
         false
@@ -68,9 +64,6 @@ impl dyn Widget {
     }
 }
 
-/// A function that returns a widget given a UI.
-/// Useful for defining trait functions on widgets that create a parent widget so that the children
-/// don't need to be IDs yet
 pub trait WidgetFn<State, W: Widget + ?Sized>: FnOnce(&mut State) -> W {}
 impl<State, W: Widget + ?Sized, F: FnOnce(&mut State) -> W> WidgetFn<State, W> for F {}
 

core/src/widget/widgets.rs

@@ -11,10 +11,6 @@ pub struct Widgets {
     send: Sender<WidgetId>,
     recv: Receiver<WidgetId>,
     pub(crate) waiting: HashSet<WidgetId>,
-    /// Every widget that has ever been given an explicit `.label()` --
-    /// `ui::access::AccessTree` walks exactly this set, not the whole
-    /// arena, so a widget nobody named costs it nothing. Symmetric with
-    /// `free_next` below, which is this set's one removal path.
     named: HashSet<WidgetId>,
 }
 
@@ -44,8 +40,6 @@ impl Widgets {
         Some(self.vec.get_mut(id)?.widget.as_mut())
     }
 
-    /// get_dyn but dynamic borrow checking of widgets
-    /// lets you do recursive (tree) operations, like the painter does
     pub(crate) fn get_dyn_dynamic<'a>(&self, id: WidgetId) -> WidgetWrapper<'a> {
         // SAFETY: must guarantee no other mutable references to this widget exist
         // done through the borrow variable
@@ -101,18 +95,12 @@ impl Widgets {
         &self.data(id.id()).unwrap().label
     }
 
-    /// Also the one place a widget opts into `ui::access`'s AccessKit tree
-    /// (RUST.md's I4) -- see `named`'s doc comment.
     pub fn set_label(&mut self, id: impl IdLike, label: String) {
         let id = id.id();
         self.data_mut(id).unwrap().label = label;
         self.named.insert(id);
     }
 
-    /// Every widget with an explicit name, for `ui::access::AccessTree` to
-    /// walk. Order is unspecified; `AccessTree` doesn't need one; a screen
-    /// reader's own traversal is worked out by uiautomator from each
-    /// node's on-screen bounds instead.
     pub fn named(&self) -> impl Iterator<Item = WidgetId> + '_ {
         self.named.iter().copied()
     }