Skip to content

Documentation build fixes against v5.10-rc1

Mauro Carvalho Chehab amd-gfx dri-devel linux-arm-kernel linux-block linux-clk linux-crypto linux-devicetree linux-doc linux-ext4 linux-hwmon linux-kselftest linux-rdma lkml netdev target-devel 2 versions – In review

Get series with b4
b4 am [email protected]

Versions newest first · linked by author and title

  1. v3 Latest32 patches 6 repliesIn review
  2. v12 patches 0 repliesSuperseded

Patches in v3 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/32scripts: kernel-doc: use :c:union when neededscripts/kernel-doc+5 -10 replies
2/32sphinx: conf.py: properly handle Sphinx 4.0Documentation/conf.py+1 -10 replies
3/32docs: hwmon: adm1266.rst: fix a broken referenceDocumentation/hwmon/adm1266.rst+1 -10 replies
4/32docs: admin-guide: net.rst: add a missing blank lineDocumentation/admin-guide/sysctl/net.rst+1 -00 replies
5/32docs: kasan.rst: add two missing blank linesDocumentation/dev-tools/kasan.rst+2 -00 replies
6/32docs: net: statistics.rst: remove a duplicated kernel-docDocumentation/networking/statistics.rst+1 -20 replies
7/32docs: hwmon: mp2975.rst: address some html build warningsDocumentation/hwmon/index.rst Documentation/hwmon/mp2975.rst+14 -10 replies
8/32docs: userspace-api: add iommu.rst to the index fileDocumentation/userspace-api/index.rst+1 -00 replies
9/32blk-mq: docs: add kernel-doc description for a new struct memberinclude/linux/blk-mq.h+2 -00 replies
10/32drm: kernel-doc: document drm_dp_set_subconnector_property() paramsdrivers/gpu/drm/drm_dp_helper.c+6 -10 replies
11/32drm/dp: fix kernel-doc warnings at drm_dp_helper.cdrivers/gpu/drm/drm_dp_helper.c+5 -00 replies
12/32drm/dp: fix a kernel-doc issue at drm_edid.cdrivers/gpu/drm/drm_edid.c+1 -10 replies
13/32mm: pagemap.h: fix two kernel-doc markupsinclude/linux/pagemap.h+4 -40 replies
14/32net: phy: remove kernel-doc duplicationinclude/linux/phy.h+5 -351 reply
15/32crypto: sun8x-ce*: update entries to its documentationdrivers/crypto/allwinner/sun8i-ce/sun8i-ce-hash.c drivers/crypto/allwinner/sun8i-ce/sun8i-ce-prng.c drivers/crypto/allwinner/sun8i-ce/sun8i-ce-trng.c+3 -30 replies
16/32ice: docs fix a devlink info that broke a tableDocumentation/networking/devlink/ice.rst+1 -00 replies
17/32MAINTAINERS: fix broken doc refs due to yaml conversionDocumentation/devicetree/bindings/clock/hi6220-clock.txt MAINTAINERS drivers/staging/wfx/Documentation/devicetree/bindings/net/wireless/silabs,wfx.yaml+6 -70 replies
18/32docs: lockdep-design: fix some warning issuesDocumentation/locking/lockdep-design.rst+31 -200 replies
19/32locking/refcount: move kernel-doc markups to the proper placeinclude/linux/refcount.h+79 -790 replies
20/32IB/srpt: docs: add a description for cq_size memberdrivers/infiniband/ulp/srpt/ib_srpt.h+1 -01 reply
21/32docs: fs: api-summary.rst: get rid of kernel-doc includeDocumentation/filesystems/api-summary.rst+0 -30 replies
22/32drm: amdgpu: kernel-doc: update some adev parametersdrivers/gpu/drm/amd/amdgpu/amdgpu_device.c drivers/gpu/drm/amd/amdgpu/amdgpu_gtt_mgr.c drivers/gpu/drm/amd/amdgpu/amdgpu_vram_mgr.c+20 -210 replies
23/32jbd2: fix a kernel-doc markupinclude/linux/jbd2.h+1 -11 reply
24/32drm: drm_edid: remove a duplicated kernel-doc declarationinclude/drm/drm_edid.h+0 -70 replies
25/32drm: kernel-doc: add description for a new function parameterdrivers/gpu/drm/drm_prime.c+1 -01 reply
26/32gpu: docs: amdgpu.rst: get rid of wrong kernel-doc markupsDocumentation/gpu/amdgpu.rst+0 -70 replies
27/32drm: kernel-doc: drm_dp_helper.h: fix a typoinclude/drm/drm_dp_helper.h+1 -10 replies
28/32drm: amdgpu_dm: fix a typodrivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.c drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h+4 -40 replies
29/32selftests: kselftest_harness.h: fix kernel-doc markupstools/testing/selftests/kselftest_harness.h+22 -220 replies
30/32amdgpu: fix a few kernel-doc markup issuesdrivers/gpu/drm/amd/amdgpu/amdgpu_device.c+5 -30 replies
31/32drm: drm_print.h: fix kernel-doc markupsinclude/drm/drm_print.h+17 -31 reply
32/32docs: SafeSetID: fix a warningDocumentation/admin-guide/LSM/SafeSetID.rst+1 -10 replies

Reviews trailers per patch

13 of 32 patches have a Reviewed-by or Acked-by.

PatchBrendan HigginsDavid S. MillerLyude PaulJacob KellerStephen BoydMatthew Wilcox (Oracle)Guenter RoeckJens AxboeJohn GarryAndrey KonovalovGerd HoffmannAndrew Lunn
1/32
2/32
3/32A-b
4/32
5/32R-b
6/32A-b
7/32A-b
8/32
9/32R-b R-b
10/32
11/32R-b
12/32R-b
13/32R-b
14/32R-b
15/32
16/32R-b
17/32A-b
18/32
19/32
20/32R-b T-b
21/32
22/32
23/32
24/32
25/32A-b
26/32
27/32
28/32
29/32
30/32
31/32
32/32

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes. Scroll the table sideways for all 12 reviewers.

Read the v3 thread

Cover letter [PATCH v3 00/32] Documentation build fixes against v5.10-rc1

Hi Jon,

This series contain the patches from a previous series I sent:

	[PATCH v2 00/24] Documentation build fixes against next-20201013

Plus other patches I sent later, against other versions of linux-next between 20201013 and v5.10-rc1.

It fixes most of the remaining documentation build warnings.

There were some changes from v2, as I changed some patches due to the feedback received, and added reviewed-by/acked-by to several of them.

After this series, there will be just 3 warnings at include/kunit/test.h, whose fixes were already applied by Shuah via her tree at linux-next. Hopefully, she will be sending it upstream anytime toon. So, I dropped the fix from my trees.

The vast majority of patches here are also on my linux-next tree, as my original plan were to send them upstream by the end of the merge window. I'll drop from it once they get merged.

As those patches are fixes, I guess it should be ok to get them merged for -rc2 or -rc3.

Regards,
Mauro

Mauro Carvalho Chehab (32):
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
drm: kernel-doc: document drm_dp_set_subconnector_property() params drm/dp: fix kernel-doc warnings at drm_dp_helper.c drm/dp: fix a kernel-doc issue at drm_edid.c
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
jbd2: fix a kernel-doc markup
drm: drm_edid: remove a duplicated kernel-doc declaration
drm: kernel-doc: add description for a new function parameter
gpu: docs: amdgpu.rst: get rid of wrong kernel-doc markups
drm: kernel-doc: drm_dp_helper.h: fix a typo
drm: amdgpu_dm: fix a typo
selftests: kselftest_harness.h: fix kernel-doc markups
amdgpu: fix a few kernel-doc markup issues
drm: drm_print.h: fix kernel-doc markups
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 +
 .../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 +-
 .../crypto/allwinner/sun8i-ce/sun8i-ce-hash.c |   2 +-
 .../crypto/allwinner/sun8i-ce/sun8i-ce-prng.c |   2 +-
 .../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 +-
 .../gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.c |   2 +-
 .../gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h |   6 +-
 drivers/gpu/drm/drm_dp_helper.c               |  12 +-
 drivers/gpu/drm/drm_edid.c                    |   2 +-
 drivers/gpu/drm/drm_prime.c                   |   1 +
 drivers/infiniband/ulp/srpt/ib_srpt.h         |   1 +
 .../bindings/net/wireless/silabs,wfx.yaml     |   2 +-
 include/drm/drm_dp_helper.h                   |   2 +-
 include/drm/drm_edid.h                        |   7 -
 include/drm/drm_print.h                       |  20 ++-
 include/linux/blk-mq.h                        |   2 +
 include/linux/jbd2.h                          |   2 +-
 include/linux/pagemap.h                       |   8 +-
 include/linux/phy.h                           |  40 +----
 include/linux/refcount.h                      | 158 +++++++++---------
 scripts/kernel-doc                            |   6 +-
 tools/testing/selftests/kselftest_harness.h   |  44 ++---
 38 files changed, 242 insertions(+), 229 deletions(-)
Signature · 1 line
2.26.2