Message ID | 20240116220411.168016-1-kernel@valentinobst.de |
---|---|
State | New |
Headers |
Return-Path: <linux-kernel+bounces-28329-ouuuleilei=gmail.com@vger.kernel.org> Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:42cf:b0:101:a8e8:374 with SMTP id q15csp563934dye; Tue, 16 Jan 2024 14:41:27 -0800 (PST) X-Google-Smtp-Source: AGHT+IHizCzSo40skMUBPfX7sn2o1+8BVmDU+mH3eLbnFTVpIVrLjvxj1HfscezTgHuKLBukzphQ X-Received: by 2002:a05:600c:4ed0:b0:40c:3664:aeaa with SMTP id g16-20020a05600c4ed000b0040c3664aeaamr2808805wmq.148.1705444887104; Tue, 16 Jan 2024 14:41:27 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705444887; cv=pass; d=google.com; s=arc-20160816; b=IlIvekHJV8SdezJxMTwXvk1APHEbwW2rSlOryvLDuDUfx1xuhmkaxlP8BMV3X36p6l QLc3Zvyf89bpdzMW3U/iSfTwicYnw2ARPFzbvJL8xP4WXqD1gHQ2RUnpbpQMgHZKIkFl TxVHBm8xq8sRFaokHPN/WeKNyNNqoeNiA8O1NE/+BpI5nt7GZEZTTwxsf61OjFOFSNf7 XSTCitlrhtniJJ5zG6MRhPSjQdx38ZCXsf8j3GMdBH5Rde8lt7jhLZ+tjHtdDLYDTK2n jtog9O/0ofwHZ6OPlHEw7LrsyalGizNSkDcFsBMxzCOPunHgMjRh7SfHDeCzg7WCVsPb s8Qw== 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=Tag1d2mssc0MHnZuaZ9wbBj71h2REcogo7VgQRwU7Z4=; fh=mB5qiQ7ps5IWvjuQS9+zcxjK3ZInVolb8UwIN1mvAmg=; b=PQN+fuMoUhqAj4g2OIixi/qYEOYNCAkzrzEoR8h3uqAYIncNPMRrdhWwmwWS9cyxDu TLlYAiUyop+wcGrKY6Lp+aZmxjslCehPCJ5mBWSxr04o+jp2vtuJQ+1WaIQs8ztqiwIC yxLRkjaElHvmpAjFNwiZavfFJZ+Xl+E1evHtL8ceFP82gyg+XQkLxP3balVcYKIqyWZ4 OTOF2u4EFoLL1jxorU3oaMQ/5oxsVIMCSAn0t96TZ+XAnNR6c/ngHYMfxp571ow+VGGU HENS96IkULnXdqrVFF8AJ4tjSxG1JWUc+3OU0lo6OJCvKMGE9w+5ktGOoZxOoLBZ9TL7 NL7g== 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-28329-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28329-ouuuleilei=gmail.com@vger.kernel.org" Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [2604:1380:4601:e00::3]) by mx.google.com with ESMTPS id er26-20020a056402449a00b00559951ab95esi1017252edb.475.2024.01.16.14.41.26 for <ouuuleilei@gmail.com> (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Jan 2024 14:41:27 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-28329-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3; Authentication-Results: mx.google.com; arc=pass (i=1 spf=pass spfdomain=valentinobst.de); spf=pass (google.com: domain of linux-kernel+bounces-28329-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28329-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 am.mirrors.kernel.org (Postfix) with ESMTPS id 7B9EA1F2A7A7 for <ouuuleilei@gmail.com>; Tue, 16 Jan 2024 22:36:00 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id D074F47A4C; Tue, 16 Jan 2024 22:05:36 +0000 (UTC) Received: from mout.kundenserver.de (mout.kundenserver.de [217.72.192.74]) (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 5AE7120B02; Tue, 16 Jan 2024 22:05:30 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=217.72.192.74 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705442735; cv=none; b=uEttqz2Mv17plhfb5+D+6IkuMQAg4U09vCyfRRxRMApR+rwfv9ZRUd6eTBJX3C8O6jGMLSbfuOJNMKsMvjfC7WdeLzZfH6ABihelpvqDOB61PQZqjAx5MFjNBd9rTD4E4ScTtGMR/+a3ItP9y590NaXxHiFVThksJyoIQoJHrBI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705442735; c=relaxed/simple; bh=v3W324I3SJN5eST/f93Ey55QMVR0yTzOUMu2onl9OUo=; 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=QYmLgj2niyxc646i/ZbLp4CdddHgj/Ait9nsV2p7dK75xXvbrmjMNGzvhVAXLiMpmhJ6wn8KD941lDMnJ7dWrBXd6m6mIp6mdbWTDPpimG/4VyPV2JK95OSKjCJLFCkNhS+EbY9v4ivjSDEQ2hJPPcrvcntDyeo4+5A2hpBiROM= 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=217.72.192.74 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 (mreue108 [213.165.67.113]) with ESMTPSA (Nemesis) id 1MTREY-1rZe9L2Zf2-00TjKy; Tue, 16 Jan 2024 23:05:11 +0100 From: Valentin Obst <kernel@valentinobst.de> To: Miguel Ojeda <ojeda@kernel.org>, Alex Gaynor <alex.gaynor@gmail.com>, Wedson Almeida Filho <wedsonaf@gmail.com> Cc: Boqun Feng <boqun.feng@gmail.com>, Gary Guo <gary@garyguo.net>, =?utf-8?q?Bj=C3=B6rn_Roy_Baron?= <bjorn3_gh@protonmail.com>, Benno Lossin <benno.lossin@proton.me>, Andreas Hindborg <a.hindborg@samsung.com>, Alice Ryhl <aliceryhl@google.com>, rust-for-linux@vger.kernel.org, linux-kernel@vger.kernel.org, Valentin Obst <kernel@valentinobst.de> Subject: [PATCH 04/13] rust: kernel: add srctree-relative doclinks Date: Tue, 16 Jan 2024 23:04:10 +0100 Message-ID: <20240116220411.168016-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: <linux-kernel.vger.kernel.org> List-Subscribe: <mailto:linux-kernel+subscribe@vger.kernel.org> List-Unsubscribe: <mailto:linux-kernel+unsubscribe@vger.kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Provags-ID: V03:K1:0M/3h7s7GfvVM/sxSkwa13j4UXMw4UFVXCpvMlk36g4VyCdY5Av OpuLrkYGR2CTa0uchs9tvp44C5cLONl9yZzzNKwRHjmSOVtWZWANmcrllTypzFRDeC9bYy5 njtvU/C/HW3BH0Qv97g5SubpLt62cTWKHLvOYrsj5G+USM8b5tZ0yZsfH0BPBMmGdTSLApM uc2SC1Dq7y+yHtEsN4IGw== X-Spam-Flag: NO UI-OutboundReport: notjunk:1;M01:P0:karToRGKwJs=;uQ8K1v7C/+Wu1/QtFmFaiddcSo0 7aM4nFV9VR1/HqQilEl5s21ew29uEuaIZfn72dP0+1Ql5lZ4O3pzFDwx55RG4hdMMqAMeNJlC pHuad1+d5GhhOdD6OCNEELTmfJ2e8BFceTWDV9IIc0K4ZZ0nV8MpUD4FV9lPVEH1XQBDvJWEt DE/UM2Gva7O2WiTuUkRE9BqHbC1K2PPgA63kCzOA0HX2JYLZglrGZTrF85lBBgKrKxqgHWpXE H7DQymgZoVRNeHTT4L4b5Uu46fFnGF3qRuDLCmCc/sel3RvWXltCilfu/3KziGC+X1mhBS4xZ 4SAMUd47/IWQRD/dJrMX5VvHUDMi6e0mubSrpLiBvvhZlyUmHVYZdqQfEsnxsvx76ydQgF+jc lZ1Khpr7rkdxyJcX5Ovf4j+52OBmADhGHtBgTcBoofLU9R6YzGnkhxAyXZ87EaSB02bgEPMcw /q/eTZv+FFGRqdh6zo517pW5ELsKzsVyLqmO7JqKD9FtpU/4sxDkd/r0hSV25iZYaptT5h/x+ SgBydIBhJ8fWxELgbDU94LtayPlJL3SkRkiiJ3mO4eZrK6CVCP69lXSZlojirpvrko2BrydUV iEMxOLo5kULu3dG5l2umGK0LJQY5bCk0Na+nF/4bYSP4XMTQGotvC1fQEMKNACRH4jLpKCkNw +jLPiuzsXC9Huq+bocJTiKQAFwpn9LMd3txpda2EgO1i/N20SbicY19TLE5M+FWHKnKxmTr3v PKUephOrwVcWwW8v6gaO+N+oUZy1FoAE1OIDwNWTkAGlOIjV65mb8eC6CF3Cr1CfytNEyL0/P Us/BhLxoyldPeH3Uto60ujLd7TBh45sfxLIGiwePrK2a0zkH8Y9QErSBahAEFDM7ZB+5CwKq+ NAewvcPu8JiJXiQ== X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1788288577960161705 X-GMAIL-MSGID: 1788288577960161705 |
Series |
rust: kernel: documentation improvements
|
|
Commit Message
Valentin Obst
Jan. 16, 2024, 10:04 p.m. UTC
Convert existing references to C header files to make use of
Commit bc2e7d5c298a ("rust: support `srctree`-relative links").
Signed-off-by: Valentin Obst <kernel@valentinobst.de>
---
rust/kernel/lib.rs | 2 +-
rust/kernel/sync/condvar.rs | 2 ++
2 files changed, 3 insertions(+), 1 deletion(-)
Comments
On Tue, Jan 16, 2024 at 5:35 PM Valentin Obst <kernel@valentinobst.de> wrote: > > Convert existing references to C header files to make use of > Commit bc2e7d5c298a ("rust: support `srctree`-relative links"). > > Signed-off-by: Valentin Obst <kernel@valentinobst.de> > --- > rust/kernel/lib.rs | 2 +- > rust/kernel/sync/condvar.rs | 2 ++ > 2 files changed, 3 insertions(+), 1 deletion(-) > > diff --git a/rust/kernel/lib.rs b/rust/kernel/lib.rs > index e6aff80b521f..0d365c71cae2 100644 > --- a/rust/kernel/lib.rs > +++ b/rust/kernel/lib.rs > @@ -75,7 +75,7 @@ pub trait Module: Sized + Sync { > > /// Equivalent to `THIS_MODULE` in the C API. > /// > -/// C header: `include/linux/export.h` > +/// C header: [`include/linux/export.h`](srctree/include/linux/export.h) > pub struct ThisModule(*mut bindings::module); > > // SAFETY: `THIS_MODULE` may be used from all threads within a module. > diff --git a/rust/kernel/sync/condvar.rs b/rust/kernel/sync/condvar.rs > index f65e19d5a37c..0bb76400efd9 100644 > --- a/rust/kernel/sync/condvar.rs > +++ b/rust/kernel/sync/condvar.rs > @@ -77,6 +77,8 @@ pub struct CondVar { > > /// A condvar needs to be pinned because it contains a [`struct list_head`] that is > /// self-referential, so it cannot be safely moved once it is initialised. > + /// > + /// [`struct list_head`]: srctree/include/linux/types.h Hm, I wonder if we could figure out a way to make links point to specific definitions in the C headers with # anchors. I'm not sure what the intended platform to view these links is. > #[pin] > _pin: PhantomPinned, > } > -- > 2.43.0 > > Reviewed-by: Trevor Gross <tmgross@umich.edu>
> Hm, I wonder if we could figure out a way to make links point to > specific definitions in the C headers with # anchors. I'm not sure > what the intended platform to view these links is. Currently the links simply open the plain .h file from your local tree in your browser, i.e., ```rust /// [`struct wait_queue_head`]: srctree/include/linux/wait.h ``` becomes something like: file:///mnt/build/rust-for-linux/rust4lx/include/linux/wait.h and fragments won't work on that. I agree that it would be nice to link to type definitions, variables, functions, ect. in the file, maybe with something like: ``` #(type|var|func);<identifier> ``` However, I think this will require some parsing and embedding the C source file into some html.
diff --git a/rust/kernel/lib.rs b/rust/kernel/lib.rs index e6aff80b521f..0d365c71cae2 100644 --- a/rust/kernel/lib.rs +++ b/rust/kernel/lib.rs @@ -75,7 +75,7 @@ pub trait Module: Sized + Sync { /// Equivalent to `THIS_MODULE` in the C API. /// -/// C header: `include/linux/export.h` +/// C header: [`include/linux/export.h`](srctree/include/linux/export.h) pub struct ThisModule(*mut bindings::module); // SAFETY: `THIS_MODULE` may be used from all threads within a module. diff --git a/rust/kernel/sync/condvar.rs b/rust/kernel/sync/condvar.rs index f65e19d5a37c..0bb76400efd9 100644 --- a/rust/kernel/sync/condvar.rs +++ b/rust/kernel/sync/condvar.rs @@ -77,6 +77,8 @@ pub struct CondVar { /// A condvar needs to be pinned because it contains a [`struct list_head`] that is /// self-referential, so it cannot be safely moved once it is initialised. + /// + /// [`struct list_head`]: srctree/include/linux/types.h #[pin] _pin: PhantomPinned, }