From patchwork Sat Jul 9 10:07:13 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 12912133 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id F3062C433EF for ; Sat, 9 Jul 2022 10:07:55 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229781AbiGIKHx (ORCPT ); Sat, 9 Jul 2022 06:07:53 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:32840 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229723AbiGIKHo (ORCPT ); Sat, 9 Jul 2022 06:07:44 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 509CF4B4B8; Sat, 9 Jul 2022 03:07:41 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id E898E60E84; Sat, 9 Jul 2022 10:07:39 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 3EAE2C341C7; Sat, 9 Jul 2022 10:07:39 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1657361259; bh=KJtmXylkYfBUCP9nKw3ANSOdLovVVTpFPXktiDmYhX8=; h=From:To:Cc:Subject:Date:From; b=LnWbmh+eLrmzEUuOUtwt1Zk7RPhAHxviv/xN1zz17DDCm7ZZ2jcjIeAUW4KTxMXed KM6hlnyvwgcE/ucoKBLNi3lTI0HLQorkZBQKDriJ83QapG5TazYrBSO0s5jpBgI518 zjHSfekRlLlgNoH4pC8Bvx7SWcUhuyyANeCxHX9hJfkXhijte2QxQFmBhEqOt4NAki WRxJiBGp9FbjYtPunI+ANm5ybjHbUrO7XEI2HfTHJrTDCbiOpxKJM0muKF/npo2L8i 8btVRvA0c3zQa7eBwzLXG2Hotce3pbtGp96wKaC+VQwn/aYfgAwZb7CnJrfDBP08B6 LAxmYYMrturXw== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1oA7N9-004EGQ-BD; Sat, 09 Jul 2022 11:07:35 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jonathan Corbet , =?utf-8?q?C?= =?utf-8?q?hristian_K=C3=B6nig?= , "David S. Miller" , "H. Peter Anvin" , =?utf-8?q?Krzysztof_Wilczy=C5=84ski?= , "Theodore Ts'o" , Alex Shi , Alexander Potapenko , Alexander Viro , Andreas Dilger , Andrew Morton , Andrey Grodzovsky , Borislav Petkov , Daniel Vetter , Dave Hansen , David Airlie , Dmitry Vyukov , Eric Dumazet , Ingo Molnar , Jakub Kicinski , Leo Yan , Marc Kleine-Budde , Marco Elver , Mathieu Poirier , Max Staudt , Mike Kravetz , Mike Leach , Muchun Song , Paolo Abeni , Sumit Semwal , Suzuki K Poulose , Thomas Gleixner , Wolfgang Grandegger , Yanteng Si , coresight@lists.linaro.org, dri-devel@lists.freedesktop.org, kasan-dev@googlegroups.com, kvm@vger.kernel.org, linaro-mm-sig@lists.linaro.org, linux-arm-kernel@lists.infradead.org, linux-cachefs@redhat.com, linux-can@vger.kernel.org, linux-ext4@vger.kernel.org, linux-fsdevel@vger.kernel.org, linux-media@vger.kernel.org, linux-mm@kvack.org, linux-pci@vger.kernel.org, linux-sgx@vger.kernel.org, netdev@vger.kernel.org, x86@kernel.org Subject: [PATCH v3 00/21] Update Documentation/ cross references and fix issues Date: Sat, 9 Jul 2022 11:07:13 +0100 Message-Id: X-Mailer: git-send-email 2.36.1 MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org This series fix almost all fixable issues when building the html docs at linux-next (next-20220608): - Address some broken cross-references; - Fix kernel-doc warnings; - Fix bad tags on ReST files. With this series applied, plus other pending patches that should hopefully be merged in time for the next merge window, htmldocs build will produce just 4 warnings with Sphinx 2.4.4. Sphinx >=3 will produce some extra false-positive warnings due to conflicts between structs and functions sharing the same name. Hopefully this will be fixed either on a new Sphinx 5.x version or Sphinx 6.0. Mauro Carvalho Chehab (21): docs: networking: update netdevices.rst reference docs: update vmalloced-kernel-stacks.rst reference docs: update vmemmap_dedup.rst reference docs: zh_CN: page_migration: fix reference to mm index.rst dt-bindings: arm: update arm,coresight-cpu-debug.yaml reference x86/sgx: fix kernel-doc markups fscache: fix kernel-doc documentation fs: namei: address some kernel-doc issues drm/scheduler: fix a kernel-doc warning drm/scheduler: add a missing kernel-doc parameter kfence: fix a kernel-doc parameter genalloc: add a description for start_addr parameter textsearch: document list inside struct ts_ops dcache: fix a kernel-doc warning docs: ext4: blockmap.rst: fix a broken table docs: PCI: pci-vntb-function.rst: Properly include ascii artwork docs: PCI: pci-vntb-howto.rst: fix a title markup docs: virt: kvm: fix a title markup at api.rst docs: ABI: sysfs-bus-nvdimm docs: leds: index.rst: add leds-qcom-lpg to it Documentation: coresight: fix binding wildcards Documentation/ABI/testing/sysfs-bus-nvdimm | 2 ++ Documentation/PCI/endpoint/pci-vntb-function.rst | 2 +- Documentation/PCI/endpoint/pci-vntb-howto.rst | 2 +- Documentation/filesystems/ext4/blockmap.rst | 2 +- Documentation/leds/index.rst | 1 + Documentation/trace/coresight/coresight-cpu-debug.rst | 2 +- Documentation/trace/coresight/coresight.rst | 2 +- Documentation/translations/zh_CN/mm/page_migration.rst | 2 +- .../translations/zh_CN/mm/vmalloced-kernel-stacks.rst | 2 +- Documentation/virt/kvm/api.rst | 6 +++--- arch/x86/include/uapi/asm/sgx.h | 10 ++++++++-- drivers/gpu/drm/scheduler/sched_main.c | 1 + drivers/net/can/can327.c | 2 +- fs/namei.c | 3 +++ include/drm/gpu_scheduler.h | 1 + include/linux/dcache.h | 2 +- include/linux/fscache.h | 4 ++-- include/linux/genalloc.h | 1 + include/linux/kfence.h | 1 + include/linux/textsearch.h | 1 + mm/hugetlb_vmemmap.h | 2 +- 21 files changed, 34 insertions(+), 17 deletions(-)