From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 12A223EBF02; Wed, 18 Feb 2026 20:15:51 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771445752; cv=none; b=dVeMcFXTnb8FHeNcx/0R6lSu88is5xTrK8KlEzWred0FtiVG16GDIdwDk1rtZI8+xnoZXmTCA0nZCRwPOFkgSqIVdht9jwtrVJQn6NmhtjFgrDp9jDoLzEd48VNMD4AT1t2LpfGmZjnt2xuqswQgF8gynox9GhMexQ4qqlrhN28= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771445752; c=relaxed/simple; bh=mk0UF3cCYORlCR+XsKqR07GIc/DtHSjdHFV1IZBbHpE=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=Vu2wIb5oQKBxOrkR7pNtd/RMpEG/Dtp2IFYGRlpiZb8tO0RVS/uUcSuGHF1XP6/VrE6y7+kY5eM0OPkdDeKXkUu58MH07qK+mG3Dz8gNu1/D8k5+IgXItXmdxrB+VL3Tma1RU0/hS96mLrFp6PE5O0p4HrWJHqyAunMlr+PQnek= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=AV/DqXne; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="AV/DqXne" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 2162DC19425; Wed, 18 Feb 2026 20:15:51 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1771445751; bh=mk0UF3cCYORlCR+XsKqR07GIc/DtHSjdHFV1IZBbHpE=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=AV/DqXneIvZJ3MeL76TOOt5zFdzi5agCvkxM1iUQBpZqYNotiGYApmr52/Lx/pV7+ vYuhdkBk06hG7zTSc0kC3BtEzNuasAJ51sEieyBzLFgYzZ4ND7bGhHbONKMEd2qF4Q dXOwIQvkXfrp8H5f5GNs/9FUNkm0sr8+hXYHGDWJvGzSCymY7g3PaH6i2Y9UIOJt7D PPw/xcOkdrsLcLiO2yW2siin/i7KOjHwTegTiHdeHyeT9jhnFnQMj99EUacdEwPG1s 8agQhlpAc8y/QW1k9M5bmo9H+XhTZ+AIBCMPs993BVXXf6gevexzm2m0PgzAcOXp/s 4/Wx0U6LQ41GQ== Received: from phl-compute-02.internal (phl-compute-02.internal [10.202.2.42]) by mailfauth.phl.internal (Postfix) with ESMTP id 3C784F40068; Wed, 18 Feb 2026 15:15:50 -0500 (EST) Received: from phl-frontend-03 ([10.202.2.162]) by phl-compute-02.internal (MEProxy); Wed, 18 Feb 2026 15:15:50 -0500 X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefgedrtddtgddvvdefheejucetufdoteggodetrf dotffvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfurfetoffkrfgpnffqhgenuceu rghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmnecujf gurhepfffhvfevuffkfhggtggujgesthdtredttddtvdenucfhrhhomhepuehoqhhunhcu hfgvnhhguceosghoqhhunheskhgvrhhnvghlrdhorhhgqeenucggtffrrghtthgvrhhnpe ekgffhhfeuheelhfekteeuffejveetjeefffettedtteegfefftdduteduudfgleenucev lhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpegsohhquhhnod hmvghsmhhtphgruhhthhhpvghrshhonhgrlhhithihqdduieejtdelkeegjeduqddujeej keehheehvddqsghoqhhunheppehkvghrnhgvlhdrohhrghesfhhigihmvgdrnhgrmhgvpd hnsggprhgtphhtthhopeduledpmhhouggvpehsmhhtphhouhhtpdhrtghpthhtoheprgdr hhhinhgusghorhhgsehkvghrnhgvlhdrohhrghdprhgtphhtthhopegsohhquhhnrdhfvg hnghesghhmrghilhdrtghomhdprhgtphhtthhopehfuhhjihhtrgdrthhomhhonhhorhhi sehgmhgrihhlrdgtohhmpdhrtghpthhtohepfhhrvgguvghrihgtsehkvghrnhgvlhdroh hrghdprhgtphhtthhopehlhihuuggvsehrvgguhhgrthdrtghomhdprhgtphhtthhopeht ghhlgieskhgvrhhnvghlrdhorhhgpdhrtghpthhtoheprghnnhgrqdhmrghrihgrsehlih hnuhhtrhhonhhigidruggvpdhrtghpthhtohepjhhsthhulhhtiiesghhoohhglhgvrdgt ohhmpdhrtghpthhtohepshgsohihugeskhgvrhhnvghlrdhorhhg X-ME-Proxy: Feedback-ID: i8dbe485b:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Wed, 18 Feb 2026 15:15:49 -0500 (EST) Date: Wed, 18 Feb 2026 12:15:48 -0800 From: Boqun Feng To: Andreas Hindborg Cc: Boqun Feng , FUJITA Tomonori , Frederic Weisbecker , Lyude Paul , Thomas Gleixner , Anna-Maria Behnsen , John Stultz , Stephen Boyd , Miguel Ojeda , Gary Guo , =?iso-8859-1?Q?Bj=F6rn?= Roy Baron , Benno Lossin , Alice Ryhl , Trevor Gross , Danilo Krummrich , rust-for-linux@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH] rust: hrtimer: document handle based design rationale Message-ID: References: <20260215-hrtimer-docs-v1-1-bff6a6c0d923@kernel.org> <87ms15c0hx.fsf@kernel.org> Precedence: bulk X-Mailing-List: rust-for-linux@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <87ms15c0hx.fsf@kernel.org> On Wed, Feb 18, 2026 at 08:31:06PM +0100, Andreas Hindborg wrote: > "Boqun Feng" writes: > > > On Sun, Feb 15, 2026 at 09:36:04PM +0100, Andreas Hindborg wrote: > >> Add implementation notes explaining why the hrtimer abstraction uses a > >> handle based approach. > >> > >> Signed-off-by: Andreas Hindborg > > > > Thanks for adding this! > > > > Reviewed-by: Boqun Feng > > > > However I feel these are not just implementation details. They are the > > design decision we made because of the limitation you mentioned. Maybe > > make them "//!" doc comment and just put them as a separate section that > > describes the necessity of handles? Thoughts? > > I don't think these details are important for the reader of the API? If > you just want to use a timer, this is not something you want to read > through. > Fair enough ;-) Regards, Boqun > > Best regards, > Andreas Hindborg > > >