From patchwork Wed Dec 7 17:30:52 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Carlos Bilbao X-Patchwork-Id: 30960 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:f944:0:0:0:0:0 with SMTP id q4csp320337wrr; Wed, 7 Dec 2022 09:44:18 -0800 (PST) X-Google-Smtp-Source: AA0mqf6BZIHe14ipIOrQxjKLdSEdCt13turbLc7VSHxIFdkYOvx4XAN7TH08oSw9G8HV+4koYeg4 X-Received: by 2002:a05:6402:386:b0:46c:a1e7:5994 with SMTP id o6-20020a056402038600b0046ca1e75994mr13474527edv.288.1670435058429; Wed, 07 Dec 2022 09:44:18 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1670435058; cv=pass; d=google.com; s=arc-20160816; b=ZeoUx99rMyafOhFHdU7gRRMZX371KovCLpeof+J5zF9+9N6gy5CyRigTtcR+MvWmvk lJHpyU1vHqa2C5D9NZ4hNCxlBMVt6kJPbfZP1FfVOsnpBRJnxo55Vt71kD9gCREqARNl 8oWVzb7GgXfKtUR889cF9S1N/5JZArnNYOKHVZDfSqgGTf7Hz3pKDta76uZvSyy6OMy7 OIO6IslgNDX3otMNSSEyUq9rRHMd2ORDzxCZIMLNres6Jj8C8zBP89RBjmw6OMoM96sl zXhZuh72SVLBgLGB5/IUHg1gBhLptOXc7QFY6coLPEUcAqEEVZZBvBkYZw/W/NpVb27R oWog== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=Nt9UZb1a7DDvTNjM44NL7DYobcejXgPoy/2LXXB9t5Y=; b=IOh4dMdqHudmn1WBb8eUSn7KuV4JUAbeEop6Hx0q6PHC5VkBQrzgH1eLx9oWjt8gwa RQ/sc1VJJe2eTjedAmNuxe+hOow+KT7YgHq9zqTrXDICg/h5EEEfD4q0nohg231hCtBx YmyM+Xdsl/deycPlaEQjKRk/juJX1q7YRdJgQW4RtW+6BfuxFRLdHQKM61JJgZDOlke4 Jg7Dmfzslsu6YEpeE+GwcfwlQjnkcF70XyUuN7nsowEfCGzCSuAmWpsRp38vPOpC2q0Y BRTqKLLkypCO1PfDR3oShjBnRNEQFTzinGwSULhcc8tBE9oguYHqN6N8ttP1crErdAiN ULcg== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@amd.com header.s=selector1 header.b=fBdBgIZb; arc=pass (i=1 spf=pass spfdomain=amd.com dmarc=pass fromdomain=amd.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=amd.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id mp26-20020a1709071b1a00b007adf3067a4esi11045292ejc.490.2022.12.07.09.43.55; Wed, 07 Dec 2022 09:44:18 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@amd.com header.s=selector1 header.b=fBdBgIZb; arc=pass (i=1 spf=pass spfdomain=amd.com dmarc=pass fromdomain=amd.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=amd.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229790AbiLGRbA (ORCPT + 99 others); Wed, 7 Dec 2022 12:31:00 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:38510 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229619AbiLGRa6 (ORCPT ); Wed, 7 Dec 2022 12:30:58 -0500 Received: from NAM12-BN8-obe.outbound.protection.outlook.com (mail-bn8nam12on2044.outbound.protection.outlook.com [40.107.237.44]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D666425C5; Wed, 7 Dec 2022 09:30:57 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=LssEoZOEwpy1H6Mx+fbN2UL1lktjoPL4xB0Bz8Q7IoQDghzpbnSN32G7hlT6XaueppFCbJwT4uRYHSzCi7rvdHooQTsOoSip8uPIVxC9uKnfAjjd4SdAbD3UaK7Alsb85Jo66C2V/3lzhX/ytULQRbIdky4S2cj6JTrQ7NxdHhN3DcmIFo/tduX3OJS8ukzPwDU/RikYA6qCSBQxN8g4amVCllH6ir1KBRq7sv1BNl/Aee7ktHDN1Dh/qb7meU0oltLyTMA+GWAnU4y+xrD8Fi/M+FhxuZ48vhUY8MgudzXFgsgzgEZU+sZQkdSoiq10DQDvN/1k4iqHS84AHLYPVg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=Nt9UZb1a7DDvTNjM44NL7DYobcejXgPoy/2LXXB9t5Y=; b=HL2KtKD+wMA2yVrO+Fo375PWYZe8TcK8zEhJZGyJUxGMx1JhbV2X91qL3870Jfuil5alpuCuJtiFI+TGGKD/YK2puT+quhRbYlVsL/KbKF7Vhxh2ilPsPcxRV23m/BKlxJD9ZyLFT2cKoNyK2nsgCvjRj2dmnEAg/pFNx9aSkRSYwFeyeu4YSwZvxOK/GR7RbQC20W5eZEru2e8tdjSKpzY6y1p9u+IvF73lulzSfGvHD6nND6DpiA2c8sjcBR4EPHOsNPbF5j5K5U3e1ManAtaUmZHU1UV8vMV7MiBxg5Pk+kvbxffCKeVQjz+FOdJdozK67+usHG6r3zSiWwrFkg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 165.204.84.17) smtp.rcpttodomain=kernel.org smtp.mailfrom=amd.com; dmarc=pass (p=quarantine sp=quarantine pct=100) action=none header.from=amd.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Nt9UZb1a7DDvTNjM44NL7DYobcejXgPoy/2LXXB9t5Y=; b=fBdBgIZb72StbiEKW7QDxOLuS17bNvPjfInZMC/1Jc9Or0NKNdiNHYaNVQXtJFAHW19NpB0xAxe9A0+hLtseyFEQen4ozxmcWbchCBrU8Fx826oQaKZNFxdxGpg6zBh/c2M5JrKg8SRiHn8Bv6MVcSyoeUbYb8nzLdpYOGlOgRw= Received: from DM6PR03CA0052.namprd03.prod.outlook.com (2603:10b6:5:100::29) by MN2PR12MB4094.namprd12.prod.outlook.com (2603:10b6:208:15f::23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5880.14; Wed, 7 Dec 2022 17:30:55 +0000 Received: from DM6NAM11FT076.eop-nam11.prod.protection.outlook.com (2603:10b6:5:100:cafe::19) by DM6PR03CA0052.outlook.office365.com (2603:10b6:5:100::29) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5880.14 via Frontend Transport; Wed, 7 Dec 2022 17:30:55 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 165.204.84.17) smtp.mailfrom=amd.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=amd.com; Received-SPF: Pass (protection.outlook.com: domain of amd.com designates 165.204.84.17 as permitted sender) receiver=protection.outlook.com; client-ip=165.204.84.17; helo=SATLEXMB03.amd.com; pr=C Received: from SATLEXMB03.amd.com (165.204.84.17) by DM6NAM11FT076.mail.protection.outlook.com (10.13.173.204) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.5901.16 via Frontend Transport; Wed, 7 Dec 2022 17:30:55 +0000 Received: from SATLEXMB03.amd.com (10.181.40.144) by SATLEXMB03.amd.com (10.181.40.144) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.34; Wed, 7 Dec 2022 11:30:54 -0600 Received: from iron-maiden.amd.com (10.180.168.240) by SATLEXMB03.amd.com (10.181.40.144) with Microsoft SMTP Server id 15.1.2375.34 via Frontend Transport; Wed, 7 Dec 2022 11:30:54 -0600 From: Carlos Bilbao To: , , , , CC: , , , Carlos Bilbao Subject: [PATCH v4 1/2] docs: Move rustdoc output, cross-reference it Date: Wed, 7 Dec 2022 11:30:52 -0600 Message-ID: <20221207173053.1463800-2-carlos.bilbao@amd.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20221207173053.1463800-1-carlos.bilbao@amd.com> References: <20221207173053.1463800-1-carlos.bilbao@amd.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM6NAM11FT076:EE_|MN2PR12MB4094:EE_ X-MS-Office365-Filtering-Correlation-Id: 1d0dc3ef-66c3-45e2-f220-08dad878cbce X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: cvx93BpocbJjMIMxWGUg2KCYnEogZo/WhzkRHqubdwyDNuiYH72MIbb3QPXJvfxzOeI0AW5muNiDTgToQjHMslAGYg66mEAUWF3o0PeIy+f6EYTAnoinPor6ma5zbns5ZHD2xbv93aVECkZTY4R6NI17iV9PaCQ+B7QNAj59IXukyuxaqlXyZbcudrmUxRX4P3FHGxXtO5Q3qRONj8v7G+AKoKAZ4kezCUqIT0LJrA4WYRps8M8iYlz1aauf3dfKqNZCOO2mjkUYGYB1MMPvNo8cFBV8lPEGJyXRTzDGf0pm4zMXyr86fGe06tLv1gt1tWPjIyPfQGxe2H9Qv6DKdekXjK+n7roZfGH4bSVVQY0WfQUSmKpYimz3f/hlP5523PxVGVcib64RCE6VG8TbKDFtaRkCwA+v5iLsBKT9NOwAjOHX6adSC6nf0WTcRSXE82fOsLRpsXsd5zaAelsxnPqGBDaHO+CFP7/jWJXmQ3+Cz2nlThliHCf6noJkycH75bFLRWrmXcQ10S6491XGSh8abQ0Y5AVdYpiNj8pkpaxf4IIIE+Q/H8l56Lnh/ja4AQgK8x8XiJA2q4yyRlnWp/XVEDZMc2fUvDki711TKsWuVuhd6W4s1z41Yz+RwdUU4C9O7zg3Pg8ByAUvt86/AaJgH3/+ZnFBess3BexmesUZI7W5A7po6tNBOpQUvc8qi6kIBlVeYE3h/rtTzZBrkbhIlyk5pnLj5wu136v2qsw= X-Forefront-Antispam-Report: CIP:165.204.84.17;CTRY:US;LANG:en;SCL:1;SRV:;IPV:CAL;SFV:NSPM;H:SATLEXMB03.amd.com;PTR:InfoDomainNonexistent;CAT:NONE;SFS:(13230022)(4636009)(396003)(346002)(39860400002)(376002)(136003)(451199015)(46966006)(40470700004)(36840700001)(2906002)(478600001)(7696005)(4326008)(70586007)(36860700001)(41300700001)(8676002)(40480700001)(70206006)(356005)(36756003)(82740400003)(81166007)(40460700003)(1076003)(2616005)(47076005)(426003)(82310400005)(316002)(86362001)(186003)(26005)(54906003)(110136005)(83380400001)(8936002)(336012)(44832011)(5660300002)(36900700001);DIR:OUT;SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Dec 2022 17:30:55.2577 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 1d0dc3ef-66c3-45e2-f220-08dad878cbce X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=3dd8961f-e488-4e60-8e11-a82d994e183d;Ip=[165.204.84.17];Helo=[SATLEXMB03.amd.com] X-MS-Exchange-CrossTenant-AuthSource: DM6NAM11FT076.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR12MB4094 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1751578111812195040?= X-GMAIL-MSGID: =?utf-8?q?1751578111812195040?= Generate rustdoc documentation with the rest of subsystem's documentation in Documentation/output. Add a cross reference to the generated rustdoc in Documentation/rust/index.rst if Sphinx target rustdoc is set. Reviewed-by: Akira Yokosawa Signed-off-by: Carlos Bilbao --- Documentation/rust/index.rst | 8 ++++++++ rust/Makefile | 15 +++++++++------ 2 files changed, 17 insertions(+), 6 deletions(-) diff --git a/Documentation/rust/index.rst b/Documentation/rust/index.rst index 4ae8c66b94fa..4fc97c1eb1d1 100644 --- a/Documentation/rust/index.rst +++ b/Documentation/rust/index.rst @@ -6,6 +6,14 @@ Rust Documentation related to Rust within the kernel. To start using Rust in the kernel, please read the quick-start.rst guide. +.. only:: rustdoc + + You can also browse `rustdoc documentation `_. + +.. only:: not rustdoc + + This documentation does not include rustdoc generated information. + .. toctree:: :maxdepth: 1 diff --git a/rust/Makefile b/rust/Makefile index 7700d3853404..080c07048065 100644 --- a/rust/Makefile +++ b/rust/Makefile @@ -1,5 +1,8 @@ # SPDX-License-Identifier: GPL-2.0 +# Where to place rustdoc generated documentation +RUSTDOC_OUTPUT = $(objtree)/Documentation/output/rust/rustdoc + always-$(CONFIG_RUST) += target.json no-clean-files += target.json @@ -58,7 +61,7 @@ quiet_cmd_rustdoc = RUSTDOC $(if $(rustdoc_host),H, ) $< OBJTREE=$(abspath $(objtree)) \ $(RUSTDOC) $(if $(rustdoc_host),$(rust_common_flags),$(rust_flags)) \ $(rustc_target_flags) -L$(objtree)/$(obj) \ - --output $(objtree)/$(obj)/doc \ + --output $(RUSTDOC_OUTPUT) \ --crate-name $(subst rustdoc-,,$@) \ @$(objtree)/include/generated/rustc_cfg $< @@ -75,15 +78,15 @@ quiet_cmd_rustdoc = RUSTDOC $(if $(rustdoc_host),H, ) $< # and then retouch the generated files. rustdoc: rustdoc-core rustdoc-macros rustdoc-compiler_builtins \ rustdoc-alloc rustdoc-kernel - $(Q)cp $(srctree)/Documentation/images/logo.svg $(objtree)/$(obj)/doc - $(Q)cp $(srctree)/Documentation/images/COPYING-logo $(objtree)/$(obj)/doc - $(Q)find $(objtree)/$(obj)/doc -name '*.html' -type f -print0 | xargs -0 sed -Ei \ + $(Q)cp $(srctree)/Documentation/images/logo.svg $(RUSTDOC_OUTPUT) + $(Q)cp $(srctree)/Documentation/images/COPYING-logo $(RUSTDOC_OUTPUT) + $(Q)find $(RUSTDOC_OUTPUT) -name '*.html' -type f -print0 | xargs -0 sed -Ei \ -e 's:rust-logo\.svg:logo.svg:g' \ -e 's:rust-logo\.png:logo.svg:g' \ -e 's:favicon\.svg:logo.svg:g' \ -e 's:::g' $(Q)echo '.logo-container > img { object-fit: contain; }' \ - >> $(objtree)/$(obj)/doc/rustdoc.css + >> $(RUSTDOC_OUTPUT)/rustdoc.css rustdoc-macros: private rustdoc_host = yes rustdoc-macros: private rustc_target_flags = --crate-type proc-macro \ @@ -141,7 +144,7 @@ quiet_cmd_rustdoc_test = RUSTDOC T $< @$(objtree)/include/generated/rustc_cfg \ $(rustc_target_flags) $(rustdoc_test_target_flags) \ --sysroot $(objtree)/$(obj)/test/sysroot $(rustdoc_test_quiet) \ - -L$(objtree)/$(obj)/test --output $(objtree)/$(obj)/doc \ + -L$(objtree)/$(obj)/test --output $(RUSTDOC_OUTPUT) \ --crate-name $(subst rusttest-,,$@) $< # We cannot use `-Zpanic-abort-tests` because some tests are dynamic, From patchwork Wed Dec 7 17:30:53 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Carlos Bilbao X-Patchwork-Id: 30959 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:f944:0:0:0:0:0 with SMTP id q4csp317719wrr; Wed, 7 Dec 2022 09:38:50 -0800 (PST) X-Google-Smtp-Source: AA0mqf4srEc2GVaQxF2OFFOoauA53GlAclV33ECtx0Wad/KKXTtf1Gbn5rw1X/nsa+yvh8baol6q X-Received: by 2002:a05:6402:170f:b0:46b:f96c:98b4 with SMTP id y15-20020a056402170f00b0046bf96c98b4mr24665188edu.341.1670434730674; Wed, 07 Dec 2022 09:38:50 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1670434730; cv=pass; d=google.com; s=arc-20160816; b=iecwU4Gh3OmLOV3iVmbsUkBUrLDN4mOy7zEaEY/a8YdV7Mz8M00/MAi2hyoq/FNqqC ixjv4fQuq/gN510EHN5ceOMz7hh+rmQsTFqovh5RXenAMvV+fofCEV/wj22MZRnBknHj i7MwL+oSaM+qyfUy60bNnzgUK7BoYBULScYIILanrIBE5bbfApMsNactVD8j2kGcPwhZ 7vM33VIpiBjPm52vJAjszjKVrCrXjEJkFIpwqbWow6ji7BcqdZ3GlSOQ3qzAbukjPTqz 54y4x/g6+dmhyoUN/UwrvbNIM7yrOm8Us9SrJFD/zqoPw1pCtApmDsZFeCWy5vuOb9Fx mHyw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=b3N527NZ1kQy3eKrJFn2M95pS/7egEFzSPa6utMlUTw=; b=MhvkK9i1lyiqSGfdTOcPG7+UNaMFsRrrhXwimf4bqmSipJxBtMwDucZxZiKzY44l/N OESA9ks+ydV4eYYRnXvPhiZD5u8IqLfOhHxAbkzEP1ozJeTLDiYYVgk7i9rH3ptC7pis xdOOMSP71FtDc1Nls39ITcVfy/Z0C1fWUO0H57/gIHagbZgRH4has3kgfHPpm45F/5PM gNK1hqGGLnJ/QKRubnld0T5M3eGLWBhy/dSHDbCkIwKH+97uxIxI2mil/y54ac3A9ECd MTwvOcN0br5VRsgZKeo//wEnD/PMUHXR8VGWqVdO1sJRZ+ruAeW8aMqnYNxnunbjuoG6 5kvg== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@amd.com header.s=selector1 header.b="VGA5I8/i"; arc=pass (i=1 spf=pass spfdomain=amd.com dmarc=pass fromdomain=amd.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=amd.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id dp15-20020a170906c14f00b007ad8bc64c89si5351234ejc.701.2022.12.07.09.38.28; Wed, 07 Dec 2022 09:38:50 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@amd.com header.s=selector1 header.b="VGA5I8/i"; arc=pass (i=1 spf=pass spfdomain=amd.com dmarc=pass fromdomain=amd.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=amd.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229937AbiLGRbH (ORCPT + 99 others); Wed, 7 Dec 2022 12:31:07 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:38576 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229649AbiLGRbB (ORCPT ); Wed, 7 Dec 2022 12:31:01 -0500 Received: from NAM10-MW2-obe.outbound.protection.outlook.com (mail-mw2nam10on2074.outbound.protection.outlook.com [40.107.94.74]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 126C35F83; Wed, 7 Dec 2022 09:31:00 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=UsC/WRcbjV2WJzQxuctTD8fCn819hVyHbaNI351m8j08DmuhvwdZXpWkt5pKfJYrcuV5AkXmjn8iVCJUM0ploejbk79vxE9gSkPxn85/iRS8LRcYiSxE2R88v/jtdI+CpeozNysbeOJpk8fAUUqBliW22HUZvSv0fiT1QHx4L1RCF+EXl+g2ec4VXzxJMKFqH0d5Xk9jnMaw1EalD/3WLpnfJzgNmrQAKCCkL+TlNPmfqOWWTYXrS1c/DCW1UWNLUbZZEZN2TgHCipFtGNV57regEx87aIH37DeiTPSIrO+RJzKZig8NwubAYDcLgq+xngY1qb6/1t7NKeWDo1hfWw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=b3N527NZ1kQy3eKrJFn2M95pS/7egEFzSPa6utMlUTw=; b=BgDnSb7pR+OZZzqQ3VSbasvGjydHqiPTWFl05cDKaY3W2XwLJ0lHjkFsQ9pgk0uy0XtX0A1OYY1dqLHKdxAZw4vfQq69aYLVo5roRvbMxQvhKg1By3VDZVUQ54wB90Ac6Ek16mK1AOUMLnfM2iHoFumHd48BXJbhds73kBJ9UzpfbLQP2WVbZgw42+X6l7tsKbcGU53wcYv/E88uJackEFOikUoQi7fvG4UQTT4V4UczfSuiIUNhB6qEVehC/JY9/EHlrlNZWS8/kIMxJeJXpspPsLq2ukoSjHblD1hCvi2NAeQc0Aae7w7TFVjriU3eyzMt2Jm5usxhg2KCj6nNYw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 165.204.84.17) smtp.rcpttodomain=kernel.org smtp.mailfrom=amd.com; dmarc=pass (p=quarantine sp=quarantine pct=100) action=none header.from=amd.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=b3N527NZ1kQy3eKrJFn2M95pS/7egEFzSPa6utMlUTw=; b=VGA5I8/iYXYOeRvtwvmwjWMa+gzDIgxdSNr81R0HDKcnk9HQkE7s083T2jKVoT+5NAblQ1VSQ+h14oZHYxdHQXom8T4bXDuA7txFmW2qXl+nMbUdYAuhAOwMJHKpNYULnJwm9r3q8evJJf91+zOKfg0r6pofsKxwmsMqrNpi6zI= Received: from BN8PR16CA0010.namprd16.prod.outlook.com (2603:10b6:408:4c::23) by SA3PR12MB7903.namprd12.prod.outlook.com (2603:10b6:806:307::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5880.14; Wed, 7 Dec 2022 17:30:56 +0000 Received: from BN8NAM11FT085.eop-nam11.prod.protection.outlook.com (2603:10b6:408:4c:cafe::d3) by BN8PR16CA0010.outlook.office365.com (2603:10b6:408:4c::23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5880.8 via Frontend Transport; Wed, 7 Dec 2022 17:30:56 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 165.204.84.17) smtp.mailfrom=amd.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=amd.com; Received-SPF: Pass (protection.outlook.com: domain of amd.com designates 165.204.84.17 as permitted sender) receiver=protection.outlook.com; client-ip=165.204.84.17; helo=SATLEXMB04.amd.com; pr=C Received: from SATLEXMB04.amd.com (165.204.84.17) by BN8NAM11FT085.mail.protection.outlook.com (10.13.176.100) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.5901.16 via Frontend Transport; Wed, 7 Dec 2022 17:30:56 +0000 Received: from SATLEXMB08.amd.com (10.181.40.132) by SATLEXMB04.amd.com (10.181.40.145) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.34; Wed, 7 Dec 2022 11:30:55 -0600 Received: from SATLEXMB03.amd.com (10.181.40.144) by SATLEXMB08.amd.com (10.181.40.132) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.34; Wed, 7 Dec 2022 09:30:55 -0800 Received: from iron-maiden.amd.com (10.180.168.240) by SATLEXMB03.amd.com (10.181.40.144) with Microsoft SMTP Server id 15.1.2375.34 via Frontend Transport; Wed, 7 Dec 2022 11:30:54 -0600 From: Carlos Bilbao To: , , , , CC: , , , Carlos Bilbao Subject: [PATCH v4 2/2] docs: Integrate rustdoc generation into htmldocs Date: Wed, 7 Dec 2022 11:30:53 -0600 Message-ID: <20221207173053.1463800-3-carlos.bilbao@amd.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20221207173053.1463800-1-carlos.bilbao@amd.com> References: <20221207173053.1463800-1-carlos.bilbao@amd.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: BN8NAM11FT085:EE_|SA3PR12MB7903:EE_ X-MS-Office365-Filtering-Correlation-Id: cae996c6-2b5b-472b-7c01-08dad878cc5a X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: fpvEdOmOH0eyww9Is0/Hpvveg7RqsgP3sR83isfxuqIGUXJVRz2WzyXsCqTLad0LM13T10m60f45atu7xXPqqxl9e+ZxEy0ByL5sEXJRxD+ipt2hhuwN7bdUDbL/yggVD1QZr6HHkKGPgXhegmLeP6959yGqIKMTYw7pPfTq5zkZ1Hk8BSlDXWxMcGGAN6ofmWcnoBOQkvHiFKx278w7Tf2aSHSdWCdVhHz7MQzs3OgtUQq4735+1/cmq57xn3BqWNXkpFraVe+xu05SRGQ30WC7UNN6R0W73NsI7XNVOcs62Cxm2ddT5psR2Ey9xjf0VJK3keR3KZdZWsE3vyy3laAhVxoh+MaELVziWqqBkuMU1i0JzYf1KwLowLE+gEqLIv3GinGfOBGbxIAfvflhRgQCjKs/4Yf2TkevwqlQ7Uspbnb2HFejhaEC4c2QGa3HU7/YtGUfYGOtF0TLGZvPGLlOAq4fpxs3sbQs5OgOiaWyvCS5m3sK2Tuotwy1GXKOYJp7DQSdlgWec92I/q6YiHV5WRf37FmQI+l5g6GaAp++f0s1XKH+s/tnXWZUDmWtrYvx8gBFmi2qq4S3DnI7E+iWpuiZYsRsmyqLuptz/oZtVb6bcjxlYOQhB7jB7x5F63uIoWPKJWSAI5xXkRAcTCIwsQcMiARdKhX77DrlecNnnb+ZUZSJelkToM15WUfbQGZvFgEXnZROFa21Vd6h3oNbHoj9dgCn3FGaUT0JtW4= X-Forefront-Antispam-Report: CIP:165.204.84.17;CTRY:US;LANG:en;SCL:1;SRV:;IPV:CAL;SFV:NSPM;H:SATLEXMB04.amd.com;PTR:InfoDomainNonexistent;CAT:NONE;SFS:(13230022)(4636009)(39860400002)(136003)(396003)(376002)(346002)(451199015)(36840700001)(40470700004)(46966006)(478600001)(47076005)(316002)(5660300002)(40460700003)(8936002)(336012)(426003)(86362001)(1076003)(36860700001)(2906002)(2616005)(110136005)(36756003)(7696005)(82310400005)(54906003)(44832011)(81166007)(356005)(8676002)(26005)(70586007)(186003)(70206006)(82740400003)(41300700001)(4326008)(40480700001)(36900700001);DIR:OUT;SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Dec 2022 17:30:56.2034 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: cae996c6-2b5b-472b-7c01-08dad878cc5a X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=3dd8961f-e488-4e60-8e11-a82d994e183d;Ip=[165.204.84.17];Helo=[SATLEXMB04.amd.com] X-MS-Exchange-CrossTenant-AuthSource: BN8NAM11FT085.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA3PR12MB7903 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1751577768374527063?= X-GMAIL-MSGID: =?utf-8?q?1751577768374527063?= Change target `make htmldocs` to combine RST Sphinx and the generation of Rust documentation, when support is available. Reviewed-by: Akira Yokosawa Signed-off-by: Carlos Bilbao --- Documentation/Makefile | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/Documentation/Makefile b/Documentation/Makefile index 64d44c1ecad3..701ccb07e873 100644 --- a/Documentation/Makefile +++ b/Documentation/Makefile @@ -59,6 +59,10 @@ PAPEROPT_letter = -D latex_paper_size=letter KERNELDOC = $(srctree)/scripts/kernel-doc KERNELDOC_CONF = -D kerneldoc_srctree=$(srctree) -D kerneldoc_bin=$(KERNELDOC) ALLSPHINXOPTS = $(KERNELDOC_CONF) $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) +ifeq ($(CONFIG_RUST),y) +# Let Sphinx know we will include rustdoc +ALLSPHINXOPTS += -t rustdoc +endif # the i18n builder cannot share the environment and doctrees with the others I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . @@ -94,6 +98,10 @@ quiet_cmd_sphinx = SPHINX $@ --> file://$(abspath $(BUILDDIR)/$3/$4) htmldocs: @$(srctree)/scripts/sphinx-pre-install --version-check @+$(foreach var,$(SPHINXDIRS),$(call loop_cmd,sphinx,html,$(var),,$(var))) +# If Rust support is available, add rustdoc generated contents +ifeq ($(CONFIG_RUST),y) + $(Q)$(MAKE) rustdoc +endif linkcheckdocs: @$(foreach var,$(SPHINXDIRS),$(call loop_cmd,sphinx,linkcheck,$(var),,$(var)))