From patchwork Fri Jan 27 16:57:27 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Carlos Bilbao X-Patchwork-Id: 49510 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp938859wrn; Fri, 27 Jan 2023 09:03:33 -0800 (PST) X-Google-Smtp-Source: AMrXdXuk9XKHdWAdY+ar3vw2GzJ/fHikb+D/nk4EkcpohWnqyJukNBNXyHGBX8mRYDMbyDB4dK17 X-Received: by 2002:a05:6402:159:b0:49d:a87f:ba7b with SMTP id s25-20020a056402015900b0049da87fba7bmr40972577edu.39.1674839012882; Fri, 27 Jan 2023 09:03:32 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1674839012; cv=pass; d=google.com; s=arc-20160816; b=V6mPP17XvS+3fYFyv61aqAF7V5f/c5xtFZDQe8uitUAsvPoQY9yptlA4reAJeeImi+ c35yfRmWVFv89FRTlqfsGApEkgTWaDxDwJNCmzjTUbxHraUn/IKf9Cg1OkYR8+toe74u BeA1O/GHnfG+lDtxzAhgj304KtidW3IHjwY/sHeJmEjBLVRA/W5O7UirBCS4IIoYxiBA USM2ck49OKjzbFmXgVaa+TSHGespY3yOlneuZiypLMUkjB9Zv4iVb9hZzGz9UuYYefpd Bl7hr1f6lnXdrzr2N5jBJn9m6fGuN80ZQhhvoodKV+6PLrwmZOqyLEIkAhIkNj9adiGB zSdg== 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=eEvYD05+DILWPF29H57c5xi+s7dBsP1BYajS+dY1OuA=; b=MAVILtldcnzTfmNGi0+Uoi/zAAwBSbIAjZM5JO5EXkxLrF2ApfSJfwKcet7ozLZVh9 UCxGv5p7vom2xEtYuHTpnPt2fDEDMuRa+PEX7vGRtuM0bRbHhSWodLRjGhhvtu1+XgcF 1Q2dgdwebjGPbsPqYKHLOlVgNr/OJjG9+n7RcbbVywtqeYOv5RL1e2KDAL+b/4nrfH/V xPf75NMTBRj4G7s+i5goFLOk5SRGAYpxrW19y3ulyZSf24eT+HyP3XaUGHLh9G/KhLv1 PQC4R6fXH71b5s2aP2W3rgKN2BwGOo7/6FPYfhL2qxbcnlVz+uUvDD9aTMeRTmssDI+v UNdA== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@amd.com header.s=selector1 header.b=OvmmTzkr; 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 ge12-20020a170907908c00b008788321c852si4105299ejb.1001.2023.01.27.09.03.07; Fri, 27 Jan 2023 09:03:32 -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=OvmmTzkr; 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 S233983AbjA0Q5f (ORCPT + 99 others); Fri, 27 Jan 2023 11:57:35 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:52112 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232579AbjA0Q5d (ORCPT ); Fri, 27 Jan 2023 11:57:33 -0500 Received: from NAM11-DM6-obe.outbound.protection.outlook.com (mail-dm6nam11on2040.outbound.protection.outlook.com [40.107.223.40]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 6AF3D11F; Fri, 27 Jan 2023 08:57:32 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=lCVvWHJ4hPfG5ny/I+5cdXImcxMxXih8kz5nN1VBgS/CUAK1z4HAFOCiE6ooRfGZhR9Zye0giV/Uf1m5brSbZOQTivAHwYvAiWjJUymxvsApJt+4GPB+D1U8clV2z/T0WMrYKB579r0TKuEiyrrCRLPrycycCGX1s7V+Xjr/RUE4VTj5j4TLRhp0dLnmzRElkgPrReeWf4aqsriScnLWIJ5BW/nErRoUb1nmauqVHRb0/k90MPtvjATNvNWrNtdoTK0lgWRo/oEqW/cj2GgcE8RFeeyMh6wEaAKMlpU/bx4rk2pYbS6y5FdVhIfzRUAuxmMasqMGoTnEt9TjVWD9+Q== 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=eEvYD05+DILWPF29H57c5xi+s7dBsP1BYajS+dY1OuA=; b=P7qZzOCoBzJaLypnuWYdXbmIxEiMdCqvVFVaddkuId0w3SaYlzND7oVJ13vYsPzoSfdBNoGS1Qyt8NOjx69aZPX3VYAoye3ZSQ1lqnhwgOTEWfoAubvkZuCc8B/5/vC1WHbFly5MCXdv2hUoYVvdmkjNrQ5vx9XP96QUtx76hBlkpBgHxIp8lGEWm1iigppU+OuPsehUoa0adoh7UNcgzhln4njllpR9/V7LJyPziX09jQ0o87zPuMlq2CoznD9X49AKOwxYvh+lJkDaAB1/C47nIeDNoI0/CqstHZwqCtQSeTCT4qWdtVgcTR9YwYqkeMOqVc5BQLwHs76DopgUGw== 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=eEvYD05+DILWPF29H57c5xi+s7dBsP1BYajS+dY1OuA=; b=OvmmTzkrK2y5Pg9nmH1ApQgdscJZ2Zj8SPY5P8kaWStwpZCWuntAiJ/PYrJGmIK0qytqJxPCXWgDlBn9NSCeWSKI/yVdNe/xAkvLs+/wPy5KNqXfF05A3HaD8whK4kd98Vr+OGqLDeUHPAicegHusgw4RZnLlDXZG0x7lQfrB64= Received: from DM6PR08CA0053.namprd08.prod.outlook.com (2603:10b6:5:1e0::27) by SA1PR12MB6994.namprd12.prod.outlook.com (2603:10b6:806:24d::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6043.23; Fri, 27 Jan 2023 16:57:30 +0000 Received: from DM6NAM11FT066.eop-nam11.prod.protection.outlook.com (2603:10b6:5:1e0:cafe::c3) by DM6PR08CA0053.outlook.office365.com (2603:10b6:5:1e0::27) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6043.23 via Frontend Transport; Fri, 27 Jan 2023 16:57:30 +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 DM6NAM11FT066.mail.protection.outlook.com (10.13.173.179) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.6043.22 via Frontend Transport; Fri, 27 Jan 2023 16:57:30 +0000 Received: from SATLEXMB07.amd.com (10.181.41.45) 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; Fri, 27 Jan 2023 10:57:29 -0600 Received: from SATLEXMB04.amd.com (10.181.40.145) by SATLEXMB07.amd.com (10.181.41.45) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.34; Fri, 27 Jan 2023 08:57:29 -0800 Received: from iron-maiden.amd.com (10.180.168.240) by SATLEXMB04.amd.com (10.181.40.145) with Microsoft SMTP Server id 15.1.2375.34 via Frontend Transport; Fri, 27 Jan 2023 10:57:29 -0600 From: Carlos Bilbao To: , , , CC: , , , , Carlos Bilbao , Akira Yokosawa Subject: [PATCH v6 1/2] docs: Move rustdoc output, cross-reference it Date: Fri, 27 Jan 2023 10:57:27 -0600 Message-ID: <20230127165728.119507-2-carlos.bilbao@amd.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20230127165728.119507-1-carlos.bilbao@amd.com> References: <20230127165728.119507-1-carlos.bilbao@amd.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM6NAM11FT066:EE_|SA1PR12MB6994:EE_ X-MS-Office365-Filtering-Correlation-Id: e0bbe65f-0b59-44c4-e6fb-08db008793dc X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: ORQKbIp9Pcrp9TnPyJ6JW4TqSaaBBAuoLhUr1oaboKOqgR4TVhiH+aC5rN0KvGFHyke5LtbwJfhiEhx0+dI3V8/ShcEXt9sw1FaFa+plTsn64URf1y/a97gXYnYx0Xekyysy3dvUczdMGJdMYDn+16iImSQTqBp3S+i2c15/rj7T85NugBQcHByGR3/dF42JOldA9kh19QUUTqpxdv1/rcyU8WB+Ir9sT2yBFjT1xV4Km+q8911KBDpY+YVSdftE9QsNle9EWKnLg5T3KHSwrVSKyh+1LwoOaDaZJXPcO7p5h68W0rehGb5mTCLP2D4+f6BIkEamfCVQC77qp/FE6fIOy3r76M7p0jtZQ0D83kd9l4OMINf+gqMbQNViTAVprGrdEcdLEV63XaAWzkrtAc0FZxPo6CiNcLCBmLMVCI/gys+k3yFq6DaLZzdd8q+1qAIA3juLopC/98ygO+ffuSdS4pXLs0k+nEli8eA7nf5TzlEU6cu8ovX6BG5JMaVuH1uPU/ofAQyoTVgPIQUbOmF1fzOvvCw1tws7kn9jAX04tB/Ega8PM2iazOkVphsnBEmesf47hzqlAU2+t/4rDnfPLGToL2nVGKDkBFxoatI/aqCKh5d6SKJ7vXo3ETu9goxVDJba9XiMevEzK1+2Rtkud9xdkOulIwLZH2/LZabLNBGnL0UaaLiaTPeUe/+aCjgr5OL7U2bxQSmZ/6Xn+wSijzHJiCS9GBI6tslEKhc= 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:(13230025)(4636009)(39860400002)(376002)(396003)(346002)(136003)(451199018)(40470700004)(46966006)(36840700001)(356005)(44832011)(2906002)(5660300002)(81166007)(8936002)(41300700001)(86362001)(478600001)(40460700003)(83380400001)(36756003)(110136005)(36860700001)(54906003)(82740400003)(316002)(47076005)(426003)(336012)(2616005)(7696005)(40480700001)(8676002)(4326008)(70586007)(70206006)(82310400005)(1076003)(26005)(186003)(36900700001);DIR:OUT;SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 27 Jan 2023 16:57:30.3432 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: e0bbe65f-0b59-44c4-e6fb-08db008793dc 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: DM6NAM11FT066.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA1PR12MB6994 X-Spam-Status: No, score=-1.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FORGED_SPF_HELO, RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_NONE autolearn=no 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?1756195993072708858?= X-GMAIL-MSGID: =?utf-8?q?1756195993072708858?= 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..e599be2cec9b 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 and html + + You can also browse `rustdoc documentation `_. + +.. only:: not rustdoc and html + + This documentation does not include rustdoc generated information. + .. toctree:: :maxdepth: 1 diff --git a/rust/Makefile b/rust/Makefile index ff70c4c916f8..04f4ee3a193e 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 @@ -64,7 +67,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 $< @@ -81,15 +84,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 \ @@ -150,7 +153,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 Fri Jan 27 16:57:28 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Carlos Bilbao X-Patchwork-Id: 49511 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp939146wrn; Fri, 27 Jan 2023 09:03:55 -0800 (PST) X-Google-Smtp-Source: AMrXdXuEPxyDZa35rlcTOY+crWJIs+CpH9juvtvxRdmqH/uOcU3O3pbQrkVyzI9fXDGWNuTo4+sl X-Received: by 2002:a05:6402:28c5:b0:49e:cd82:cc73 with SMTP id ef5-20020a05640228c500b0049ecd82cc73mr27759439edb.29.1674839034876; Fri, 27 Jan 2023 09:03:54 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1674839034; cv=pass; d=google.com; s=arc-20160816; b=dau6hhDHNhe8GM0qlRVAi1s0O24AHI8sZsRuDlmiuvnrWMP1cGSplprYZpg45BU3XB a8QlCxiDzLDlMNRw0nKZ7+7TkITFkpk3GiOeMYRgKrs7u9KIBaFGrQUHWUJ/XOSFB081 7fArnaYam7c1Zr0vT4zpL/0UQyItCt2Di9wnFrn8gJG5jTb4pgSL3M/K1ZzYNaq34JHO X5om3jfkrYBL9XpNCKQ7FRqFWfLreV29NrsQfHJZUBKKG6E8liptNqMz9vKz0jncnV8u k8Z57yipMIAq2YO0KnGYxTxIC9HLMK+bmFrjWNffHoWUiHSCMNdNAtF8dS0nM3jKtErv EP2Q== 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=LQcDmVzPKVLhte1QLeCCDRNnHJBDJ9UkicLQqJ997Do=; b=jKaqR6GC++YS8sDpEak6l56Sn8+jWofSjs3IEuQIn+s6C3ZtA6M0xHycbq86/eD59e 5MtUhoGJaqTbzL5IG9uZFtfRFnoD18IkgqkUS1mSP+YpeQxtFfz6+XmqYv90neI11zkK +8JffAsVeNkcUhTlgbG+OExwvuZkjG6fB4w9XNLB6x6ToqAN8FQ+w+pyFZCDzEyx4aQP 22G614UaeY/VUoSxDvs4RYA1lib/R2eAXoqb4s2Ar+VhAhxaYf5MJzUKHcjpoCu9qA/4 G5B0eisJc+v/mkpRF28b7xux/Tr4yE9pmO+C113IrDmih3oGpTlIld1wOrWhDD4w9q+d jqIQ== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@amd.com header.s=selector1 header.b=hfaBR3Qh; 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 p1-20020a056402500100b0049f1ef400eesi6399510eda.120.2023.01.27.09.03.13; Fri, 27 Jan 2023 09:03:54 -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=hfaBR3Qh; 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 S234160AbjA0Q5m (ORCPT + 99 others); Fri, 27 Jan 2023 11:57:42 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:52114 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229489AbjA0Q5d (ORCPT ); Fri, 27 Jan 2023 11:57:33 -0500 Received: from NAM02-DM3-obe.outbound.protection.outlook.com (mail-dm3nam02on2084.outbound.protection.outlook.com [40.107.95.84]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id CBC782D5D; Fri, 27 Jan 2023 08:57:32 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=k3VzMBHwXqUEM3fdzUIdRwWYn67SgVnauQTlL1G/kA+L5Yo226HzvsfSXLiCcxg99siY/C0EM0tdLu+n7TtCmvg6gnkAptl3Ur64jjIUY7mvOYxeMOHt2R19CaLgCrL2nCzLAcnPSyupt4RvB1nvwNLa4o43eq8pC9Buyq/RlzI5o8oPgqjW3bZ/GCZ4gP8nAJmc89aZpTJOKrrlf39Pc7+BEsm68t8SNKOzWmounCkjfQ4bYN61Rh50jKErsHzYMr33PaMIm8q9GvYHDoQW+b9CYUlIBVmSQnIsRe5/1nc8t1kwISK1yLsCCanwnMVTA8HUWBAHmJhvOPBRP6Grfw== 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=LQcDmVzPKVLhte1QLeCCDRNnHJBDJ9UkicLQqJ997Do=; b=ctqB9sALHEKetf9j7Yo9qotogMpP/Bri/962p7eUgo6ks6G5l+TAFpX21W66wIP8ZDyjOpxu75eI/w93Y845RgT4eoSmFF4MMsCbBoGLmP89VMLgcod8uUJKBmysA6Aw5g34yoJy9nrjpSxhrd9g/bJlpNRN4AUIZB58sbfnoajQlWCUCC2RhtpL1qI2k/SGXGcAuXiixFvchKJsVQlRkbHNDHYHyZRFjmLZr95uBCN7jJRA7VCRnQZ3/9qlza4o/WCCkA1ilTwncHUbnRM6ObIQ4LXhycrcUowIX0NNsBdvPJI/n6i+FJooFCW3hy6e71UZorLcVSXZOjWLeHkiog== 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=LQcDmVzPKVLhte1QLeCCDRNnHJBDJ9UkicLQqJ997Do=; b=hfaBR3QhzqfFTxcW6l5p8hkdtzEc+CkhwRkfo8OyiFX+2HAxzRhSyHkf84Ikghl3ZZMI8mPhdVrMbmx+eNTf/chPuzQDaL+qislVyDKYKb0s/c5PpIcwN5oX1cxPldzXIw4Z4Ii5wnP5CJp5SNEsZ8eJ2koHcklZHxx7W+3tLms= Received: from CY5PR15CA0077.namprd15.prod.outlook.com (2603:10b6:930:18::33) by DS0PR12MB7947.namprd12.prod.outlook.com (2603:10b6:8:150::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6043.25; Fri, 27 Jan 2023 16:57:31 +0000 Received: from CY4PEPF0000B8EC.namprd05.prod.outlook.com (2603:10b6:930:18:cafe::3d) by CY5PR15CA0077.outlook.office365.com (2603:10b6:930:18::33) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6043.22 via Frontend Transport; Fri, 27 Jan 2023 16:57:31 +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 CY4PEPF0000B8EC.mail.protection.outlook.com (10.167.241.8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.6064.3 via Frontend Transport; Fri, 27 Jan 2023 16:57:31 +0000 Received: from SATLEXMB07.amd.com (10.181.41.45) 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; Fri, 27 Jan 2023 10:57:30 -0600 Received: from SATLEXMB04.amd.com (10.181.40.145) by SATLEXMB07.amd.com (10.181.41.45) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.34; Fri, 27 Jan 2023 08:57:30 -0800 Received: from iron-maiden.amd.com (10.180.168.240) by SATLEXMB04.amd.com (10.181.40.145) with Microsoft SMTP Server id 15.1.2375.34 via Frontend Transport; Fri, 27 Jan 2023 10:57:29 -0600 From: Carlos Bilbao To: , , , CC: , , , , Carlos Bilbao , Akira Yokosawa Subject: [PATCH v6 2/2] docs: Integrate rustdoc generation into htmldocs Date: Fri, 27 Jan 2023 10:57:28 -0600 Message-ID: <20230127165728.119507-3-carlos.bilbao@amd.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20230127165728.119507-1-carlos.bilbao@amd.com> References: <20230127165728.119507-1-carlos.bilbao@amd.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CY4PEPF0000B8EC:EE_|DS0PR12MB7947:EE_ X-MS-Office365-Filtering-Correlation-Id: 1d2d3bf9-d67e-47c9-8457-08db0087944a X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: HD7uExyS9xNMDZTAbW9yUq3GdJ2kxhKOZfIkYLp0K9muSosoMAgej0tzrMBjchmSpg3EqP3Zv646uBSDm5RARWLGVOYgaC2trD/HMpya4sLdUIbYmkenDvBLrsTVWSOanr0paPGJeXmQDcrdqxf/UUYAnTFHq8y2gDQVH/bUnrDjI7VR4s5immXZT4zyVNVZOKXINK7Uv6LBS/19dKUk8+J5B+V3NMo6R/0k6dWKGFEXyWCUmYXE0opV7EeaiblqOsgVT2+QdT4tVDi6ZX1jXu2jddO6dYTb4JvepocnjCfLh2mDHHWsHB3KZLBJCiXMd+SPlcaO21XwmlcOQhFGHVcuOP52OCruEB1fnkt/qSM0Kn11PusCgahykhWDYKN+DJa083k4bfsTD4q+sevs2Jg262EGiG56ddeiO72A5UqS29O6ImuUkgdPtgXm/JSJId8HWo4V8654jV0BVznX4fFo5vkoMNpqb2lZiiwKNsEHEd4d8/CU5Lj3a3T8qwEdppjTYIe9V8P0lgVLJsnV0jyvZrmbcFRVegq/DJ9HaIhSWuTBieRe7Nz+YomHFP7HW2MM3Qu8PLu/Zf8j2viHmnQUaMqwNMBQcaDFUp2Dcx9dvuSO0QbrOe/O7wu0r4XrwL8Ryw5YpxM1xeKsxuSL+W+xL5PZaPMcmuKJL6STleyaa38juGXqUwwZ9IvQCo9REZEii07tMjOEy+NZugYow3Hp1gl7eskieDV1Y3twUJo= 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:(13230025)(4636009)(136003)(39860400002)(346002)(376002)(396003)(451199018)(40470700004)(36840700001)(46966006)(86362001)(82310400005)(82740400003)(5660300002)(44832011)(2906002)(36756003)(356005)(41300700001)(81166007)(70586007)(4326008)(70206006)(40480700001)(8676002)(8936002)(316002)(110136005)(54906003)(2616005)(40460700003)(36860700001)(426003)(336012)(478600001)(47076005)(26005)(1076003)(186003)(7696005)(36900700001);DIR:OUT;SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 27 Jan 2023 16:57:31.0459 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 1d2d3bf9-d67e-47c9-8457-08db0087944a 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: CY4PEPF0000B8EC.namprd05.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DS0PR12MB7947 X-Spam-Status: No, score=-1.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FORGED_SPF_HELO, RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_NONE autolearn=no 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?1756196015731450892?= X-GMAIL-MSGID: =?utf-8?q?1756196015731450892?= 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 | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Documentation/Makefile b/Documentation/Makefile index bb73dcb5ed05..4111d0dd54d0 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,12 @@ 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. +# If there are any, the errors from this make rustdoc will be displayed but +# won't stop the execution of htmldocs +ifeq ($(CONFIG_RUST),y) + $(Q)$(MAKE) rustdoc || true +endif texinfodocs: @$(srctree)/scripts/sphinx-pre-install --version-check