From patchwork Wed Jan 17 00:15:49 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Valentin Obst X-Patchwork-Id: 188651 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:42cf:b0:101:a8e8:374 with SMTP id q15csp603800dye; Tue, 16 Jan 2024 16:16:52 -0800 (PST) X-Google-Smtp-Source: AGHT+IE14Oaa0miXuQN7LhT87dfNqf9idd9s8HkCvXS24XcJTvnNgsHQOkbBXHYuULUj8j50fSBl X-Received: by 2002:a05:6214:f2c:b0:680:c6be:d728 with SMTP id iw12-20020a0562140f2c00b00680c6bed728mr8934555qvb.77.1705450612615; Tue, 16 Jan 2024 16:16:52 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705450612; cv=pass; d=google.com; s=arc-20160816; b=i5wQNWXrFdaX74roalQJq6+aXkxv7y2woVU0+0js0XiiI4wb0WQvqTD+pos0L+w/YT XIwk7z0db8w+7fjN8YBcpg7HqMs3EBIWqEq4v37yAW6lLBjhJsysdTyk4JAFNdsq+Xi3 6fp7m9j8AXgnquZIdRg1q6n5vKtmrkDGk86cwGhsnvbFSHfuDAaNvZPrt2ac5SIrMGpC ee8zngCPO+Phi9REoiG04okeCQrABrfEO39/qaWWT877ntXZ3eTgj+tdwdBEg0vJMhzt 7JVtXsWOe/GkyH7zwzdEFa4i5cJPvtjirUJoKpOMU5Lw216PHh8kZli5p7OJmOSDrN3M m5Pg== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=ui-outboundreport:content-transfer-encoding:mime-version :list-unsubscribe:list-subscribe:list-id:precedence:references :in-reply-to:message-id:date:subject:cc:to:from; bh=koZ/omgcAWPmX+qMKIMuWUdAWHdv83qx7zqquGY5qlo=; fh=mB5qiQ7ps5IWvjuQS9+zcxjK3ZInVolb8UwIN1mvAmg=; b=BHaIGHlFCDFmkZRwNDuHfUslXbUgf8fUNFeWA06JMI83A22Mxc6MdE9O21MDh108Ge b3gFEsxpAxyxuCBHRNttaBtdAm8dcF8mE2CqeUn9LijRBXH3yVOCUhMwmYIJ1p5ERV/d b8NzIn9Do+yeXfZMH26w+rnc2taLdrMXY8+TSJzX/4TkYtE5TJAm4bFbAc2v7ONbF3lS 3htM9ie7GqU4okhJDFBWinjp4b8pmOrKxAHwXQJk3pxucUuud8KkJa4g6t76X3wYj2GF VRauowMGiGghnYDkREN3eR1Iy97xCza08TP0H4nzfx6wU8x9gXPqWI4fWxGf84TQd0i9 yNwQ== ARC-Authentication-Results: i=2; mx.google.com; arc=pass (i=1 spf=pass spfdomain=valentinobst.de); spf=pass (google.com: domain of linux-kernel+bounces-28392-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28392-ouuuleilei=gmail.com@vger.kernel.org" Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [147.75.199.223]) by mx.google.com with ESMTPS id y10-20020a056214016a00b006816d1e04b2si2101731qvs.129.2024.01.16.16.16.52 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Jan 2024 16:16:52 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-28392-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223; Authentication-Results: mx.google.com; arc=pass (i=1 spf=pass spfdomain=valentinobst.de); spf=pass (google.com: domain of linux-kernel+bounces-28392-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28392-ouuuleilei=gmail.com@vger.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 ny.mirrors.kernel.org (Postfix) with ESMTPS id 687CF1C24B11 for ; Wed, 17 Jan 2024 00:16:52 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id DEA2079C2; Wed, 17 Jan 2024 00:16:21 +0000 (UTC) Received: from mout.kundenserver.de (mout.kundenserver.de [212.227.126.133]) (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 46C1210EB; Wed, 17 Jan 2024 00:16:16 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=212.227.126.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705450579; cv=none; b=hPKlkagP6CspIGiOf819QTawQBc9kS7/XvmZJtShOnKKkgPAkExysm8w3hW+vdT17r4I9Xva62wJhyZPFDPhLOvFEblfobCSj8aLhruNnoyX0TGteaqZ56z3eBks3pkadEM/jp0znRxaUCmOojzJ7KS9Mksb2om37Cb+HCI7xSo= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705450579; c=relaxed/simple; bh=29I8vQfcBLV9mwZoRiepEOKD8CS2T7TWmyPwGLAV5PM=; h=Received:From:To:Cc:Subject:Date:Message-ID:X-Mailer:In-Reply-To: References:MIME-Version:Content-Transfer-Encoding:X-Provags-ID: X-Spam-Flag:UI-OutboundReport; b=rf+0Yc6A+iMBpywfkuvvFA0ZMAx0ZVj4N7nWvoovex3D7PNEYEV1fujNTk3tnS17U8jqaGa/pJ7pUmB+q+1ndYDbAJFy6DawodEQHXywTdyKomRRW+Ap4G/ZXuw4ullBl/yUG3TfgQOjfTbTAmUhk7+MxeulXy4+eLIfFlEHBiw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=valentinobst.de; spf=pass smtp.mailfrom=valentinobst.de; arc=none smtp.client-ip=212.227.126.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=valentinobst.de Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=valentinobst.de Received: from localhost.localdomain ([217.245.156.100]) by mrelayeu.kundenserver.de (mreue012 [213.165.67.97]) with ESMTPSA (Nemesis) id 1M8Syu-1rUHJq0QJE-004Wpr; Wed, 17 Jan 2024 01:16:02 +0100 From: Valentin Obst To: Miguel Ojeda , Alex Gaynor , Wedson Almeida Filho Cc: Boqun Feng , Gary Guo , =?utf-8?q?Bj=C3=B6rn_Roy_Baron?= , Benno Lossin , Andreas Hindborg , Alice Ryhl , rust-for-linux@vger.kernel.org, linux-kernel@vger.kernel.org, Valentin Obst Subject: [PATCH 12/13] rust: kernel: remove unneeded doclink targets Date: Wed, 17 Jan 2024 01:15:49 +0100 Message-ID: <20240117001549.169160-1-kernel@valentinobst.de> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240116160141.165951-1-kernel@valentinobst.de> References: <20240116160141.165951-1-kernel@valentinobst.de> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Provags-ID: V03:K1:vKGsVDD4K4O8G0nQOnjmofp4+nIqOjtImagczD6YhwgfOa9ZS0K rV8quU1oxXtmNfI51VhLGnGngF55lx7+qIxTZLaYsSg3hjPOu4jdtXD3cCoqjNH+406CRDA Wgyvd6R06NJKSDsvdRJmyJReq3nixPvkDwGgwbJrSvOeYDwnM4ld3s1pEzILJH24wIHFAlB D1n2qF/b8uNVv4bKpxiZg== X-Spam-Flag: NO UI-OutboundReport: notjunk:1;M01:P0:3OczPoTzmTE=;S9W2oLrRDxGvXikdidPbco6b49/ iSusBm28Kp+2/S9krGAq/FWrQGGIs20nsXeQlDr+QvLPy1tZRtCQ5Yfg5adWgUi+BsVyM1+UH qotwLO6DsBzpuIlpHX7Ah0zYRgEk7H+qseieip9BYHgI7T2jg2T3OGrxXLok3IS+8qpSq6c1a t7oLfGyznK8sBC7we2kIcU9X/dKYmPJjTXstM+IZMvruddlJ2QuVe0IXHXIuKF9E03bMBw3Mv BRRA4TG9ZrbwIxJaZi2xE5zGytxJbw/Lcxvd/AZ+XHPqyoZN8KNnuQe2C/kgs86wUT1yBqBgu D3kDbVyzV38PhJiCvO/HE1+RxH6ONae2YXx1miUdl2UrSBi06jejPskoAhAr+CtlnYP8v9fAs PVdZyhCpdqHn681TZjqsRMAcwxYhD2nPpxGBtHitHa9KWUnwgUQYcWVcbaetJbeH6uDYabLmp 1otc6pYhxA+H6cGBRCGOVqw86hFssHkGUaI3cSpGz2L3qhDLkMZ0DxhLuW+f3MX4fYyfOGt0O eqAbIGmsgFo3/3J99SWk+6X8XU46Ir0F04QADjJgm0ADyrOviWzi/AALS4ObAiK20FxAEPFkV KubovKd639u8kp+sxkd4C3+oBb4XEc+ii5D8V4mIn9abVGdc//vzxaf2joOHtZieV1mH7yDEH lzNsQuRTFNu5DXn0HexkjqjBjy+p2Z57i5tlmi70hSk0O2Rq5HIFYbJU1rm6bCKxqwYFUvQSK V8Sn5s6bNkv8nFpwpgOWdBNTn2Qx7cfWbxMFVJ29MmPIGSZRuaVGg8+bpXDpBEpAiV+OBaaL8 CBZ5Kpp4WVEZSsUJZD3Oz3f/Yj3IFTpNrtVhZjbmfVhBjhbRmQ0c0TQwiV0O1+Q9HE2z5Dj0M /yYE8HCuQPWuAcQ== X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1788294581295437025 X-GMAIL-MSGID: 1788294581295437025 Remove explicit targets for doclinks in cases where rustdoc can determine the correct target by itself. The goal is to reduce verbosity in the source code. Signed-off-by: Valentin Obst Reviewed-by: Trevor Gross --- rust/kernel/workqueue.rs | 10 ---------- 1 file changed, 10 deletions(-) diff --git a/rust/kernel/workqueue.rs b/rust/kernel/workqueue.rs index aedf47f258bd..f63190b563d8 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),*>)?