linux-kernel - [GIT PULL] Docs-build warning fixes for 5.10-rc3

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [thread-next>] [day] [month] [year] [list]

Message-ID: <20201103124420.46bf5a37@lwn.net>
Date:   Tue, 3 Nov 2020 12:44:20 -0700
From:   Jonathan Corbet <corbet@....net>
To:     Linus Torvalds <torvalds@...ux-foundation.org>
Cc:     LKML <linux-kernel@...r.kernel.org>, linux-doc@...r.kernel.org
Subject: [GIT PULL] Docs-build warning fixes for 5.10-rc3

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(-)