From: Jonathan Corbet <corbet@lwn.net>
To: Linus Torvalds <torvalds@linux-foundation.org>
Cc: LKML <linux-kernel@vger.kernel.org>, linux-doc@vger.kernel.org
Subject: [GIT PULL] Docs-build warning fixes for 5.10-rc3
Date: Tue, 3 Nov 2020 12:44:20 -0700 [thread overview]
Message-ID: <20201103124420.46bf5a37@lwn.net> (raw)
The following changes since commit
e051955977b7e26124aa8c8398278145f85f94e8:
documentation: arm: sunxi: add Allwinner H6 documents (2020-10-28 11:19:24 -0600)
are available in the Git repository at:
git://git.lwn.net/linux.git docs-5.10-warnings
for you to fetch changes up to 6fee9372e0af63f557ad234663d8248f3caefc37:
Merge branch 'mauro-warnings' into docs-next (2020-10-28 11:42:55 -0600)
----------------------------------------------------------------
This pull contains a series of warning fixes from Mauro; once applied, the
number of warnings from the once-noisy docs build process is nearly zero.
Getting to this point has required a lot of work; once there, hopefully we
can keep things that way.
I have packaged this as a separate pull because it does a fair amount of
reaching outside of Documentation/. The changes are all in comments and in
code placement. It's all been in linux-next since last week.
----------------------------------------------------------------
Jonathan Corbet (1):
Merge branch 'mauro-warnings' into docs-next
Mauro Carvalho Chehab (24):
scripts: kernel-doc: use :c:union when needed
sphinx: conf.py: properly handle Sphinx 4.0
docs: hwmon: adm1266.rst: fix a broken reference
docs: admin-guide: net.rst: add a missing blank line
docs: kasan.rst: add two missing blank lines
docs: net: statistics.rst: remove a duplicated kernel-doc
docs: hwmon: mp2975.rst: address some html build warnings
docs: userspace-api: add iommu.rst to the index file
blk-mq: docs: add kernel-doc description for a new struct member
mm: pagemap.h: fix two kernel-doc markups
net: phy: remove kernel-doc duplication
crypto: sun8x-ce*: update entries to its documentation
ice: docs fix a devlink info that broke a table
MAINTAINERS: fix broken doc refs due to yaml conversion
docs: lockdep-design: fix some warning issues
locking/refcount: move kernel-doc markups to the proper place
IB/srpt: docs: add a description for cq_size member
docs: fs: api-summary.rst: get rid of kernel-doc include
drm: amdgpu: kernel-doc: update some adev parameters
gpu: docs: amdgpu.rst: get rid of wrong kernel-doc markups
drm: amdgpu_dm: fix a typo
selftests: kselftest_harness.h: fix kernel-doc markups
amdgpu: fix a few kernel-doc markup issues
docs: SafeSetID: fix a warning
Documentation/admin-guide/LSM/SafeSetID.rst | 2 +-
Documentation/admin-guide/sysctl/net.rst | 1 +
Documentation/conf.py | 2 +-
Documentation/dev-tools/kasan.rst | 2 +
.../devicetree/bindings/clock/hi6220-clock.txt | 2 +-
Documentation/filesystems/api-summary.rst | 3 -
Documentation/gpu/amdgpu.rst | 7 --
Documentation/hwmon/adm1266.rst | 2 +-
Documentation/hwmon/index.rst | 1 +
Documentation/hwmon/mp2975.rst | 14 ++-
Documentation/locking/lockdep-design.rst | 51 ++++----
Documentation/networking/devlink/ice.rst | 1 +
Documentation/networking/statistics.rst | 3 +-
Documentation/userspace-api/index.rst | 1 +
MAINTAINERS | 9 +-
drivers/crypto/allwinner/sun8i-ce/sun8i-ce-hash.c | 2 +-
drivers/crypto/allwinner/sun8i-ce/sun8i-ce-prng.c | 2 +-
drivers/crypto/allwinner/sun8i-ce/sun8i-ce-trng.c | 2 +-
drivers/gpu/drm/amd/amdgpu/amdgpu_device.c | 36 +++---
drivers/gpu/drm/amd/amdgpu/amdgpu_gtt_mgr.c | 6 +-
drivers/gpu/drm/amd/amdgpu/amdgpu_vram_mgr.c | 7 +-
drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.c | 2 +-
drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h | 6 +-
drivers/infiniband/ulp/srpt/ib_srpt.h | 1 +
.../bindings/net/wireless/silabs,wfx.yaml | 2 +-
include/linux/blk-mq.h | 2 +
include/linux/pagemap.h | 8 +-
include/linux/phy.h | 40 +------
include/linux/refcount.h | 130 ++++++++++-----------
scripts/kernel-doc | 6 +-
tools/testing/selftests/kselftest_harness.h | 44 +++----
31 files changed, 196 insertions(+), 201 deletions(-)
next reply other threads:[~2020-11-03 19:44 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-11-03 19:44 Jonathan Corbet [this message]
2020-11-03 21:18 ` [GIT PULL] Docs-build warning fixes for 5.10-rc3 Linus Torvalds
2020-11-03 21:24 ` Matthew Wilcox
2020-11-04 22:06 ` Stephen Rothwell
2020-11-04 22:40 ` Jonathan Corbet
2020-11-03 21:51 ` pr-tracker-bot
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20201103124420.46bf5a37@lwn.net \
--to=corbet@lwn.net \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=torvalds@linux-foundation.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).