From patchwork Wed Jan 31 20:23:33 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Valentin Obst via B4 Relay X-Patchwork-Id: 194928 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:693c:2685:b0:106:209c:c626 with SMTP id mn5csp4537dyc; Wed, 31 Jan 2024 12:28:58 -0800 (PST) X-Google-Smtp-Source: AGHT+IHiR0XPNJrR6oqxaRPTBxR9VPpeidBzKx2s3T5+6FFTe7e1J0Txe+5R43LMv/Rphffvye8v X-Received: by 2002:a17:906:7d6:b0:a35:7438:1136 with SMTP id m22-20020a17090607d600b00a3574381136mr246566ejc.70.1706732938386; Wed, 31 Jan 2024 12:28:58 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1706732938; cv=pass; d=google.com; s=arc-20160816; b=o8uccTJdRXNfoLXrf8LA0fc9M2XJUo6Qf3Y+QWyT/wI6z+pQxrB0WTx92t+M8cIoxg U51jITXMsqnjw/XcyACGdXNJdGOldLCxosWLiAMEkY/BwgVVituSrI0nKsTSgYq4lQ31 tqDbhA81N5Bin919uepkSIeFFFtEBBX2czin1J2vO5ljbkm3BFkcC96SJSCVGUQyHNaD PibkYh4bZlWkBpeNI4mUmi/nHzLt2q7FvyMKJXvHqeFUa53vhkPzWqLGHC4bsEyzaRgm CYXpd9vnw00dybMlIQzEpkw/80uQZE8OxlYpbCa8Kd/4xK5dr9lguzIXknwcTDvqJyfm lGlA== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=reply-to:cc:to:in-reply-to:references:message-id :content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:subject:date:from:dkim-signature; bh=DpFTyt5ur47sRBJH6DJrr4WHWbVMdbVpsfLjsG6mtG4=; fh=psSI67ao4zJ6Lt3KqL+ritwaM0DRQ2U0Xup+mIf1Vgk=; b=nzkLQvB621yErIQ7ihBAEo+3yEnjVxGu6p/AYi9RW7h2+f2RgAlwQPQXHvV5iZMHD6 XRS23gGSERHRxiq7FC3WV47fyXho4H1OtnTx2ZprL2kiXPmZCkfOkD7fwqPrByGsZ73z SlvIjPLZqMAylaZgelHkSbUI7BqIII2eYnKXihRtkKVk+b13Zvj9TJTUS6vSTRw0O0ww A/nkt6PTkYRLUe2kp9+/a9RqIkxv+UrwEK3HE/XfrVtP3D8yMwrSHqOujV8SZlAUvjnn llY2On8IzlFHLVXPndrsdrXmyYfeqEAkFS/EJ0QzKLu7SZh0OhzYMH7y7b+jJPjmGXKs aPqg==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=LpWpNyXg; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-47074-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-47074-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org X-Forwarded-Encrypted: i=1; AJvYcCWq5bU8feZ/d/4WjC2X2n/542ofsz3TXeHecB9FgoarB133L/qzFuQ72u/fWL9gt+VM6CY4hdeBKWjsbrG2HtolX3Qrdw== Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [147.75.80.249]) by mx.google.com with ESMTPS id qc22-20020a170906d8b600b00a3588ab319csi4053485ejb.697.2024.01.31.12.28.58 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 31 Jan 2024 12:28:58 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-47074-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=LpWpNyXg; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-47074-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-47074-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by am.mirrors.kernel.org (Postfix) with ESMTPS id 891A91F27BAC for ; Wed, 31 Jan 2024 20:28:57 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 66E8613EFE8; Wed, 31 Jan 2024 20:24:16 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="LpWpNyXg" 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 8C35A5C5E3; Wed, 31 Jan 2024 20:24:09 +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=1706732649; cv=none; b=U48ttUFU9lZbBY9I/daRU2rnS+1jcj6LY0GKaK9D6HJgfLAKQ9kj8bcg38D3iIty/rmIZ3xMk3enh7OkL8hvD1zaWVjl8RmsY7qvtxe0vGzcTt6CAnQ1uzy7efuU9OHpwuLACWSAAC68/Upg0iRh1WcqbTqOreM5JYKhBnKWzWg= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1706732649; c=relaxed/simple; bh=ougBeYt6zdCfhQV27TBzSU+Hnds2zUx3wZiZDbZ9RF4=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=g2A+2P0X0J93Grpq3Vr87phitkxMkFMwpbClxAHOWsr5Abs1qDB7FEkMmecovKxkDo7SrxJtcpmFssoMZgxKD4UGXNsQtyvvBcrPqZdaazW3/Ug9lKXBRz4AISQpTVhB5zFDEmEpCl/sZDAc2SKwDVyODamnCGqIIRkrn+kIXzA= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=LpWpNyXg; arc=none smtp.client-ip=10.30.226.201 Received: by smtp.kernel.org (Postfix) with ESMTPS id 351E1C4167E; Wed, 31 Jan 2024 20:24:09 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1706732649; bh=ougBeYt6zdCfhQV27TBzSU+Hnds2zUx3wZiZDbZ9RF4=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=LpWpNyXgrA5Y/VwmEXohXMT2FVnx0fpJArCLuYYrbL7iCwpCgJ+J9FYanQT2cZ29G 1rGa8LqAhk1VxlJxH2gg1aGunSiD2vKuhMbxW6JsxTyW/4dz06GGENAYOVP/b/QXV1 IBywaHsbpttMoT9tehxGz60d2r3NWIqsXauukTsP0UQmdlT4S8z1UF40ijeG484YuY F+5s4sckpoX+Yqd4lI2kFop/tQTelVHTGZqPf+keC7WeHdlgjJcRe0hgYm0huDXjml KUTbFowVRDIaZ8YpMoNSASOADVt+IDR9QRyXj33P/rRoSo+Nj0nrwvV3y6D8l+sFDC aOcfVIbHOtNfA== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 24F70C47258; Wed, 31 Jan 2024 20:24:09 +0000 (UTC) From: Valentin Obst via B4 Relay Date: Wed, 31 Jan 2024 21:23:33 +0100 Subject: [PATCH v3 11/12] rust: kernel: remove unneeded doclink targets Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Message-Id: <20240131-doc-fixes-v3-v3-11-0c8af94ed7de@valentinobst.de> References: <20240131-doc-fixes-v3-v3-0-0c8af94ed7de@valentinobst.de> In-Reply-To: <20240131-doc-fixes-v3-v3-0-0c8af94ed7de@valentinobst.de> To: Miguel Ojeda , Alex Gaynor , Wedson Almeida Filho , Boqun Feng , Gary Guo , =?utf-8?q?Bj=C3=B6rn_Roy_Baron?= , Benno Lossin , Andreas Hindborg , Alice Ryhl Cc: rust-for-linux@vger.kernel.org, linux-kernel@vger.kernel.org, Valentin Obst , Trevor Gross , Martin Rodriguez Reboredo X-Mailer: b4 0.12.4 X-Developer-Signature: v=1; a=ed25519-sha256; t=1706732646; l=2616; i=kernel@valentinobst.de; s=20240131; h=from:subject:message-id; bh=BwWMsMRSeC1kKnnmhQv6fYuKaj3M32UFlVEb1WuNzkc=; b=wGvATBsFaAo4TY5WjEUO/KspVCL0ZjLBOnY1oLObO9aK45Ya/Q4PX1qIKBNDOAs/Gdt0eTaX4 wkWoULzhHoiBhoqQzhNokpuv3kiGrC+SwHm+BrqDtAZihlX+0ppEWpR X-Developer-Key: i=kernel@valentinobst.de; a=ed25519; pk=3s7U8y0mqkaiurgHSQQTYWOo2tw5HgzCg5vnJVfw37Y= X-Endpoint-Received: by B4 Relay for kernel@valentinobst.de/20240131 with auth_id=124 X-Original-From: Valentin Obst Reply-To: X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1789639197718736529 X-GMAIL-MSGID: 1789639197718736529 From: Valentin Obst Remove explicit targets for doclinks in cases where rustdoc can determine the correct target by itself. The goal is to reduce unneeded verbosity in the source code. Signed-off-by: Valentin Obst Reviewed-by: Trevor Gross Reviewed-by: Martin Rodriguez Reboredo Reviewed-by: Alice Ryhl --- rust/kernel/workqueue.rs | 10 ---------- 1 file changed, 10 deletions(-) diff --git a/rust/kernel/workqueue.rs b/rust/kernel/workqueue.rs index ed3af3491b47..73d6fa544ca6 100644 --- a/rust/kernel/workqueue.rs +++ b/rust/kernel/workqueue.rs @@ -426,13 +426,10 @@ pub unsafe fn raw_get(ptr: *const Self) -> *mut bindings::work_struct { /// The [`OFFSET`] constant must be the offset of a field in `Self` of type [`Work`]. The /// methods on this trait must have exactly the behavior that the definitions given below have. /// -/// [`Work`]: Work /// [`impl_has_work!`]: crate::impl_has_work /// [`OFFSET`]: HasWork::OFFSET pub unsafe trait HasWork { /// The offset of the [`Work`] field. - /// - /// [`Work`]: Work const OFFSET: usize; /// Returns the offset of the [`Work`] field. @@ -440,7 +437,6 @@ pub unsafe trait HasWork { /// This method exists because the [`OFFSET`] constant cannot be accessed if the type is not /// [`Sized`]. /// - /// [`Work`]: Work /// [`OFFSET`]: HasWork::OFFSET #[inline] fn get_work_offset(&self) -> usize { @@ -452,8 +448,6 @@ fn get_work_offset(&self) -> usize { /// # Safety /// /// The provided pointer must point at a valid struct of type `Self`. - /// - /// [`Work`]: Work #[inline] unsafe fn raw_get_work(ptr: *mut Self) -> *mut Work { // SAFETY: The caller promises that the pointer is valid. @@ -465,8 +459,6 @@ unsafe fn raw_get_work(ptr: *mut Self) -> *mut Work { /// # Safety /// /// The pointer must point at a [`Work`] field in a struct of type `Self`. - /// - /// [`Work`]: Work #[inline] unsafe fn work_container_of(ptr: *mut Work) -> *mut Self where @@ -495,8 +487,6 @@ unsafe fn work_container_of(ptr: *mut Work) -> *mut Self /// impl HasWork for MyStruct { self.work_field } /// } /// ``` -/// -/// [`HasWork`]: HasWork #[macro_export] macro_rules! impl_has_work { ($(impl$(<$($implarg:ident),*>)?